search_memory
Find facts across multiple team communication channels by searching with keywords or natural phrases, returning ranked results even when the exact channel is unknown.
Instructions
Find facts ACROSS MANY channels by hybrid (BM25 + vector) search when you do NOT know which channel holds the answer. Call it first for broad recall, then drill into a specific channel with the tools below.
Routing rule for the three search tools:
search_memory(scope='all') — unknown channel; fans the search across every channel the principal can access and merges/ranks the hits.
search_channel_facts(channel_id) — known channel; same hybrid search, scoped to one channel, returning the richer per-fact shape.
search_memory(scope='channel:') — single channel with the search_memory hit shape (use search_channel_facts instead if you want author/permalink/topic_tags on each row). For a synthesized ANSWER rather than rows, use ask_channel.
Prerequisites: none for scope='all'; a channel_id (from list_channels) for scope='channel:'.
Returns (instant for one channel, longer when fanning across many;
read-only): {hits: [{fact_id, text, score, channel_id, cluster_id, entity_tags}, ...], query: <echo of query>} ranked by hybrid score.
No side effects.
Error modes (returned as dicts): 'authentication_missing' (no principal); 'invalid_parameter' (empty/over-4000-char query, or scope not 'all'/ 'channel:'); 'channel_access_denied' (only for an explicit 'channel:' the token cannot reach — under scope='all' unreachable channels are silently skipped).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query, keyword or natural phrase, 1-4000 chars (e.g. 'who owns billing'). Longer queries return error 'invalid_parameter'. Required. | |
| scope | No | Search scope. 'all' (default) = every channel the principal can access; 'channel:<id>' = one channel only (e.g. 'channel:ch-eng'). | all |
| limit | No | Max hits across the merged result set, 1-50 (out-of-range values are clamped). Default 20. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||