When Agents Fail: A Comprehensive Study of Bugs in LLM Agents with Automated Labeling

Fuente: arXiv
Guardado en:
Detalles Bibliográficos
Autores principales: Islam, Niful, Ayon, Ragib Shahriar, Thomas, Deepak George, Ahmed, Shibbir, Wardat, Mohammad
Formato: Preprint
Publicado: 2026
Materias:
Acceso en línea:
Etiquetas: Agregar Etiqueta
Sin Etiquetas, Sea el primero en etiquetar este registro!
_version_ 1866911622244597760
author Islam, Niful
Ayon, Ragib Shahriar
Thomas, Deepak George
Ahmed, Shibbir
Wardat, Mohammad
author_facet Islam, Niful
Ayon, Ragib Shahriar
Thomas, Deepak George
Ahmed, Shibbir
Wardat, Mohammad
contents Large Language Models (LLMs) have revolutionized intelligent application development. While standalone LLMs cannot perform any actions, LLM agents address the limitation by integrating tools. However, debugging LLM agents is difficult and costly as the field is still in it's early stage and the community is underdeveloped. To understand the bugs encountered during agent development, we present the first comprehensive study of bug types, root causes, and effects in LLM agent-based software. We collected and analyzed 1,187 bug-related posts and code snippets from Stack Overflow, GitHub, and Hugging Face forums, focused on LLM agents built with seven widely used LLM frameworks as well as custom implementations. For a deeper analysis, we have also studied the component where the bug occurred, along with the programming language and framework. This study also investigates the feasibility of automating bug identification. For that, we have built a ReAct agent named BugReAct, equipped with adequate external tools to determine whether it can detect and annotate the bugs in our dataset. According to our study, we found that BugReAct equipped with Gemini 2.5 Flash achieved a remarkable performance in annotating bug characteristics with an average cost of 0.01 USD per post/code snippet.
format Preprint
id arxiv_https___arxiv_org_abs_2601_15232
institution arXiv
publishDate 2026
record_format arxiv
spellingShingle When Agents Fail: A Comprehensive Study of Bugs in LLM Agents with Automated Labeling
Islam, Niful
Ayon, Ragib Shahriar
Thomas, Deepak George
Ahmed, Shibbir
Wardat, Mohammad
Software Engineering
Large Language Models (LLMs) have revolutionized intelligent application development. While standalone LLMs cannot perform any actions, LLM agents address the limitation by integrating tools. However, debugging LLM agents is difficult and costly as the field is still in it's early stage and the community is underdeveloped. To understand the bugs encountered during agent development, we present the first comprehensive study of bug types, root causes, and effects in LLM agent-based software. We collected and analyzed 1,187 bug-related posts and code snippets from Stack Overflow, GitHub, and Hugging Face forums, focused on LLM agents built with seven widely used LLM frameworks as well as custom implementations. For a deeper analysis, we have also studied the component where the bug occurred, along with the programming language and framework. This study also investigates the feasibility of automating bug identification. For that, we have built a ReAct agent named BugReAct, equipped with adequate external tools to determine whether it can detect and annotate the bugs in our dataset. According to our study, we found that BugReAct equipped with Gemini 2.5 Flash achieved a remarkable performance in annotating bug characteristics with an average cost of 0.01 USD per post/code snippet.
title When Agents Fail: A Comprehensive Study of Bugs in LLM Agents with Automated Labeling
topic Software Engineering
url https://arxiv.org/abs/2601.15232