semantic_search
Search past tool responses and card templates by semantic similarity, history, or analytics. Retrieve previous results and usage stats from the vector store.
Instructions
Search the Qdrant vector store of this server's past tool responses and card templates.
Use when: looking up previous results, usage history, or analytics ('service:gmail last week', 'tool:search recent', 'overview'). For discovering tools to call, use search; to preview one stored document, pass its point ID to fetch_document.
Modes: semantic text similarity; service/tool history queries; analytics ('overview', 'usage stats'); filter_dsl for structured filters; positive/negative point IDs for recommendation; query_dsl for fusion/discover/order-by; prefetch_dsl for multi-stage retrieval.
Behavior: read-only against the local Qdrant instance; no Google APIs are called. Returns: scored rows 'score service/tool timestamp id:'. Errors: 'Search failed' when Qdrant is unreachable; 'No results' when nothing clears score_threshold (default 0.3 — lower it to widen the net).
DSL filter symbols: D_5=DatetimeRange, ʄ=FieldCondition, ƒ=Filter, F_6=FilterSelector, ℏ=HasIdCondition, I_2=IsEmptyCondition, I_0=IsNullCondition, ɱ=MatchAny, ṁ=MatchText, M_0=MatchTextAny, ☆=MatchValue, ř=Range Query-DSL symbols: Å=AcornSearchParams, C_14=ContextExamplePair, ¢=ContextPair, C_0=ContextQuery, D_6=DiscoverInput, D_2=DiscoverQuery, D_4=DiscoverRequest, D_21=DiscoverRequestBatch, ℱ=Fusion, φ=FusionQuery, ø=OrderBy, ɵ=OrderByQuery, ¶=Prefetch, ʔ=QuantizationSearchParams, R_12=RecommendGroupsRequest, R_2=RecommendInput, R_4=RecommendQuery, R_5=RecommendRequest, R_18=RecommendRequestBatch, R_10=RecommendStrategy, ♦=SearchParams Example: ƒ{must=[ʄ{key="tool_name", match=☆{value="send_dynamic_card"}}]} MatchAny: ƒ{must=[ʄ{key="tool_name", match=ɱ{any=["tool_a", "tool_b"]}}]}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum results to return | |
| query | Yes | Search query — natural language, 'service:gmail recent', 'overview', 'id:<point_id>', or semantic text when filter_dsl is set | |
| dry_run | No | If true with filter_dsl, parse and validate DSL without executing the query | |
| query_dsl | No | Query DSL for recommend, discover, fusion, or order-by queries | |
| collection | No | Qdrant collection to search. Default: mcp_tool_responses | |
| filter_dsl | No | Qdrant DSL filter notation for precise filtering (see docstring for symbols) | |
| prefetch_dsl | No | Multi-stage prefetch DSL for hierarchical search strategies | |
| score_threshold | No | Minimum similarity score (0.0-1.0) | |
| user_google_email | No | User's Google email (auto-injected by middleware) | |
| negative_point_ids | No | Point IDs to use as negative examples for recommendation search | |
| positive_point_ids | No | Point IDs to use as positive examples for recommendation search |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |