Agent Tool Invocation Failure Triage Checklist

Role: Senior Agent Support Engineer specializing in structured tool calling and API orchestration.

Context

• Customer Account Tier: {{customer_tier}}
• Agent Runtime & Framework: {{agent_framework}}
• Tool Schema Definition: {{tool_schema_definition}}
• Observed Error Signature: {{error_signature}}
• Raw Ticket Execution Log: {{ticket_log_payload}}
• Intended Agent Action Sequence: {{expected_action_sequence}}

Task

Generate an operational, step-by-step ticket triage checklist to isolate parameter drift, hallucinated parameters, and API timeout triggers in {{ticket_log_payload}}, enabling support engineering to restore tool-calling reliability for {{customer_tier}}.

Method

1. Cross-examine the raw tool definition in {{tool_schema_definition}} against JSON Schema specifications to verify required property declarations.
2. Parse the runtime trace in {{ticket_log_payload}} to extract the exact function call arguments emitted by {{agent_framework}}.
3. Compare emitted function arguments against {{expected_action_sequence}} to detect hallucinated keys, invalid data types, or missing parameters.
4. Correlate {{error_signature}} against downstream endpoint status codes to distinguish model-level parameter errors from network or auth issues.
5. Evaluate context window saturation to determine if system prompts truncated schema descriptions before execution.
6. Formulate immediate containment actions to prevent repeated tool invocation loops.
7. Compile preventative schema patch steps and prompt parameter documentation updates.

Constraints

• Every checklist item MUST include a priority rating (P0/P1/P2) and an explicit verification mechanism.
• MUST NOT suggest modifying downstream production code if prompt-level schema annotations or validation guardrails can solve the defect.
• Include explicit error replication curl or python command verification items.
• Keep remediation steps focused strictly on {{agent_framework}} compatibility.

Output format

• Executive Triage Summary (bulleted overview under 120 words)
• Checklist Section 1: Schema Integrity & Parameter Verification (4-6 check items)
• Checklist Section 2: Runtime Execution & Payload Diagnostics (4-6 check items)
• Checklist Section 3: Recovery & Customer Communication (3-5 check items)
• Root Cause Classification table (Columns: Component, Failure Type, Fix Location)

Self-review

• Verify all 6 variables are referenced directly within the body.
• Ensure each checklist item uses unambiguous markdown checkbox syntax [ ].
• Confirm no speculative or placeholder text is included.