Overview
AI Search can call a language model at two points in the search pipeline:- LLM query rewrite — before search, an LLM rewrites your query into forms that work better for BM25 and embedding retrieval.
- LLM reranker — after search, an LLM reads the top candidate results and re-orders them by how well they actually answer your query.
LLM query rewrite
What it does
Your original query is passed to an LLM that produces:- A BM25-friendly version (closer to how documents are written)
- An embedding-friendly version for semantic search
When it runs
Rewrite runs only when Auto weights is enabled. With manual weights you have committed to a specific BM25/semantic mix, so rewriting is disabled to keep results deterministic.Settings
During a search, the progress indicator shows Rewriting query… while this runs. After results arrive, a badge on the results header indicates whether rewrite was actually applied:
- On: “The search query was rewritten for BM25 and embedding.”
- Off: “LLM query rewrite was not applied.”
When to turn it off
- You need lowest-possible latency for a keyword lookup.
- You are debugging why a particular result did or did not match and want deterministic text matching.
LLM reranker
What it does
After the hybrid BM25 + vector search produces the top candidate documents, the LLM reranker reads each candidate and scores how well it actually answers your query. Results are then re-ordered by this score. The reranker also produces a short reasoning text for each result explaining why it was ranked where it was.Outputs
Settings
During a search, the progress indicator shows The AI is reading the results and ranking them by relevance… After results arrive, a badge indicates whether rerank was applied:
- On: “LLM rerank was applied to these results.”
- Off: “LLM rerank was not applied (disabled in settings or unavailable on the server).”
Interaction with the relevance score
When LLM rerank is on, the score you see is the LLM’s 0–100 relevance score. When it is off, the score falls back to the Reciprocal Rank Fusion (RRF) score from the hybrid retrieval stage. The two are not directly comparable — a 70 with reranker and a 70 without reranker are measured differently.When to turn it off
- You need fastest-possible results and can trade some result quality.
- You want to inspect the raw hybrid retrieval ordering.
- Your query is an exact code/ID lookup where reranking adds little value.
Seeing what was applied
Every AI search response reports which LLM stages actually ran. The badges above the result table reflect the actual behavior, not just the toggle state — a server-side issue can cause a stage to be skipped even when you have it turned on.Latency considerations
Both features add round-trips to the LLM service:
If search feels slow, try:
- Turning off LLM rerank first (biggest win).
- Lowering Max results.
- Turning off LLM rewrite if you also don’t need it.
Frequently asked questions
Why is my toggle greyed out?
Why is my toggle greyed out?
The LLM rewrite toggle is disabled whenever Auto weights is off. Turn Auto weights back on to re-enable it. If a toggle is hidden entirely rather than greyed out, the feature is disabled server-side.
Why does the results badge say rerank was not applied even though I have it on?
Why does the results badge say rerank was not applied even though I have it on?
The LLM service may be temporarily unavailable, rate-limited, or disabled for your tenant. The response still includes results — they are ordered by the RRF fallback score.
Can I see what the rewrite did to my query?
Can I see what the rewrite did to my query?
Not directly in the UI today. The rewrite happens server-side and the rewritten query is not surfaced back. If results differ significantly from what you expected, try turning LLM rewrite off to see the base retrieval behavior.
Does the reasoning column count towards the score?
Does the reasoning column count towards the score?
No. The reasoning is a natural-language explanation of the score, not an input to it. It is there for transparency and debugging.
