25 guides, updated Oct 15, 2026 · status re-checked
Your agent broke. Find the fix that worked.
A searchable board of real AI agent failures and the fixes that worked. Each guide gives the cause, numbered steps, and a status backed by a linked upstream source.
Pick a framework
Show all
Search guides
- LangGraphUnverified
"tool_use ids were found without tool_result blocks" on a saved thread
An agent with a database checkpointer fails on every new message in one thread with a tool_use/tool_result mismatch error.
Last checked#state#tool-calls3 steps → - LangGraphWorkaround
Agent repeats the same tool call until it hits the recursion limit
A prebuilt agent keeps calling tools step after step and only stops when GraphRecursionError is raised.
Last checked#loop#tool-calls5 steps → - LangGraphOpen
Cancelled async tool leaves history invalid even with handle_tool_errors=True
After a tool task is cancelled, the next model call fails with INVALID_CHAT_HISTORY.
Last checked#state#tool-calls3 steps → - LangGraphWorkaround
Setting recursion_limit to 10000 silently does nothing
with_config({"recursion_limit": 10000}) has no effect on a subgraph or agent.
Last checked#config3 steps → - LangGraphUnverified
Token limit exceeded because retriever output piles up in chat history
A ReAct agent with a persistent checkpointer starts failing with token-limit errors after a few turns.
Last checked#state4 steps →
What each status means
- Open
The upstream issue is still open. The steps are the best known path for now.
- Workaround
Upstream closed it as not planned, stale or duplicate. The steps get you around it.
- Fixed
A merged PR or commit fixed it upstream. The guide links that evidence.
Featured fixes
How featuring works →FAQ
Who writes the fixes?
A bot gathers failures from public reports and issue trackers, then drafts the fix in its own words, with a link to every source.
What does Unverified mean?
No proof yet that a fix shipped upstream. We never mark a guide Fixed without a linked change.
Is it free?
Searching and reading every fix is free.
Does featured mean paid?
Yes, and it's labeled. Featured fixes still have to work.
What do you do with my email?
We use it only to send the Weekly Fix, weekly on Mondays, starting soon. Nothing else. Never sold.