query_documents
Hybrid search: semantic similarity plus a keyword boost for exact terms.
Instructions
Hybrid search: semantic similarity plus a keyword boost for exact terms.
Returns results — ranked chunks with text, source, title,
chunkIndex, score and parentId — sources, the distinct
sources in rank order each with a hits count and a
displayPath to show the user (source stays absolute and is
what the other tools take), and parents, a map from parentId
to section text. Use sources to answer "which documents
cover this topic" without inspecting individual chunks.
text is the passage that matched and that score describes.
parentId names the section it sits in — a transcript time
window, a heading section, a slide, a table. Look it up in
parents to read the whole section when the match alone is too
small to act on. A chunk indexed before parent sections existed
has parentId null and no entry; re-sync to fill it in.
topK must be at least 1 and is capped at 100; a larger value is silently clamped to the cap rather than rejected.
When nothing matches because nothing could — an empty index, or a
scope no indexed document is under — notice says which.
Cite what you take, so the user can verify it, in whatever
language you answer: end with a Sources list, one line per
document you actually used, each line just that document's
displayPath copied verbatim — no [n] markers, nothing else
on the line. Plain text, never a markdown link or file://.
labels ({facet: value or [values]}) and dateFrom/dateTo
(YYYY-MM-DD, inclusive) narrow the search to labelled documents when
the corpus has a classify.toml; status lists its facets and values
under labels — map an approximate name to a value from there.
filterCounts then says how many documents in scope were left out
only for having no label or no date; each sources row carries its
labels and date.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topK | No | ||
| query | Yes | ||
| scope | No | ||
| dateTo | No | ||
| labels | No | ||
| dateFrom | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||