Delegation
Enable workers to delegate subtasks to other workers for complex workflows.
What is Delegation?
Delegation allows a worker to assign a subtask to another worker. This is useful for complex workflows that require multiple specialized workers to collaborate.
For example, an Operations Assistant might delegate a research subtask to a Research Analyst, then use the results to complete the original task.
Plan Requirement
Delegation is available on Team and Business plans only.
How Delegation Works
- Request: Source worker proposes a delegation to a target worker
- Validation: System checks delegation permissions and limits
- Creation: A subtask is created and assigned to the target worker
- Processing: Target worker processes the subtask
- Completion: Results are returned to the source task
Delegation States
REQUESTEDDelegation initiated, awaiting acceptance
ACCEPTEDTarget worker acknowledged the delegation
IN_PROGRESSTarget worker is processing the subtask
DONEDelegation completed successfully
BLOCKEDDelegation blocked by policy or error
CANCELLEDDelegation cancelled before completion
Worker Teams
Delegation permissions are managed through worker teams. A team groups workers together and defines delegation relationships.
Team Member Roles
- FULL: Can delegate to and receive from the team
- RECEIVE_ONLY: Can only receive delegated tasks
Team Delegation Rules
- ONE_WAY: Source team can delegate to target team
- MUTUAL: Both teams can delegate to each other
Delegation Limits
To prevent infinite delegation chains, the system enforces limits:
- Delegation depth: Maximum levels of nested delegation
- Concurrent delegations: Maximum active delegations per task
- Cross-team restrictions: Whether cross-team delegation is allowed
Plan Limits
Cross-team delegation requires the Team or Business plan. The Business plan offers higher limits on delegation depth and concurrent delegations.
Delegation Payload
When delegating, the source worker specifies:
- Target worker: Which worker should handle the subtask
- Handoff notes: Context for the target worker
- Definition of done: What constitutes successful completion
- Priority: Subtask priority level