create_agent_run
Send a follow-up instruction to an active agent. Optionally include images, MCP servers, or override the mode.
Instructions
Send a follow-up prompt to an active agent (POST /v1/agents/{id}/runs).
Args: agent_id: Agent id (for example bc-...). prompt_text: Follow-up instruction text. mode: Optional mode override: agent or plan. prompt_images_json: Optional JSON array of prompt images. mcp_servers_json: Optional JSON array of MCP servers for this run. extra_json: Optional JSON object merged into the body. Cannot overwrite prompt, mcpServers, or mode when those were set by typed args.
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_text": "<prompt_text>"
},
"name": "create_agent_run"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| agent_id | Yes | ||
| extra_json | No | ||
| prompt_text | Yes | ||
| mcp_servers_json | No | ||
| prompt_images_json | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||