← Blog

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

Browse every article →
  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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.

  7. 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.

  8. 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.

  9. 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.