For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
AcademyContact SalesHelp CenterDashboard
DocumentationAPI ReferenceIntegrationsAdministrationChangelog
DocumentationAPI ReferenceIntegrationsAdministrationChangelog
  • Get Started
    • Introduction
    • Aurora
  • Build
    • Create an Agent
    • The Agent Editor
    • Single-Prompt Agents
      • Getting Started
      • Multi-Agent System
      • Publishing to Live
      • Flow Designer Agents vs Single-Prompt Agents
    • Memory
    • Knowledge Base
    • Variables
    • Version Control
  • Evaluate
    • Manual Testing
    • Custom Evaluations
    • Simulations
  • Launch
    • Deployment Options
    • WhatsApp
    • Website and Apps
    • Launching a Chat Agent
    • Workflows
  • Learn
    • Analytics Dashboard
    • Logs
    • Export Call Data
  • Legal
    • Subscriber Terms
    • GTC - Direct Use (DACH)
    • GTC - Direct Use (US)
    • GTC - Distribution (DACH)
    • GTC - Distribution (US)
    • Business Associate Agreement
    • Privacy Policy
    • Imprint
    • AI Transparency Statement
    • Trust Vault
LogoLogo
AcademyContact SalesHelp CenterDashboard
On this page
  • Why Use Multi-Agent Systems?
  • How It Works
  • The Trigger Subflow Node
  • Setting Up Sub-Agents
  • Step 1: Create Your Sub-Agents
  • Step 2: Trigger Sub-Agents from Your Main Flow
  • Step 3: Pass Variables Between Flows
  • Trigger Subflow vs Jump To
  • FAQ
  • Next Steps
BuildFlow Designer Agents

Multi-Agent System

Create multiple conversation flows in one agent
||View as Markdown|
Was this page helpful?
Previous

Global Settings Node

Next
Built with

The Multi-Agent System allows you to create multiple conversation flows within a single agent. Instead of building one massive flow or separate agents for different scenarios, you can organize specialized sub-agents inside one unified agent.

Use the Trigger Subflow node to hand off from your main conversation to a specialized sub-agent. When the sub-agent finishes, the conversation automatically continues from the Trigger Subflow node—right where it left off.

Why Use Multi-Agent Systems?

Key benefit: Keep your main flow clean and organized while handling complex scenarios in dedicated sub-agents.

Benefits:

  • One agent, multiple flows: All flows share the same phone number, configuration, and analytics
  • Reusable logic: Use the same sub-agent from multiple points in your conversation
  • Automatic return: After a sub-agent completes, the main flow continues automatically
  • Easier maintenance: Update pricing responses in one place instead of scattered throughout your flow
  • Modular organization: Each sub-agent focuses on one specific task

Example: Create a “Pricing Questions” sub-agent. Whenever a user asks about pricing (from anywhere in your main flow), trigger that sub-agent. It answers their questions, then returns control to your main flow exactly where it left off.

How It Works

The Trigger Subflow Node

The Trigger Subflow node allows your main flow to hand off to a specialized sub-agent, then automatically return.

StepWhat Happens
1Main flow reaches a Trigger Subflow node
2Main flow pauses and saves its position
3Sub-agent executes (handles its specialized task)
4Sub-agent completes (reaches the end)
5Control automatically returns to the Trigger Subflow node
6Main flow continues with the next node

Setting Up Sub-Agents

Step 1: Create Your Sub-Agents

In your agent settings, create separate sub-agents for different scenarios:

Common sub-agents:

  • Pricing Questions
  • Technical Support
  • Appointment Scheduling
  • FAQ Handler

Each sub-agent is a complete conversation flow with its own nodes (Conversation, Branch, Message, etc.).

Step 2: Trigger Sub-Agents from Your Main Flow

Add Trigger Subflow nodes in your main conversation:

  1. Click the Plus icon in your main flow
  2. Select “Trigger Subflow”
  3. Choose which sub-agent to trigger
  4. Add nodes after it—these execute when the sub-agent returns

Example:

Step 3: Pass Variables Between Flows

Variables automatically flow between your main flow and sub-agents.

Main Flow → Sub-Agent:

Sub-Agent → Main Flow:

You can view all available variables (from both your main flow and sub-agents) in the variable drawer. This makes it easy to see which variables are accessible at any point in your flow and helps you reference them correctly in nodes.

Trigger Subflow vs Jump To

Both Trigger Subflow and Jump To nodes allow you to redirect your flow, but they serve different purposes. Understanding the difference helps you choose the right tool for your use case.

Trigger SubflowJump To
Jumps to a different sub-agentJumps to a node in the same flow
Returns automaticallyDoesn’t return (permanent redirect)
Use for reusable, modular logicUse for loops within same flow

Key difference: Trigger Subflow hands off to a separate sub-agent and automatically returns when done. Jump To redirects to a node within the same flow and doesn’t return—it’s a permanent redirect.

For more details on when and how to use Jump To nodes, see the Jump To Node documentation.

FAQ

How many sub-agents can I have in one agent?

There’s no hard limit, but we recommend keeping it manageable. Beyond that, consider whether you need multiple separate agents.

Can a sub-agent trigger another sub-agent?

Yes, but avoid going more than 2 levels deep. Deep nesting makes flows hard to debug and maintain.

What happens after a sub-agent completes?

It automatically returns to the Trigger Subflow node in your main flow, and the conversation continues with the next node. The user experiences a seamless transition.

What's the difference between Trigger Subflow and Jump To?

Trigger Subflow hands off to a separate sub-agent and automatically returns. Jump To redirects to a node within the same flow and doesn’t return.

Use Trigger Subflow for reusable logic. Use Jump To for loops within the same flow.

Can variables pass between main flow and sub-agents?

Yes! Variables collected in your main flow are accessible in sub-agents, and sub-agents can update variables that the main flow will see when it returns.

Next Steps

  • Learn about Branch Nodes to decide when to trigger sub-agents
  • Understand the Conversation Node for collecting variables
  • Review Global Settings to configure each sub-agent’s personality
  • Return to Flow Designer Basics