search
Search everything the token may read: code, message threads, meetings
and documents. Ranks chunks by meaning and by words (mode hybrid, the
default; dense: meaning only; lexical: words only). Filters: workspaces,
sources, repositories, kinds (code_file, thread, meeting, document,
decision, open_question), since and until (ISO 8601), persons (records
that name them: 'me', a person id, or an alias such as a mail address, a
chat user id or a display name; merged persons count as one) and roles
(with persons: author, recipient, mention, participant). Active journal
items matching statement words or citing retrieved records are in
decisions. Use get_decision for their full history. Each hit carries its
source kind, workspace and source, locator (repo@sha:path#Lstart-Lend
for code; source:external_id#anchor otherwise), occurred_at (the
record's time, which since and until filter on), and the chunk's text as
snippet. A hit of a thread, a meeting or a document also carries anchor,
its place in the record (msg-
Token scope: read.
| Argument | Required | Description |
|---|---|---|
query |
yes | A question or keywords, in any language. |
limit |
no | The most results, 1 to 100. |
workspaces |
no | Only these workspaces, by name; default: every workspace the token may read. |
sources |
no | Only these sources, by name. |
repositories |
no | Only these repositories (git sources), by name. |
kinds |
no | Filter record and journal results by kind. |
since |
no | Only records that occurred at or after this time (ISO 8601 with a zone). |
until |
no | Only records that occurred before this time (ISO 8601). |
persons |
no | Only records that name one of these persons: 'me' (the person marked as the caller), a person id, or an alias as the sources show it (a mail address, a chat user id, a display name). A person stands for everyone merged into it. A name that matches no one gives no hits. |
roles |
no | With persons: only records where the person is one of these: author (wrote a message), recipient (a message was sent to them, to or cc), mention (a message or an action item names them), participant (took part in a meeting). Default: any. |
mode |
no | hybrid: by meaning and by words, fused (the default); dense: by meaning only; lexical: by words only. |
Example
Send these parameters to tools/call.
{
"name": "search",
"arguments": {
"query": "harbour fees",
"limit": 5
}
}