Déclencheurs d’escalade clairs
Requêtes explicites, lacunes dans les règles, absence de progression et seuils.
Déclencheurs d’escalade clairs est une leçon Claude Architect gratuite sur CoddyKit. Ceci est la leçon 1 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Claude Architect, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Claude Architect comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Why Escalation Triggers Matter
An autonomous Claude agent will eventually hit a wall it cannot or should not cross alone. The question isn't whether to escalate to a human, but when — and that decision must be defined by clear, deterministic triggers, not vibes.
In the Customer Support scenario, a refund agent that escalates too late frustrates users; one that escalates on every hiccup destroys its own value. This lesson nails down the four reliable escalation triggers the exam expects you to recognize:
- An explicit human request
- A policy gap (no rule covers the case)
- No progress after genuine attempts
- A threshold violation
Trigger 1: Explicit Human Request
If a customer asks to speak to a human, that is not a signal to interpret — it is an instruction to obey. Escalate immediately.
Do not try to talk the user out of it, re-route them through more self-service, or run sentiment analysis to decide if they 'really' meant it. A direct request for a person is the single most unambiguous trigger you will ever get. Treat it as a hard, deterministic branch in your control flow.
# Detect an explicit handoff request as a deterministic branch
def should_escalate(user_message: str) -> bool:
handoff_phrases = [
"talk to a human", "speak to an agent",
"real person", "transfer me",
]
text = user_message.lower()
return any(p in text for p in handoff_phrases)
if should_escalate(latest_user_message):
escalate_to_human(reason="explicit_request", transcript=history)Trigger 2: Policy Gaps
A policy gap occurs when the agent faces a case that no documented rule covers. Example: a refund request for a product category your refund policy never mentions, or an edge case the system prompt simply doesn't address.
The wrong move is to improvise a decision — the model will confidently invent a policy that may be wrong, costly, or non-compliant. The right move is to recognize the absence of guidance and hand off to a human who can make (and document) the call.
SYSTEM_PROMPT = """You are a support agent.
Apply ONLY the refund rules in <policy>.
If a request falls outside every rule in <policy> —
for example a product category or scenario not listed —
do NOT invent a decision. Call escalate_to_human with
reason='policy_gap' and summarize what the policy did not cover.
"""Trigger 3: No Progress After Attempts
The agent should genuinely try before giving up. But once it has made real attempts — gathered identifiers, looked up orders, proposed solutions — and still cannot resolve the issue, lack of progress is itself a valid escalation trigger.
Note the distinction from a blind iteration cap. We escalate because the agent has demonstrably stalled on the task, not merely because a loop counter ticked over. The attempts must be real and observable, not a single failed call dressed up as 'no progress.'
# 'No progress' = real attempts made, issue still unresolved
attempts = 0
resolved = False
while not resolved and attempts < MAX_ATTEMPTS:
result = agent_step(history) # real work each turn
resolved = result.issue_resolved
attempts += 1
if not resolved:
escalate_to_human(
reason="no_progress",
attempts=attempts,
partial_results=result.partial,
)Trigger 4: Threshold Violations
Some actions exceed what an automated agent is permitted to do. A refund above a dollar limit, a bulk operation over a size cap, or any value crossing a defined boundary is a threshold violation — and a clean escalation trigger.
Thresholds are objective and auditable: the value either crosses the line or it does not. That makes them perfect candidates for deterministic enforcement rather than polite prompt instructions, as we'll see in the next scene.
Enforce High-Stakes Thresholds with Hooks
For a threshold with financial, legal, or safety consequences, a prompt is not enough. Prompts are ~90% probabilistic; a determined or unlucky path can still slip past a soft instruction.
Use a PostToolUse / outgoing-call hook to block the action deterministically. The classic exam example: a hook that blocks any process_refund over $500 and forces escalation. Hooks give you 100% deterministic enforcement — the right tool when failure is expensive.
# Outgoing-call hook: deterministic threshold enforcement
def on_process_refund(call):
if call.input["amount"] > 500:
return {
"block": True,
"redirect": "escalate_to_human",
"reason": "threshold_violation: refund > $500",
}
return {"block": False}BAD Triggers: What NOT to Escalate On
Just as important as the good triggers are the ones the exam flags as anti-patterns. Do not drive escalation from:
- Sentiment analysis — 'the user sounds angry' is noisy and gameable.
- Model self-rated confidence (e.g. 'I'm 6/10 sure') — LLM confidence scores are unreliable and uncalibrated.
- Untrained classifiers — an ad-hoc 'is this hard?' model you never validated.
These produce inconsistent, unauditable behavior. Stick to the four objective triggers: explicit request, policy gap, no progress, threshold violation.
The Emotion Pattern: Acknowledge, Solve, Then Escalate
An upset customer is not, by itself, an escalation trigger. The recommended pattern is: acknowledge the emotion → propose a concrete solution → escalate only if the request is reiterated.
This avoids two failures: coldly ignoring frustration, and hair-trigger escalation on every frustrated message. You de-escalate with a real fix first. Only if the customer repeats the demand for a human (an explicit request) do you hand off.
# Emotion handling ≠ sentiment-triggered escalation
GUIDANCE = """When a customer expresses frustration:
1. Acknowledge how they feel, briefly and sincerely.
2. Propose a concrete, specific next step or fix.
3. Escalate to a human ONLY if they reiterate the
request for one. Do not escalate on tone alone.
"""Escalate With Structured Context
Escalation is not a dead end — it's a handoff. The human (or supervising system) needs context to act, so pass it in a structured form:
- Failure / trigger type (policy_gap, no_progress, threshold_violation, explicit_request)
- Attempted actions and queries
- Partial results already gathered
- Alternatives considered
A generic 'could not complete request' blocks recovery. Structured context lets the human resume instantly instead of starting from zero.
escalate_to_human(
trigger="policy_gap",
customer_id=verified_id,
attempted_actions=["lookup_order", "check_refund_policy"],
partial_results={"order": order, "policy_match": None},
alternatives_considered=["store_credit", "partial_refund"],
summary="No policy rule covers digital-gift refunds.",
)Don't Guess: Disambiguate Before Acting
A subtle trigger-adjacent rule: when the agent cannot uniquely identify the subject — e.g. multiple customers match the given name — it must ask for more identifiers, never guess.
Guessing the wrong customer is a silent, high-cost error. This isn't an emotional or confidence judgment; it's an objective ambiguity in the data, handled by requesting disambiguation. Combined with identity-verification preconditions (block sensitive actions until get_customer returns a verified ID), it keeps the agent from acting on the wrong record.
matches = lookup_customer(name="Alex Kim")
if len(matches) == 0:
respond("I couldn't find an account with that name.")
elif len(matches) > 1:
# Never pick one — ask for a disambiguating identifier
respond("I found several accounts. What's your order "
"number or email so I can pull the right one?")
else:
proceed(matches[0])Putting the Triggers Together
A robust agent layers these triggers in priority order. An explicit request short-circuits everything. Threshold violations are enforced by hooks, not hope. Policy gaps and no-progress are model-recognized but escalated with structured context.
Crucially, escalation logic lives alongside the agentic loop, not inside its termination check. You still terminate the loop on stop_reason — never by parsing text — while these triggers decide when a human enters. Deterministic where stakes are high, model-driven where judgment is genuinely needed.
def route(state, user_msg):
if explicit_human_request(user_msg): # Trigger 1
return escalate("explicit_request")
if state.action and over_threshold(state.action): # Trigger 4 (hook-backed)
return escalate("threshold_violation")
if state.policy_match is None: # Trigger 2
return escalate("policy_gap")
if state.attempts_exhausted: # Trigger 3
return escalate("no_progress")
return continue_agent_loop(state)Quick Check: Choosing the Right Trigger
Test your judgment on a realistic support-agent design decision.
Recap: Clear Escalation Triggers
Key takeaways:
- Four good triggers: explicit human request (escalate immediately), policy gap, no progress after real attempts, threshold violation.
- Bad triggers: sentiment analysis, model self-rated confidence, untrained classifiers — noisy and unauditable.
- High-stakes thresholds (refund > $500) belong in deterministic hooks, not prompts.
- Emotion pattern: acknowledge → propose a fix → escalate only if the request is reiterated.
- Escalate with structured context (trigger type, attempts, partial results, alternatives) so a human can resume instantly.
- Ambiguous identity? Ask for more identifiers — never guess.
Objective triggers plus deterministic enforcement where it counts: that's architect-grade escalation design.
Questions Fréquemment Posées
La leçon « Déclencheurs d’escalade clairs » est-elle gratuite ?
Oui — le texte complet de « Déclencheurs d’escalade clairs » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Claude Architect, passe à CoddyKit PRO. Le cours Claude Architect comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Déclencheurs d’escalade clairs » ?
Requêtes explicites, lacunes dans les règles, absence de progression et seuils. Tu pratiques Claude Architect avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Claude Architect ?
Aucune expérience préalable n'est requise. Claude Architect sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 1 sur 4.
Combien de temps prend la leçon « Déclencheurs d’escalade clairs » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Claude Architect ?
Oui. Chaque leçon Claude Architect inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Déclencheurs d’escalade clairs
- Anti-modèle : scores de sentiment et de confiance
- Contexte d’erreur structuré
- Récupération locale ou escalade