Search papers, labs, and topics across Lattice.
This paper presents an empirical study of 998 bug reports from CrewAI and LangChain to understand framework-level bugs in LLM agent systems, which are often overlooked in favor of agent-level failures. The authors construct a taxonomy of 15 root causes and 7 observable symptoms across five agent lifecycle stages. The study finds that bugs frequently stem from API misuse, incompatibility, and documentation desynchronization, particularly during the Self-Action stage, manifesting as functional errors, crashes, and build failures.
LLM agent frameworks are riddled with bugs stemming from API misuse and documentation issues, leading to crashes and functional errors that current agent-level evaluations miss.
LLM agents have been widely adopted in real-world applications, relying on agent frameworks for workflow execution and multi-agent coordination. As these systems scale, understanding bugs in the underlying agent frameworks becomes critical. However, existing work mainly focuses on agent-level failures, overlooking framework-level bugs. To address this gap, we conduct an empirical study of 998 bug reports from CrewAI and LangChain, constructing a taxonomy of 15 root causes and 7 observable symptoms across five agent lifecycle stages:'Agent Initialization','Perception','Self-Action','Mutual Interaction'and'Evolution'. Our findings show that agent framework bugs mainly arise from'API misuse','API incompatibility', and'Documentation Desync', largely concentrated in the'Self-Action'stage. Symptoms typically appear as'Functional Error','Crash', and'Build Failure', reflecting disruptions to task progression and control flow.
Tsinghua AI