Skip to main content
Agent Grouping allows you to bundle multiple specialized agents under a single main agent.
This enables users to dynamically switch between experts within the same chat interface, based on context. With Agent Grouping, users can:
  • Switch between agents dynamically inside the chat widget
  • Interact with each agent’s unique knowledge base
  • Optimize token usage by isolating prompts per sub-agent
  • Organize agents for specialized tasks (e.g., Interviewer, Excel helper, Pronunciation coach)

​
What is a Main Agent?

The Main Agent acts as the anchor. Other agents (called Linked Agents) will be accessed through the main agent’s widget. Each Linked Agent:
  • Is independently configured
  • Has its own datastore and knowledge
  • Can be selected in the frontend chat widget for specialized responses

​
Requirements

Before setting up grouping:
  • All agents (main and sub-agents) must be set to live
  • Each agent should have at least one valid datastore
  • Grouping must be explicitly enabled in the Main Agent’s channel config

​
How to Group Agents

1

Create and activate your agents

Go to My Agents and ensure all agents you want to group are created and active.
My Agents: All agents live and ready for grouping

My Agents: All agents live and ready for grouping

2

Open the main agent playground

Select the agent that will act as the Main Agent and navigate to the Channels tab.
Channels: Navigate to Main Agent’s playground

Channels: Navigate to Main Agent’s playground

3

Enable Agent Grouping

Scroll to the Agent Grouping section and toggle “Enable Grouping”.
Enable Grouping: Toggle to activate agent grouping mode

Enable Grouping: Toggle to activate agent grouping mode

4

Set the Main Agent

Once grouping is enabled, the selected agent is tagged as the Main Agent.
Click Link Agent to start selecting sub-agents.
Link Agents: Assign specialized sub-agents to the main agent

Link Agents: Assign specialized sub-agents to the main agent

5

Select Linked Agents

Only active agents are shown in the dropdown. Select the agents you want to group and click Link Agent.
Dropdown: Select which agents to group under the Main Agent

Dropdown: Select which agents to group under the Main Agent

Once you’ve selected your desired agents, they will be listed as part of the agent group under the main agent.
Success: Agents added to the group successfully

Success: Agents added to the group successfully

6

Chat Widget Experience

When the widget is loaded for the main agent, users can switch between all linked agents in real-time based on context.
Widget View: Switch between grouped agents at runtime

Widget View: Switch between grouped agents at runtime

​
Tips & Notes

  • Sub-agents do not share knowledge across the group.
  • Switching agents does not reset the conversation unless designed to.
  • Each sub-agent retains its independent model and prompt style.

​
✅ Example Use Cases

​
🧑‍💼 HR Assistant Suite

  • Main Agent: Job Application Guide
  • Linked Agents:
    • 📄 Resume Reviewer – Analyzes uploaded resumes and offers formatting or content improvements.
    • 🧪 Interview Simulator – Conducts mock interviews tailored to job roles.
    • 📬 Offer Negotiator – Helps craft polite counteroffers and answers negotiation-related queries.
Why this works:
Candidates receive end-to-end job search support within a single chat interface — from resume polishing and interview practice to final-stage negotiation help.

​
🧑‍🎓 AI Student Mentor

  • Main Agent: Academic Coach
  • Linked Agents:
    • 📚 Math Problem Solver – Provides step-by-step solutions for algebra, calculus, and statistics problems.
    • 🧪 Science Explainer – Simplifies complex physics, chemistry, or biology concepts into digestible chunks.
    • 📝 Essay Feedback Agent – Reviews written submissions and suggests grammar and clarity improvements.
Why this works:
Students can switch between topic-specific AI mentors to support homework, exam prep, and writing — without breaking flow or opening separate tools.
⌘I