deep_search
Try multiple query variants in priority order until one returns strong results. Use when a single search fails or a more thorough search is needed.
Instructions
Multi-query fallback search. ESCALATION TOOL — use only when search returned weak or empty results, or when the user explicitly asks for a more thorough search. Slower than search because it runs multiple retrievals. How it works: tries each query variant in order; stops at the first whose results pass the weakness threshold. If all fail, returns the strongest weak set with a warning. Omit source to run across ALL sources (RRF-fused); pass source to target one. Configured sources: . Best practices: provide 2-4 GENUINELY DIFFERENT phrasings (different angles, not paraphrases). Good: ['player health system', 'damage and healing logic', 'HP component lifecycle']. Bad: ['player health', 'health of the player'] (too similar). Args: queries (ordered list of variants); source (optional name); top_k; mode ('dense'|'sparse'|'hybrid', single-source only); file_glob, extensions, path_contains; min_score, min_results (threshold overrides); return_all_variants (per-variant diagnostics, single-source only).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Retrieval mode override (single-source only): 'dense', 'sparse', or 'hybrid'. Defaults to the server's configured mode. | |
| top_k | No | Maximum number of results to return. Defaults to the configured value. | |
| source | No | Source name from `list_sources`. Omit to use the default: all sources for `search`/`deep_search` (RRF-fused), or the single applicable source for the others. | |
| queries | Yes | 2-4 genuinely different phrasings of the same need (different angles, not paraphrases), tried in priority order. | |
| file_glob | No | fnmatch glob to restrict results by path/filename, e.g. `*.cs` or `**/Editor/*`. | |
| min_score | No | Override the weakness threshold: a variant's results must beat this score to count as strong. | |
| extensions | No | Restrict results to these file extensions, e.g. `['.cs', '.shader']`. | |
| min_results | No | Override the minimum number of results a variant must return to be considered strong. | |
| path_contains | No | Keep only results whose file path contains this substring. | |
| return_all_variants | No | If true, include per-variant diagnostics in the response (single-source only). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |