Invoke Platform Agent Tool
talonic_invoke_agent_toolCall a named read-only Talonic agent tool directly with custom arguments to run data queries, field descriptions, or document reads without a model in the loop.
Instructions
Invoke ONE named tool from the platform's agent tool registry directly, with no model in the loop — you choose the arguments. This is how an external agent uses Talonic's retrieval and provenance while driving control flow itself (e.g. query_data for a read-only SQL SELECT over the extracted data, describe_data for the queryable field list, get_document_markdown to read a document's text).
READ-ONLY FOR EVERY CREDENTIAL: the platform runs each caller of this route, API key or OAuth session alike, as its least-privilege viewer role, which grants only the registry's read-only tools (capability data.read). Write-capable registry tools are never invocable here, however you connected, so this tool reads and never changes workspace data.
Target API: Talonic agent tool registry — https://talonic.com/docs/api (POST /v1/agent/tools/{name}/invoke; input schemas from talonic_list_agent_tools).
USE WHEN: talonic_list_agent_tools showed a tool with can_invoke: true that does what you need. Pass exactly the args its input_schema declares.
NOT FOR: anything a dedicated talonic_* tool already does (prefer those — they are shaped for you).
ARGS: name (tool name), args (object matching the tool's input_schema), optional document_ids (hard scope for scope-aware tools).
RETURNS: { tool, result (the tool's parsed output), citations?, artifacts?, cards? }. Denied capabilities come back as an error naming the capability required; the platform re-checks every call.
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": {
"name": "<name>"
},
"name": "talonic_invoke_agent_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | Arguments matching the tool's input_schema. | |
| name | Yes | Tool name from talonic_list_agent_tools, e.g. `query_data`. | |
| document_ids | No | Restrict to these document ids (hard filter, enforced server-side). |