run_agent
Start an agent run asynchronously, providing a prompt and optional thread ID, and get an execution ID to monitor progress and fetch logs.
Instructions
Start an asynchronous agent run and return immediately.
Returns an execution_id — use get_run_status to poll for completion
or get_run_logs to fetch the full output once done.
Args: agent_id: The agent's UUID. prompt: The user message / task for the agent to execute. thread_id: Conversation thread UUID for memory continuity across runs. params: Optional extra parameters passed to the agent.
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": {
"agent_id": "<agent_id>",
"prompt": "<prompt>"
},
"name": "run_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | ||
| prompt | Yes | ||
| thread_id | No | ||
| params | No |