smart_query
Analyzes natural-language questions to extract schema, match examples, assess complexity, and request clarification before SQL execution.
Instructions
BIRD SQL-based intelligent query tool. Analyzes natural-language questions to (1) extract relevant schema, (2) match similar few-shot examples, (3) assess complexity, (4) request clarification for ambiguous questions. Call this tool before run_query. For a new data source, first inspect the schema with list_tables, then register keyword-to-table mappings via manage_keyword_map to significantly improve accuracy. Note: when ANTHROPIC_API_KEY is set, table names, column names, and the question text (never query results or row data) may be sent to the Anthropic API as a fallback for table selection.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"data_source_id": "<data_source_id>",
"question": "<question>"
},
"name": "smart_query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| context | No | User's answer to a previous clarification question (for multi-turn) | |
| question | Yes | Natural-language question (e.g., 'How many payments were completed last month?') | |
| data_source_id | Yes | Data source ID (from list_data_sources) |