delegate_to_group
Delegate tasks to a named agent group, spawning agents with shared config and returning task IDs for immediate, non-blocking execution. Supports parallel spawning via count parameter.
Instructions
Delegate a task to a named agent group. Spawns agents with the group's shared config (runner, skill, policy).
Use count to launch multiple agents in parallel (fractal orchestration).
Returns array of task_ids immediately (non-blocking). Use get_task_result to check each.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Working directory. Defaults to current working directory. | |
| count | No | Number of agents to spawn. Default: 1. | |
| files | No | Known relevant file paths used as structured focus hints for context resolution. May include paths attached in the UI. | |
| group | Yes | Group name to delegate to. | |
| model | No | Model override for this group delegation. Default: group profile/model. | |
| prompt | Yes | Task description for the agents. | |
| chat_id | No | Existing chat ID to bind child tasks to. | |
| timeout | No | Timeout in seconds. Overrides group default. | |
| provider | No | CLI provider override for this group delegation. Default: group provider or codex. | |
| agent_slug | No | Agent role slug passed to child tasks. | |
| session_id | No | Provider session/thread ID passed through for resumed tasks. | |
| focus_graph | No | Portal-provided compact project-graph focus context for files[], including symbols, imports, dependencies, and web component summaries when present. Usually injected automatically; direct callers should prefer files[]. | |
| serviceTier | No | Service tier for Codex. Codex maps to service_tier. | |
| context_mode | No | Context package mode for delegated agents. auto injects the metadata-first resolved context package. off disables injection. Default: auto. | |
| include_dirs | No | Scope directories override for child tasks. Default: group include_dirs. | |
| on_wait_hint | No | Optional wait hint shown while the task runs. | |
| allowed_tools | No | Provider tool allowlist override for compatible runners. | |
| approval_mode | No | Access mode override passed to child tasks. | |
| parent_chat_id | No | Parent chat ID used to create/bind child task chats. | |
| reasoningEffort | No | Provider reasoning effort. Codex accepts the selected model value and maps it to model_reasoning_effort. Claude Code accepts low, medium, high, xhigh, or max and maps it to --effort. |