明確なエスカレーション条件
明示的な依頼、ポリシーの不足、進展の停止、しきい値について学びます
「明確なエスカレーション条件」はCoddyKit上の無料Claude Architectレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはClaude Architect学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Claude Architectコースには全4レッスンが含まれています。
このレッスンの一部はまだ翻訳されておらず、英語で表示されています。
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.
よくある質問
「明確なエスカレーション条件」レッスンは無料ですか？
はい。「明確なエスカレーション条件」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Claude Architectコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Claude Architectコースには全4レッスンが含まれています。
「明確なエスカレーション条件」で何を学びますか？
明示的な依頼、ポリシーの不足、進展の停止、しきい値について学びます ブラウザで直接実行するハンズオンコードでClaude Architectを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。
Claude Architectを始めるのに経験は必要ですか？
事前経験は必要ありません。CoddyKitのClaude Architectは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。
「明確なエスカレーション条件」レッスンにはどのくらい時間がかかりますか？
ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。
このClaude Architectレッスンでコードを書いて実行できますか？
はい。すべてのClaude Architectレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。
このコースのすべてのレッスン
- 明確なエスカレーション条件
- アンチパターン：感情と信頼度のスコア
- 構造化されたエラーコンテキスト
- ローカル復旧とエスカレーション