search_tools_respond
Answers clarification questions returned by search_tools to complete a search. Runs stages 2–4 of the pipeline (contextual filters → graph reranking → final selection) using the provided answers as additional context.
When to use
Call search_tools_respond only after search_tools has returned a response with "type": "clarification". This tool is never called on its own — it always follows a prior search.
Prerequisite
search_tools returns a clarification response. Calling it without a valid query_id from a prior search will return a 404 error.Input schema
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
query_id | string | Required | — | The unique query identifier returned in the clarification response from search_tools. |
answers | Record<string, string> | Required | — | Key-value map answering the clarification questions. Keys must match the "key" field from each question. |
query_idRequiredstringThe unique query identifier returned in the clarification response from search_tools.
answersRequiredRecord<string, string>Key-value map answering the clarification questions. Keys must match the "key" field from each question.
Examples
Answering clarification questions
Response format
This tool always returns a result response — no further clarification is requested. The response structure is identical to the result format from search_tools.
{
"type": "result",
"recommendation": {
"name": "Pinecone",
"description": "Managed vector database for ML embeddings at scale",
"category": "database",
"language": "Python",
"license": "proprietary",
"health_tier": "healthy",
"confidence": 0.91,
"reasons": [
"Cloud-native managed service — no infrastructure to manage",
"First-class Python SDK with async support",
"Optimized for high-dimensional embedding vectors"
]
},
"alternatives": [
{
"name": "Weaviate",
"confidence": 0.85,
"description": "Open-source vector database with built-in vectorization"
},
{
"name": "Qdrant",
"confidence": 0.82,
"description": "High-performance vector similarity search engine"
}
]
}No further clarification
search_tools, this tool never returns a clarification response. It always produces final results, even if some answer keys are missing.Error codes
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
400 | Bad Request | Optional | — | Invalid query_id or malformed answers object. Ensure the query_id matches a prior clarification response. |
404 | Not Found | Optional | — | The query_id has expired or does not exist. Start a new search with search_tools. |
500 | Internal Error | Optional | — | Pipeline processing error. An unexpected failure occurred while completing the search. |
400OptionalBad RequestInvalid query_id or malformed answers object. Ensure the query_id matches a prior clarification response.
404OptionalNot FoundThe query_id has expired or does not exist. Start a new search with search_tools.
500OptionalInternal ErrorPipeline processing error. An unexpected failure occurred while completing the search.
Related tools
search_tools— Start a new tool search (prerequisite for this tool)report_outcome— Report usage feedback after using a recommended tool