deep_search
Runs a search, reads multiple top pages, and returns ranked verbatim passages, providing the evidence you need for multi-page questions in one call.
Instructions
Search the web across several pages to answer a question in ONE call: it runs a search, fetches several of the top result pages, ranks passages across all of them, and returns the few verbatim slices most relevant to your question. Use this for a question that needs reading and comparing MULTIPLE pages ("which databases use X and how do they differ", "what do reviewers say about Y") instead of running web_search and then many fetch calls yourself - it does that multi-page reading for you and hands back only what fits your context window. Do NOT use it for a quick fact a single search snippet already answers (use web_search), or to read ONE page whose URL you already have (use fetch). Returns passages (verbatim, ranked, each with its source url) - it returns EVIDENCE, not a written answer: YOU read the passages and compose the answer, and YOU decide whether they actually answer your question (grounder does not judge that - it depends on what you are really asking). If the passages do not contain the answer, say so rather than guessing. If you would rather be handed prose than read the evidence yourself, set include_answer: true and the reply ALSO carries answer - a short answer written from those same passages. The passages still come back either way, so you can check the answer against its own evidence, and the field is omitted rather than guessed at when the passages do not support one. It costs no extra pages. The pack is capped to fit your context window (max_tokens, default 600) so it won't overflow a small local model. Slower than a single fetch (it reads several pages). Costs 1 page per page read (default up to 6).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| max_tokens | No | ||
| max_fetches | No | ||
| include_answer | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||