Task groups in code

​

Quickstart

from unmute_core.tasks import TaskGroupSpec

TaskGroupSpec(
    name="book",
    when="The caller wants to create, move or cancel a booking.",
    steps=("verify_customer", "manage_booking"),
    context_scope="shared",
    skip_when_confirmed={"verify_customer": "customer_phone"},
    arguments=("requested_service", "requested_day", "requested_intent"),
)

​

Why use unmute for this

​

Group fields

• shared: each step hears the steps before it.
• isolated: each step starts fresh.

1. when says when the main agent starts the group.
2. announce holds lines spoken as it starts.
3. non_blocking names steps whose failure the group records and carries on past. Each must be one of its steps.
4. skip_when_confirmed maps a step to the State value whose confirmation lets the group skip it. The step must be the one that confirms that value.
5. inputs is what every step reads at the end of its prompt, before its own inputs.
6. arguments are State values the main agent passes when it starts the group. Each call saves all of them.

​

What a group does when it finishes

1. then_target is required with transfer, and refused with return or end.
2. The adapter’s then_targets maps each target to the handoff that gives it the call. A target it does not name is refused when the agent is built. See Handoffs.
3. A group that hands the caller back, or fails, always returns to the main agent. So the caller is never dropped mid-request.
4. The main agent’s tool description says that the flow ends the call, or hands the caller on.

1. Use shared when a later step needs what an earlier one heard.
2. Use transfer only with a then_target the adapter’s then_targets holds.

agent = UnmuteAgent(AgentSpec(PROMPT, tasks=plan), state=state, then_targets={"billing": to_billing})

​

Troubleshooting

​

A group that transfers is refused when the agent is built

​

A step of a group never starts by itself

​

Where to go next