Skip to main content
Escalation rules define conditions under which your agent should stop and hand off the conversation to a human agent.

What are Escalation Rules?

Escalation rules identify situations where human judgment is needed:
  • Customer is upset or threatening
  • Question involves legal, compliance, or security
  • Issue is too complex for automation
  • Customer explicitly requests a human
  • VIP or high-value customer needs attention

Creating Escalation Rules

1

Navigate to Guardrails

Go to Train → Guardrails and select the Escalation Rules tab.
2

Click Create Rule

Click Create Escalation Rule.
3

Name Your Rule

Give it a descriptive name:
  • Good: “Angry Customer Escalation”, “Legal Question Detection”
  • Avoid: “Rule 1”, “Escalation”
4

Define Trigger

Configure what causes this rule to trigger.
5

Configure Response

Define what happens when triggered:
  • Message to send to customer
  • Internal note content
  • Routing rules
6

Test

Use the built-in playground to verify detection.
7

Save

Save and activate the rule.

Detection Methods

AI-Based Detection

Use natural language to describe when to escalate: Example prompts:
Strengths:
  • Handles nuanced situations
  • Adapts to context
  • No need to predict every phrase

Keyword Detection

Trigger on specific words or phrases: Example keywords:
Strengths:
  • Fast and predictable
  • Easy to understand and audit
  • Good for specific trigger words

Regex Detection

Match complex patterns: Example patterns:
Strengths:
  • Precise pattern matching
  • Good for structured data
  • Catches variations

Combining Methods

Use multiple detection methods together:

Configuring Escalation Response

Customer Message

What the agent sends to the customer when escalating: Example:

Internal Note

Context for the human agent:

Routing (if applicable)

Where to route the escalated conversation:
  • Specific team or queue
  • Priority level
  • Assignment rules

Example Escalation Rules

Angry Customer

VIP Customer

Human Request

Testing Escalation Rules

Use the built-in playground:
  1. Open the escalation rule
  2. Enter test messages
  3. See if the rule triggers
  4. Adjust detection criteria as needed
Test scenarios to try:
  • Messages that should clearly trigger
  • Messages that should clearly not trigger
  • Edge cases and borderline situations

Assigning to Agents

1

Open Agent Configuration

Go to Build → Agents and click on an agent.
2

Go to Guardrails Tab

Select the Guardrails tab.
3

Select Escalation Rules

Check the rules that should apply to this agent.
4

Save

Save the agent configuration.

Best Practices

  • Test thoroughly before activating
  • Start broader, then refine — better to escalate too much initially
  • Review regularly — analyze which rules trigger most
  • Balance sensitivity — too sensitive = too many escalations
  • Provide context — good internal notes help human agents

Next Steps

Restrictions

Set hard limits on agent behavior

Guardrails Overview

Back to overview