看了篇论文感觉挺有意思的，这个是我目前看，能够比较完整的把智能体错误进行系统整理并給出一个诊断方式的文章。并提出了一个多代理系统故障分类法(MAST - Multi-Agent System Failure Taxonomy)

原文链接

这个文章主要把Agent的问题分为了三类

第一类：系统设计问题

这类错误通常是因为系统让智能体扮演的角色没定义好，或者智能体没能遵守“人设”和规则。其中下分五个错误

1.1 违背任务规范 (Disobey Task Specification)：用户说“不要用固定字典”，智能体非要用。即无视用户的核心约束。 1.2 违背角色规范 (Disobey Role Specification)：角色混乱。比如“产品经理”智能体突然开始写代码，或者无权结束对话的“程序员”擅自宣布任务结束。

1.3 步骤重复 (Step Repetition)：死循环。智能体陷入“报错-重试-报错-重试”的怪圈，或者不断重复已经完成的步骤，像复读机一样。

1.4 对话历史丢失 (Loss of Conversation History)：失忆。智能体突然忘了上一步大家商量好的结果，上下文接不上了。

1.5 不知道何时停止 (Unaware of Termination Conditions)：停不下来。任务明明完成了，智能体还在尴尬地继续聊天，或者任务没完成它却不知道该继续。

第二类：智能体间错位

这是多智能体特有的错误，源于“心智理论”（Theory of Mind）的缺失，即智能体不知道队友需要什么信息。

2.1 对话重置 (Conversation Reset)：聊着聊着突然像刚认识一样，重新开始打招呼或介绍任务，导致之前的进度作废。

2.2 未寻求澄清 (Fail to Ask for Clarification)：不懂装懂。面对模糊的信息（比如缺了密码），智能体不问队友，而是直接瞎猜或硬着头皮做，导致出错。

2.3 任务脱轨 (Task Derailment)：跑题。聊着聊着偏离了最初的目标，去解决无关紧要的边缘问题了。

2.4 信息保留 (Information Withholding)：知情不报。这是最典型的协作失败。例如：代理A知道API的正确格式，但他不告诉正在写代码的代理B，看着B一次次报错。

2.5 忽略他人输入 (Ignored Other Agent’s Input)：当耳旁风。代理A给出了正确的建议，代理B收到了，但在行动中完全无视，继续按错误的方式做。

2.6 推理-行动不匹配 (Reasoning-Action Mismatch)：言行不一。心里想的是“我要调用搜索工具”，结果实际输出的操作却是“结束对话”。

第三类：任务验证

这类错误涉及质量控制，智能体作为“测试员”或“审核员”时经常翻车。

3.1 过早终止 (Premature Termination)：早退。任务还没做完（或者还没做对），智能体就宣布“大功告成”并退出了。

3.2 无验证或不完整验证 (No or Incomplete Verification)：敷衍了事。虽然有测试环节，但只检查表面（例如：代码能运行吗？能。），却不检查核心逻辑（例如：这代码下棋符合规则吗？不符合。）。

3.3 错误验证 (Incorrect Verification)：乱判卷子。对的判成错的（False Positive），或者错的判成对的（False Negative）。

如何使用论文提出的MAST

1.最简单的方式：使用 Python 库

pip install agentdash

import os
os.environ["OPENAI_BASE_URL"] = "xxxx"

from agentdash import annotator

# 1. 初始化标注器
openai_api_key = "xxxx"
MASTAnnotator = annotator(openai_api_key,model="anthropic/claude-sonnet-4.5")

# 2. 准备你的智能体对话记录 (String格式)
trace = """
Agent1: 我需要计算 1+1。
Agent2: 好的，答案是 3。
Agent1: 谢谢，任务完成。
"""

# 3. 生成诊断报告
mast_annotation = MASTAnnotator.produce_taxonomy(trace)

# 4. 查看结果
print("检测到的失效模式:")
for failure_mode_id, detected in mast_annotation["failure_modes"].items():
    if detected:
        info = MASTAnnotator.get_failure_mode_info(failure_mode_id)
        print(f" {failure_mode_id}: {info['name']}")

检测到的失效模式:
 3.1: Premature Termination
 3.2: No or Incorrect Verification

agentdash这个库写的特别简陋，一共只有三个文件

agentdash/
├── __init__.py       # 包初始化，导出主要接口
├── annotator.py      # 核心注释器实现
└── taxonomy.py       # MAST 分类法定义

2.构建 LLM-as-a-Judge 自动化评估管道