search_documents
Find specific documents by keyword when a standard browse search misses them. Use precise terms, acronyms, or file-name fragments; results include relevance scores.
Instructions
ESCALATION tool — never the first step. Use only after browse_documents(sort="relevance", query=...) missed a document you strongly believe exists by precise term, acronym, or file-name fragment. Query must be keywords only — see the query schema describe. Each result has a score (6-10, higher is more relevant). On result: single best match → read it; several equally good → ask user; none → fall back to browse_documents(sort="relevance").
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Number of documents to return (1-50, default 10) | |
| query | Yes | Keyword query. Pass keyword(s) only — NOT a natural-language sentence. Multiple keywords are AND-matched: every token must appear in the file name or description. Examples: "machine learning safety" ✓; "documents about machine learning safety" ✗ (stop words "documents"/"about" will block matches). | |
| folder_id | No | Folder scope (default "root"). Pass a specific folder ID to scope into that folder, or "root" to reference the library root. Combine with `recursive` to control breadth. Mirrors browse_documents — copy any folder_id from a browse/tree response verbatim, never construct one. The default root search ALREADY covers the read-only "shared-with-me" and "following" folders; pass one of those ids (or one of their sub-folder ids) only to narrow the search to shared content. | |
| recursive | No | Whether to include documents from descendant folders. When true (default), searches the entire subtree of folder_id — for "root" that means the whole library, including the read-only "shared-with-me" and "following" folders. Set false to restrict to the direct contents of folder_id: root-level documents for "root", directly-shared documents for the read-only folders. |