AI-powered search: how to make in-product search actually find things

Search is the feature users blame themselves for failing at, then quietly stop using. Semantic search fixes the most common failure, but only if you keep the things keyword search was already good at.

By Quality AboveAll · · 8 min read

Person analysing search results on a laptop
Key takeaways
  • Hybrid search, keyword plus semantic with re-ranking, consistently beats either approach alone.
  • Semantic search alone regresses on exact identifiers like SKUs and error codes, which is how upgrades get rolled back.
  • Build a relevance test set from real queries before changing anything, or you cannot tell improvement from noise.

Why the current search disappoints

Traditional search matches tokens, so it fails whenever the user's words differ from the document's words. People search for what they want to accomplish while documentation is written in the vocabulary of the system, and that mismatch produces most empty result pages.

It also handles natural-language questions poorly. Users increasingly type full questions because that is how they interact with everything else now, and a keyword index treats that as a bag of mostly unhelpful terms.

What semantic search adds, and what it breaks

Semantic search compares meaning using embeddings, so a question finds the passage that answers it regardless of shared vocabulary. For help content, product documentation and any corpus people query conversationally, the improvement is immediate and obvious.

It also reliably breaks exact matching. A user searching a specific order number, part code or error string wants that literal string, and a semantic index will return things that merely feel related. Teams that replace rather than augment discover this within a day of launch.

The fastest way to make search worse is to replace keyword matching instead of adding to it.

Hybrid retrieval and re-ranking

Run both retrievers, merge the candidates, and re-rank the combined set. Keyword search anchors precision on literal terms while semantic search supplies recall on paraphrases, and a re-ranking pass over the merged list decides the final order using more context than either scorer had alone.

Re-ranking is the step teams skip and the one that produces the most visible quality gain, because first-stage retrieval only needs to get the right document into a candidate set of a few dozen, not into the top slot.

Filters, permissions and freshness

Relevance is necessary but insufficient. Results must respect who is asking, so permission filtering has to happen inside retrieval rather than as a post-filter that empties the result page. Facets like category, date and status need to compose with semantic ranking rather than fight it.

Freshness deserves explicit handling too. Where content is superseded, ranking should prefer current versions, and archived material should be either excluded or clearly labelled. Users blame search, not your content lifecycle, when an obsolete policy comes first.

Measure relevance before and after

Take a few hundred real queries from your logs, particularly ones that currently return nothing or get abandoned, and record which result should be first. That set is what turns a search project from taste into engineering.

Then track click-through position, abandonment and zero-result rate in production. A search change that improves offline relevance but increases abandonment is telling you the test set was unrepresentative, which is worth knowing before it becomes a rollback. The retrieval measurement approach in LLM evaluation applies directly.

Frequently asked questions

Do I need to replace my existing search engine?

Usually not. Most mature search engines now support vector fields alongside keyword indexes, so hybrid search is often a configuration and ranking project rather than a migration.

How much content do I need for semantic search to help?

It helps from a few hundred documents upward. Below that, the bottleneck is usually content coverage rather than retrieval technique.

Will this let users ask questions and get answers?

That is the next step: search returns passages, and a generation layer on top turns them into an answer. Get retrieval right first, because a generated answer over bad retrieval is worse than a list of bad results.

Search quietly failing your users? A free 30-minute review will show you what your query logs are already telling you.

Search that finds iton the first try.

Hybrid retrieval, re-ranking and permission-aware filtering, measured against your own query logs rather than a vendor benchmark.