run_agent
Delegate complex multi-step tasks to autonomous agents for independent execution with dedicated context, maintaining conversation continuity across sessions.
Instructions
Delegate complex, multi-step, or specialized tasks to an autonomous agent for independent execution with dedicated context (e.g., refactoring across multiple files, fixing all test failures, systematic codebase analysis, batch operations). Returns session_id in response metadata - reuse it in subsequent calls to maintain conversation context continuity across multiple agent executions.
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": "<agent>",
"prompt": "<prompt>",
"cwd": "<cwd>"
},
"name": "run_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | Yes | Agent name exactly as listed in list_agents resource. | |
| prompt | Yes | User's direct request content. Agent context is separately provided via agent parameter. | |
| cwd | Yes | Working directory path for agent execution context. Must be an absolute path to a valid directory. | |
| extra_args | No | Additional configuration parameters for agent execution (optional) | |
| session_id | No | Session ID for continuing previous conversation context (optional). If omitted, a new session will be auto-generated and returned in response metadata. Reuse the returned session_id in subsequent calls to maintain context continuity. |