call_agents_batch
Run multiple agents concurrently and wait until all finish, providing all results together for scenarios where you need every output before taking the next step.
Instructions
Execute multiple agents in PARALLEL (BLOCKING until ALL complete).
⚠️ Usually NOT what you want
Prefer call_agent_async × N instead:
Async returns immediately, you can continue working
Batch blocks until the SLOWEST agent finishes
If one agent takes 2min, you wait 2min doing nothing
Only use batch when:
You MUST have ALL results before ANY next step
Results are interdependent (rare)
You're okay blocking for potentially minutes
Example (usually wrong):
{ "calls": [{ "agent": "explore", ... }, { "agent": "researcher", ... }] }↑ This blocks until both finish. Use call_agent_async × 2 instead.
Example (correct use case): Comparing outputs from multiple agents where you need all results simultaneously.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | Yes | Working directory for all agents (required) | |
| calls | Yes | Array of agent calls to execute in parallel (1-10 calls) |