search_history
Retrieve past PlatypusDB SQL statements, newest first, and filter by connection, text, or origin to inspect how the user queries data.
Instructions
Searches the history of statements run in PlatypusDB, newest first, on the connections agents may use: connection, sql, started_at (UTC, RFC 3339), duration_ms, rows, status (ok, error or cancelled), error and origin (app for what the user ran, else the agent's name). connection limits it to one connection, text to statements containing it (ignoring case), origin to app or agent. 50 entries by default, up to 500 with limit. Use it to see how the user queries the data.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Text the statement contains, ignoring case. | |
| limit | No | Entries returned at most: 50 by default, up to 500. | |
| origin | No | `app` for statements the user ran, `agent` for those agents ran; both when left out. | |
| connection | No | Only this connection's statements: its name, as `list_connections` shows it. |