reindex_documents
Indexes or reindexes knowledge base documents in the background, supporting incremental updates, smart re-embedding, full rebuilds, and resume of interrupted runs.
Instructions
Index or reindex all documents in the knowledge base (runs in background).
No flags — incremental pass: index new or changed files, skip unchanged
ones, prune deleted sources. Use after filesystem edits outside
add_document/update_document.
force — smart reindex: re-embed every file, unchanged ones included,
and rebuild BM25. Slow on a large corpus; use after changing the
query/passage prefixes or chunking settings.
full_rebuild — nuclear rebuild (delete + re-embed). Use only after
embedding-model change or index corruption. Mutually exclusive with resume.
resume — pick up an interrupted smart reindex from
data/reindex_checkpoint.json. Falls back to a fresh smart run silently
if the checkpoint is missing/corrupt/drifted (v4.8.0 Fase 4).
Returns a JSON envelope. Poll get_reindex_status() until
reindex.active becomes false. Add/update/URL tools already auto-index —
use these flags only for the recovery/rebuild scenarios above.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "reindex_documents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | ||
| resume | No | ||
| full_rebuild | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |