Sub-Agents

Sub-agents let one Duckie run invoke another active agent as a child run. Use a sub-agent when a specialized agent should handle part of a conversation while the parent agent or workflow keeps ownership of the overall process. The child agent follows its own start mode and configured access.

​

When to Use Sub-Agents

Sub-agents are useful when:

​

How Agents Can Invoke Sub-Agents

Duckie supports sub-agent calls from autonomous agents and workflows.

​

From an Autonomous Agent

An autonomous agent can call other agents as tools when those agents are enabled in Callable agents. To configure this:

1. Open Build > Agents.
2. Open the autonomous agent that will call other agents.
3. In Callable agents, choose None, All, or specific agents.
4. Save the agent.

When the autonomous agent runs, each callable active agent is described to it by name and description. The calling agent decides when to delegate, sends a task, and chooses whether to include the current conversation history.

​

From a Workflow

Workflows can invoke an agent from a Tool node by selecting an agent in the Agents tab. To add an Agent action:

1. Open a workflow in the builder.
2. Add a Tool node.
3. Open the tool selector and choose Agents.
4. Select an active agent.
5. Configure the Agent action inputs.

The selected agent can start autonomously, as Duckie Assistant, from a workflow, or from a runbook. Duckie routes the child run based on that agent’s start mode.

​

Child Agent Inputs

Every child agent run must receive at least one of:

• Instructions - the task or instruction for the child agent
• Conversation history - the parent run’s customer-visible messages

Workflows can also pass Additional context. Autonomous agent calls always include a task and a required conversation-history choice. Workflow Agent actions can use any valid combination.

​

Conversation History

Use conversation history when the child agent needs prior customer messages to complete the task. Workflow Agent actions include conversation history by default. Turn conversation history off when the delegated instructions contain all required context and the child agent should not reason over the full parent conversation.

​

Additional Context

Additional context is available on workflow Agent actions. It is a list, so you can pass more than one context item. Use additional context for structured handoff details such as:

• An order lookup result
• A policy excerpt
• A customer segment or plan
• A value generated by an earlier workflow node

Duckie adds additional context to the child run metadata under additional_context. Child runs also inherit the parent run metadata.

​

What the Parent Receives

The parent receives a compact result from the child run. The child run’s full transcript and steps stay available on the child run. For autonomous child agents, the child returns its internal result with Send result to calling agent. That result becomes the parent-facing summary. This is separate from responder tools.

​

Customer-Visible Responses

Responder tools still send customer-visible messages. If a child agent uses a responder, Duckie also copies the child-authored response into the parent run messages so the parent run transcript stays complete. Use Send result to calling agent for internal parent-facing output. Use a responder only when the child agent should send a customer-visible response.

​

Best Practices

• Give each sub-agent a clear job boundary.
• Keep agent names and descriptions specific enough for another agent to choose correctly.
• Pass focused instructions, even when including conversation history.
• Include conversation history only when the child needs it.
• Use additional context as a short list of relevant facts, not as a dump of every previous node output.
• Test parent and child behavior together in the playground.

​

Next Steps