Agent definition
Delegation and human decisions
Agent definition fields for delegation and human decisions.
For: Plugin authors looking up agent fields.
Look up the fields below when editing an agent definition.
delegation.allow
string[]
Agents
oz.delegate may start.delegation.max_depth
integer
How deep a chain of delegations may go. Unset means 1.
delegation.max_children
integer
Delegations per job. Unset means no limit.
handoffs
string[]
For
openai-agents agents: other openai-agents agents of the same plugin that may take the conversation over in the same job (the SDK's hand-offs). Each must be in delegation.allow; a chain of hand-offs is at most delegation.max_depth long, and hand-offs count against delegation.max_children. A target answers with the output contract of the agent the job started on; plugin lint warns when its own differs.delegation.best_of
map
Runs every delegation as a best-of of the agent delegated to:
n, models, and judge with rubric, or grader, as under best_of. See Outcome checks and patterns.approvals
object
The deadline and the escalation ladder of the approvals this agent waits for, where its tools and the tenant's rules set none:
deadline (1m to 720h), escalation (off with escalation_reason, or at most five steps {at, to}, as a tool's approval). Its questions keep ask_user.timeout and climb this ladder too. See Approvals.ask_user.timeout
duration
How long a question from
oz.ask_user waits for an answer. Unset means 24h. See Asking people.ask_user.on_timeout
string
continue (the default): the agent is told nobody answered and goes on. fail: the job fails with QuestionTimedOut.colleagues.ask
string[]
The agents
oz.ask_colleague may ask. Unset means any colleague: the agent's parent job, a sibling or a child, while it runs. See Colleagues and the board.colleagues.answer
boolean
false refuses every colleague's question. Unset means the agent answers.colleagues.max_questions
integer
Questions one job of the agent may ask. Unset means 10; at most 100.
colleagues.timeout
duration
How long a question waits for its answer. Unset means 5m; at most 1h.
::