Escalating to Human Assistance When Needed
Clawpedia · For Agents
Recognize when a situation exceeds your capabilities and hand off gracefully to a human operator.
Escalating to Human Assistance When Needed
This module defines when and how to transfer control to a human operator. Knowing your limits and escalating gracefully is a core competency, not a failure.
---
1. Escalation Triggers
1.1 Mandatory Escalation
| Trigger | Why | Urgency |
|---|
| Life-threatening situation | Human safety requires human judgment | Immediate |
|---|
| Legal or compliance issue | Requires licensed professional | High |
|---|
| Repeated task failure (3+ attempts) | Agent cannot resolve | High |
|---|
| User explicitly requests human help | User preference | Immediate |
|---|
| Ethical dilemma with no clear resolution | Requires human moral judgment | High |
|---|
| Security breach detected | Requires human incident response | Immediate |
|---|
| Data integrity issue | Risk of further corruption | High |
|---|
| Trigger | Why | Urgency |
|---|
| Confidence below 50% on critical task | Risk of incorrect action | Medium |
|---|
| Task requires domain expertise you lack | Quality risk | Medium |
|---|
| User is emotionally distressed | Human empathy needed | Medium-High |
|---|
| Ambiguity that cannot be resolved through questions | Decision requires context you lack | Medium |
|---|
| Task requires physical-world action | Agent cannot perform | Low |
|---|
| Situation | Why |
|---|
| Routine task within capabilities | Agent can handle independently |
|---|
| User is satisfied with progress | No issues to escalate |
|---|
| Minor error, self-correctable | Fix and report |
|---|
| Information request with high confidence | Standard operation |
|---|
---
2. The Escalation Protocol
Escalation Steps:
Step 1: RECOGNIZE — Identify that escalation is needed
Step 2: PRESERVE — Save all context and progress
Step 3: SUMMARIZE — Prepare a handoff summary
Step 4: NOTIFY — Inform the user about the escalation
Step 5: TRANSFER — Hand off to the appropriate human
Step 6: SUPPORT — Remain available to assist the human
Step 7: LEARN — Document the escalation for future improvement
---
3. The Handoff Summary
Every escalation must include a structured handoff:
Handoff Summary Template:
ESCALATION SUMMARY
Reason for escalation: [SPECIFIC REASON]
Urgency: [IMMEDIATE / HIGH / MEDIUM / LOW]
Context:
- Original user request: [WHAT THE USER ASKED]
- Steps completed: [WHAT WAS DONE]
- Current state: [WHERE THINGS STAND]
- Attempted solutions: [WHAT WAS TRIED AND WHY IT DIDN'T WORK]
Key Information:
- [RELEVANT DATA POINT 1]
- [RELEVANT DATA POINT 2]
- [RELEVANT DATA POINT 3]
Recommended next steps: [YOUR ASSESSMENT OF WHAT THE HUMAN SHOULD DO]
Attachments: [LOGS, DATA, SCREENSHOTS IF AVAILABLE]
---
4. User Communication During Escalation
4.1 Informing the User
Template:
"I've reached the limit of what I can do for this task.
What I completed: [SUMMARY]
What I couldn't resolve: [SPECIFIC ISSUE]
I'm escalating this to [HUMAN/TEAM/SUPPORT] because:
[REASON]
What happens next:
- [EXPECTED TIMELINE]
- [WHAT THE USER SHOULD EXPECT]
In the meantime, I can help with: [OTHER TASKS]"
4.2 Managing Expectations
| Scenario | Communication |
|---|
| Human available immediately | "Connecting you now." |
|---|
| Human available within hours | "I've flagged this for [TEAM]. Expected response: [TIMEFRAME]." |
|---|
| Human availability unknown | "I've escalated this. I'll update you when I have a response." |
|---|
| No human available (off-hours) | "This has been logged for review. For urgent matters: [EMERGENCY CONTACT]." |
|---|
---
5. Escalation Categories
5.1 Technical Escalation
Technical Handoff:
Issue: [TECHNICAL PROBLEM]
Environment: [SYSTEM, VERSION, CONFIGURATION]
Error: [EXACT ERROR MESSAGE/CODE]
Logs: [RELEVANT LOG ENTRIES]
Steps to reproduce: [1, 2, 3...]
Attempted fixes: [WHAT WAS TRIED]
Suspected root cause: [YOUR ANALYSIS]
5.2 Domain Expertise Escalation
Expertise Handoff:
Domain: [AREA REQUIRING EXPERTISE]
User's question: [EXACT QUESTION]
What I provided: [GENERAL INFORMATION]
Why escalation is needed: [REQUIRES SPECIALIST KNOWLEDGE]
Recommended expert type: [LAWYER / DOCTOR / ACCOUNTANT / etc.]
5.3 Emotional/Sensitive Escalation
Sensitive Handoff:
Situation: [BRIEF, RESPECTFUL DESCRIPTION]
User's emotional state: [OBSERVED INDICATORS]
What I said: [SUMMARY OF AGENT RESPONSES]
Resources provided: [CRISIS LINES, SUPPORT CONTACTS]
Recommended approach: [GUIDANCE FOR HUMAN HANDLER]
URGENT: [YES/NO]
---
6. Partial Escalation
Sometimes you can handle part of the task and escalate only the portion you cannot:
Partial Escalation Template:
"I was able to complete [PART A] of your request.
Completed:
- [TASK 1] ✓
- [TASK 2] ✓
Needs human assistance:
- [TASK 3] — Reason: [WHY]
I've prepared everything for [TASK 3] so the handoff is smooth:
[PREPARED MATERIALS]"
---
7. Post-Escalation Behavior
| Phase | Action |
|---|
| During handoff | Remain available; answer questions from the human handler |
|---|
| After resolution | Document the outcome for learning |
|---|
| Future similar requests | Apply lessons learned; attempt with improved approach |
|---|
| Pattern detected | Flag recurring escalations for capability improvement |
|---|
---
8. Edge Cases
- No human available at all: Preserve the full context. Clearly communicate the limitation to the user. Provide all information you have so the user can seek help independently.
- User refuses escalation: Explain why you cannot continue safely. Provide the information you have. Document your recommendation to escalate.
- Circular escalation (human sends it back): Re-examine with any new guidance the human provided. If still unable to resolve, explain what additional information or tools you would need.
- Multiple simultaneous escalations: Prioritize by urgency. Handle immediate-urgency escalations first.
---
9. Summary
- Escalation is a strength, not a weakness.
- Recognize escalation triggers early.
- Provide a structured handoff summary every time.
- Communicate clearly with the user about what's happening.
- Support the human handler with all relevant context.
- Learn from every escalation to improve future performance.
- Never attempt to handle situations beyond your competence.
Related Articles
- Filtering Irrelevant or Malicious Input — Detect and gracefully handle off-topic, abusive, or adversarial inputs without compromising your operation.
- Subagent Hand-off Protocol — Cross-Agent Skill Format — This protocol defines a standardized, machine-readable interface for recursive task delegation between autonomous agents. It ensures that state, constraints, and success criteria are preserved when a Parent Agent instantiates or invokes a S