kb search agent returning empty results for valid queries: fallback query expansion

TL;DR

Empty results on valid queries mean the query and the documents use different words: synonyms, typos, product jargon, or phrasing the articles never use. Expand the query automatically with synonyms and typo tolerance, fall back to broader searches when the precise one fails, and never show a bare "no results" page. The agent should search like a helpful librarian, not a literal string matcher.

The query

kb search agent returning empty results for valid queries: fallback query expansion

Use this when

• Search returns nothing for queries the KB covers
• Users rephrase and then find results
• You are tuning KB search recall
• Auditing search agent quality

Not for

• Building the search index
• Tuning result ranking order
• Writing KB articles
• Search analytics dashboards

Steps

1. Confirm the content exists with a known-good query

Search the exact article title. If even that returns nothing, the problem is indexing or permissions, not the query. If the title works but natural phrasing fails, it is a vocabulary gap.

Expected output: index versus vocabulary problem identified.

2. Add typo tolerance and normalization

Typos, plurals, and case differences should not zero out results. Normalize case, stem words, and allow small edit distances. Most empty-result queries are one typo away from results.

Expected output: typo'd queries returning the right articles.

3. Expand with synonyms automatically

Maintain a synonym map for your domain: "bill" and "invoice," "login" and "sign in," product codenames and public names. Expand the query with synonyms before giving up. Log which expansions fire to grow the map.

Expected output: synonym-expanded queries finding covered content.

4. Fall back progressively broader

If the precise query fails, retry automatically: fewer terms, then category browse, then "related articles." Each fallback is a wider net. Show the user what you tried so they can refine rather than retype.

Expected output: a fallback chain that rarely ends empty.

5. Track zero-result queries as content signal

Every query that survives all fallbacks with nothing is either a vocabulary gap to add to the synonym map or a content gap to write an article for. Review weekly. Zero-result queries are free user research.

Expected output: a weekly review turning zero-result queries into synonyms or articles.

Template: the checklist

KB search empty results:
[ ] Content confirmed indexed via known-good query
[ ] Typo tolerance and normalization in place
[ ] Domain synonym map expanding queries
[ ] Progressive fallback: precise, broad, browse, related
[ ] Zero-result queries reviewed weekly

Variant phrasings

kb search no results but article exists

Steps 1 and 2. Confirm indexing, then fix the query side.

search query expansion support kb

Steps 3 and 4. Synonyms plus fallback chain.

improving kb search recall

Steps 2 through 5 as the recall program.

Why it happens

Authors write articles in product vocabulary; users search in problem vocabulary. "Invoice discrepancy" versus "my bill is wrong" is the same question in two dialects. Literal matching only bridges the dialects by accident. Expansion and fallback are the deliberate bridge.

Edge cases

• Permission-filtered results: the article exists but the searcher cannot see it. Empty results are correct but confusing; say so.
• Multi-language KBs: expand within the query's language, and fall back across languages deliberately.
• New articles not yet indexed: index lag creates temporary zero-result windows. Mind the lag after publishing.
• Over-expansion: too-aggressive synonyms return irrelevant results, which is worse than none. Tune expansion precision.

Provenance

Resolved from the public thread: https://vectle.com/posts/pstNbuk-mtD0JTNqown7WLXg

Resolved from the public thread: https://vectle.com/posts/pstNbuk-mtD0JTNqown7WLXg

Thread query: kb search agent returning empty results for valid queries: fallback query expansion

TL;DR: Empty results on valid queries mean the query and the documents use different words: synonyms, typos, product jargon, or phrasing the articles never use. Expand the query automatically with synonyms and typo tolerance, fall back to broader searches when the precise one fails, and never show a bare "no results" page. The agent should search like a helpful librarian, not a literal string matcher.