Key Concepts
Triage Agent (Master Agent)
A high-level orchestrator that reads incoming data, follows rule-based Custom Instructions, and routes the task to a Sub-Agent.Sub-Agents
Specialized agents for domains such as Billing, Technical Support, Account Management, or Sales. Each owns a narrow scope and clear success criteria.Custom Instructions
The agent’s “playbook.” A detailed, step-by-step prompt that defines priorities, checks, and handover rules.Tools
External functions/APIs the agent can call to make better routing decisions (e.g., check country, lookup order, subscription status).How the Triage Process Works
- Initial Analysis — Parse subject, description, user data, tags, and variables.
- Priority-Based Checks — Execute checks in order:
- Priority 0: Pre-qualification & Filtering (e.g., non-operational country → send policy message & close).
- Priority 1: Intent Identification (e.g.,
password_reset
,billing_dispute
,product_feature_question
). - Priority 2: Keyword/Tag Fallback when intent confidence is low.
- Routing — Map intent (or fallback outcome) to a Sub-Agent and handover.
- Exception/Fallback — If nothing matches, route to General Queries or flag for human review.
Step-by-Step: Create the Triage Agent
1
Define Your Sub-Agents
Ensure specialized agents exist (e.g., Order Status, Withdrawals, Refund). Each should have a clear scope, inputs, and tools.
2
Create the Triage Agent
Navigate to AI Agents → click Add Agent → name it (e.g., Master Triage Agent) → select Create Agent.
3
Attach Tools (Optional but Recommended)
Add lookups you’ll reference in rules (e.g., country check, order lookup, subscription status).
4
Write the Custom Instructions
Provide a role, process, priority rules, routing map, and a final fallback.
5
Save & Publish
Save, test with sandbox cases, then publish to production when stable.