smartSearch
Converts a natural-language question into a read-only SQL query over the project schema, runs it, and returns results with the SQL, a short title, and warnings.
Instructions
Convert a natural-language question into one read-only SQL statement over the project schema, run it, and return the results plus the statement, a short title for it and any warnings. Rows that select a record come back as records; aggregates such as counts and totals come back as plain rows. Use this for user-facing questions such as "Who are piloting Falcon?" or "How many orders per city?". For direct vector similarity over an embedding index, use vectorSearch instead.
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": {
"prompt": "<prompt>"
},
"name": "smartSearch"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| skip | No | Number of results to skip for pagination (default 0). | |
| limit | No | Maximum number of results to return (at most 1000). | |
| prompt | Yes | Natural-language search request to convert into SQL and run. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sql | Yes | ||
| data | Yes | ||
| name | No | ||
| total | Yes | ||
| warnings | Yes |