Series
Why did the agent do that?
Answers to questions about repeated tool calls, duplicate messages, missing documents, API permissions, approval replay, and growing AI bills.
9 articles
Reading list
In this series
- 01
· Engineering · 4 min
AI agent troubleshooting: find the question behind the failure
Find answers to 40 practical questions about agent loops, Slack duplicates, Notion retrieval, Stripe retries, MCP permissions, GitHub access, context cost, and approvals.
- 02
· Engineering · 4 min
Why does my AI agent keep calling the same tool?
Diagnose repeated tool calls, iteration limits, parsing failures, and legitimate polling. Build a stopping rule that preserves useful progress.
- 03
· Operations · 4 min
Why is my Slack bot sending duplicate messages?
Separate Slack event retries, duplicate workers, and repeated sends. Diagnose message duplication without throwing away legitimate events.
- 04
· Engineering · 4 min
Why can my agent find a Notion page but not read its contents?
Answers to Notion page-body, sharing, pagination, nested-block, and search questions, with a retrieval checklist for grounded agent answers.
- 05
· Engineering · 4 min
How do I stop Stripe retries from doing the work twice?
Understand duplicate Stripe webhooks, event ordering, idempotency keys, concurrent workers, and unknown outcomes before retrying agent actions.
- 06
· Identity & access · 4 min
How do MCP permissions work when agents use company tools?
Answers to MCP authentication, per-tool authorization, user identity, token passthrough, and approval questions for agents using company systems.
- 07
· Cost · 4 min
Why do agent conversations get more expensive as they get longer?
Answers to conversation-history billing, previous_response_id, prompt caching, zero cache hits, and context summarization without losing the task.
- 08
· Approvals & policy · 4 min
Why does a LangGraph approval step run again when I resume it?
Understand interrupt replay, repeated side effects, thread IDs, parallel approvals, and incomplete state when resuming human-in-the-loop agents.
- 09
· Identity & access · 4 min
Why does my GitHub agent get 404 or resource not accessible errors?
Diagnose GitHub API routes, token permissions, repository access, Actions token scope, and rate limits without granting broad access blindly.