PageIndex

Primary document retrieval tool. After orienting with `get_folder_structure()` (when available) — and, for queries that may involve typed attributes, pairing it with `get_metadata_schema()` so you kno…

Check a document's processing status and metadata. Call this before `get_document_structure()` or `get_page_content()` to confirm the document is ready (`status === "completed"`).

Retrieve an image from a document — pass an `image_path` from a `get_page_content()` response: either an embedded image (from a content block) or a full rendered page (from the `page_images` array, us…

Extract a document's hierarchical outline (headers, sections, page references). REQUIRED for documents over 20 pages — call this first to locate relevant sections, then pass their page numbers to `get…

Orientation step: show the folder hierarchy as a tree (like `tree -d`). **Call this before browse_documents()** to plan targeted retrieval — folder names reveal content domains (e.g. "Research", "Fina…

List declared metadata fields (names, types, descriptions) so you can build `metadata_filter` / `sort` / `aggregates` / `group_by` for `search_documents(mode="metadata")`, or a `metadata_filter` that …

Extract page content from a processed document. Use tight, targeted page ranges — never the whole document at once. For documents over 20 pages, call `get_document_structure()` first to pick relevant …

Upload and process a PDF from a public URL (≤100MB). Only invoke with a valid URL the user has provided — never guess one. After processing, call `get_document()` to confirm status before reading cont…

Permanently delete documents and all associated data. Only invoke when the user explicitly names the documents AND confirms deletion. Returns `results` — one entry per requested document: `{ doc_name,…

Escalation tool — never the first discovery step. Always start with `browse_documents()` (after `get_folder_structure()` when visible). Pick a mode: • mode="query" — keyword precision when browse miss…