ask
Ask questions about your database in plain English; get the SQL query, answer, and results. Supports follow-up context with conversation ID.
Instructions
Ask a question about a database in plain English. The API's own agent translates it to SQL, runs it, and returns the answer (content), the SQL used (sqlQuery), and the results (queryResult). For follow-up questions, pass the conversationId from the previous response. Consumes AI credits — for repeated/known queries prefer run_query.
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": {
"message": "<message>",
"connectionId": "<connectionId>"
},
"name": "ask"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| message | Yes | The question in plain English, e.g. 'Top 10 customers by revenue in the last 30 days' | |
| connectionId | Yes | Connection id from list_connections | |
| conversationId | No | Optional: conversationId from a previous ask response, to keep context for follow-ups |