Crew Manage Tool
crew_manageSet up, manage, and run multi-agent crews that decompose goals across roles using sequential, parallel, or hierarchical processes. Execute tasks asynchronously and check progress.
Instructions
Multi-agent crews — coordinated teams of agents that decompose a goal across roles (sequential, parallel, or hierarchical process). execute is async: it queues ExecuteCrewJob and returns immediately with an execution_id; poll execution_status for progress. Each crew member must be a real agent_id in the same team.
Actions:
list / get (read) — list all or fetch one (crew_id).
create (write) — name, process_type (sequential|parallel|hierarchical), agents[] (array of {agent_id, role}).
update (write) — crew_id + any creatable field.
delete (DESTRUCTIVE) — crew_id. Soft-deletes the crew.
execute (write — long-running) — crew_id, goal. Reserves budget, returns execution_id.
execution_status (read) — crew_id, execution_id. Status, current task, partial results.
executions_list (read) — crew_id; optional limit.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action to perform: list, get, create, update, execute, execution_status, executions_list | |
| deadline_ms | No | Optional: max wall-clock time (ms) the tool may spend. If exceeded during the call, returns a DEADLINE_EXCEEDED error. Minimum 100 ms. Leave unset for no deadline. | |
| status | No | Filter by status: draft, active, archived | |
| limit | No | Max results to return (default 10, max 100) | |
| crew_id | Yes | The crew UUID | |
| name | Yes | Crew name | |
| coordinator_agent_id | Yes | UUID of the coordinator agent | |
| qa_agent_id | No | UUID of the QA agent. Optional — when omitted, the coordinator reviews their own work (solo-mode crew). | |
| description | No | Crew description | |
| process_type | No | Process type: sequential, parallel, hierarchical (default: hierarchical) | hierarchical |
| convergence_mode | No | How to determine when the crew is done: any_validated (default), all_validated, threshold_ratio, quality_gate | |
| min_validated_ratio | No | Fraction of tasks that must be validated when using threshold_ratio mode (e.g. 0.8 = 80%). Default: 1.0 | |
| goal | Yes | The goal/task for the crew to accomplish | |
| execution_id | Yes | The crew execution UUID | |
| include_full_output | No | Include full final_output instead of 500-char preview (default false) |