mirror of
https://github.com/agent0ai/agent-zero.git
synced 2026-08-14 19:05:17 +00:00
a76b0b5b7d
Keep response tool calls at the top level so they can end the parent message loop instead of forcing an unnecessary follow-up turn.\n\nDocument the parallel constraint and cover both runtime rejection and prompt guidance.
37 lines
1.9 KiB
Markdown
37 lines
1.9 KiB
Markdown
### parallel
|
|
run independent tool calls concurrently, or await/cancel background parallel jobs.
|
|
|
|
Use only for independent work. Each `tool_calls` item is a normal tool request object using the same `tool_name` and `tool_args` shape as a top-level reply: `{ "tool_name": "...", "tool_args": { ... } }`.
|
|
Only `tool_name` and `tool_args` are used; if an item is copied from a full reply object, planning fields like `thoughts` or `headline` are ignored.
|
|
Batch all independent calls that are ready now into one `tool_calls` list, even when they use different tools. Do not split by tool type.
|
|
|
|
Rules:
|
|
- do not use for one simple call, dependent steps, ordered steps, shared mutable state, or state/tool-availability changes that must happen in the parent context
|
|
- never nest `parallel`
|
|
- Never include `document_query` in `tool_calls`; it is too heavy for parallel workers, so call it sequentially.
|
|
- Call `response` only as a top-level tool so it ends the message loop; never wrap it inside `parallel.tool_calls`.
|
|
- `call_subordinate` inside `parallel` starts an isolated child chat under the parent chat, not a scheduler task
|
|
- use `wait: false` only when you will collect results later with `job_ids`
|
|
- if extras list running or ready parallel jobs, collect them before final synthesis
|
|
- `timeout` only limits how long this call waits; running jobs continue and can be awaited again by `job_ids`
|
|
|
|
Args: `tool_calls`, `job_ids`, `wait` default `true`, `action` as `start|await|collect|cancel`, `timeout`.
|
|
|
|
Start and wait:
|
|
~~~json
|
|
{
|
|
"tool_name": "parallel",
|
|
"tool_args": {
|
|
"tool_calls": [
|
|
{"tool_name": "call_subordinate", "tool_args": {"message": "Review option A and return key risks.", "reset": true}},
|
|
{"tool_name": "search_engine", "tool_args": {"query": "official API changelog release notes"}}
|
|
],
|
|
"wait": true
|
|
}
|
|
}
|
|
~~~
|
|
|
|
Collect existing jobs:
|
|
~~~json
|
|
{"tool_name": "parallel", "tool_args": {"action": "await", "job_ids": ["job-id"], "timeout": 300}}
|
|
~~~
|