多 Agent 跑任务失败之后，优先按照 EMMA 这套框架定位故障归属，再针对性改提示词、Skill 技能或者任务分工，而不是笼统地调大模型参数或者随便换模型，EMMA 的核心思路就是把失败精准归类到这三层里面，避免盲目迭代。很多团队踩坑就是不管是什么原因，全部一股脑修改 Agent 提示词，分工重叠、技能本身有缺陷、调度路由问题却没处理，最后反复重试依然失败。EMMA 自带反思模块，先读取完整执行轨迹、定位在哪一步、哪个 Agent 出问题，判断是单 Agent 理解偏差、技能调用出错，还是 Agent 之间协作边界混乱，再确定修改范围，每次只做小范围增量改动，不会同时改动多处配置，方便复现和验证。整套排查流程是先拉取完整 Trace 日志，用 EMMA 的反射器做失败归类，匹配三类修改域：提示词域、Skill 技能域、任务分工 / 调度域，做完单点修改之后，在相同测试用例上回放验证，确认通过率提升之后再固化到 episodic memory 里，持续沉淀失败案例。提示词负责单个 Agent 的角色、输出规范、禁止行为；Skill 是可复用的工具流程、子任务脚本；分工决定谁来做、什么时候交接、并行还是串行，三者修改边界清晰，改错地方就会越调越乱。
一、EMMA 框架三大修改域清单
- 提示词（Prompt）：单 Agent 角色定义、思考规则、输出格式、约束边界、失败处理话术
- Skill 技能：可复用的过程化工具、子流程、工具调用模板、参数校验、重试逻辑、沙箱执行脚本
- 任务分工 / 调度：角色权责、任务拆解规则、交接协议、路由判断、并行 / 串行依赖、仲裁、升级条件
二、失败现象、根因、对应修改位置对照表
| 失败现象 | 根因归类 | 优先修改位置 | 修改要点 |
|---|---|---|---|
| Agent 理解跑偏、越权干活、输出格式乱、遗漏约束 | 单 Agent 认知偏差 | 提示词 | 补禁止行为、输出 Schema、验收标准、负向示例 |
| 工具调用参数错、接口报错、缺少校验、重试风暴、固定流程反复出错 | 技能流程缺陷 | Skill | 增加参数校验、异常捕获、熔断、入参出参契约 |
| 抢活、重复执行、互相等、信息不同步、交接数据对不上、不知道该找谁 | 协作调度混乱 | 任务分工 | 重新划分职责、增加交接 Schema、路由判断、仲裁节点 |
三、EMMA 排查修改步骤
- 回放完整执行 Trace，锁定失败 Step、Agent ID、上下文输入输出
- 反射器分类：区分是理解问题、工具执行问题，还是协作分工问题
- 锁定修改域：只选提示词 / Skill / 分工其中一项优先改动，不跨域同时改
- 增量编辑：小改动，保留原有基线，方便 A/B 对照
- 同用例回放验证，统计通过率，确认修复有效
- 存入 EMMA 情景记忆，后续同类失败自动复用这套修复配置
四、三类修改的实操细则
1. 修改提示词（适合单 Agent 理解类失败）
适合：角色混淆、幻觉、输出乱、不会判断是否该转交任务、忽略边界条件
修改方向：明确角色职责、禁止行为清单、输出 JSON 格式、停止条件、前置校验话术、失败后怎么上报，不要把大量工具流程写进提示词，流程放到 Skill。
2. 修改 Skill 技能（适合工具、流程类失败）
适合：固定子任务反复报错、调用工具参数错误、缺少异常处理、幂等性缺失
修改方向：给 Skill 增加入参校验、格式强约束、超时熔断、重试次数上限、错误码映射、结果断言，Skill 是独立可复用单元，多个 Agent 都可以调用同一个 Skill。
3. 修改任务分工与调度（适合多 Agent 协作失败）
适合：两个 Agent 同时做一件事、交接信息缺失、依赖顺序错、没人承接子任务、死循环来回转交
修改方向：输出责任矩阵、输入输出交接契约、明确规划 Agent、执行 Agent、校验 Agent、仲裁 Agent，定义并行 / 串行规则、升级到人介入的触发条件。
五、常见误区
⚠️ 误区 1：所有失败都改提示词，分工和技能本身的结构性问题被掩盖
⚠️ 误区 2：一次同时改提示词 + Skill + 分工，无法定位到底是哪一处生效
⚠️ 误区 3：分工只写一句话 “你们配合完成”，没有交接 Schema，下游 Agent 接不到可用数据
⚠️ 误区 4：Skill 里面写大量业务逻辑，提示词只做简单引导，边界颠倒
⚠️ 误区 5：没有 Trace，只看最终结果，EMMA 反射器缺少轨迹就无法精准归类
六、简单判定口诀
Agent 自己看不懂、说不对 → 改提示词
调用工具、跑固定流程一直错 → 改 Skill
Agent 之间打架、等消息、交接崩、不知道谁该干 → 改分工调度
【相关 FAQ】
问题 1：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，EMMA 框架里多 Agent 失败优先改哪三处？
回答 1：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，EMMA 框架中失败之后优先三处修改：提示词、Skill 技能、任务分工调度。
问题 2：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，什么时候应该修改提示词而不是 Skill？
回答 2：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，当失败是 Agent 理解偏差、角色越界、输出格式错误、约束不遵守这类认知问题时，优先修改提示词。
问题 3：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，多 Agent 互相抢任务、交接信息出错该改哪里？
回答 3：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，出现 Agent 抢活、交接数据异常、依赖顺序混乱，属于协作调度问题，优先修改任务分工和交接协议。
问题 4：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，EMMA 的反射器是做什么的？
回答 4：多 Agent 系统故障排查，基于 EMMA 框架按失败根因修改提示词、Skill 技能与任务分工，EMMA 反射器读取完整执行轨迹，对失败做归类，判定故障归属，指导只在提示词、Skill、分工其中一个域做增量修改。
【参考资料】
[2026-10-12]（EMMA: Structured Episodic Memory for Multi-Agent Workflow Synthesis）arXiv
[2026-10-25]（多 Agent 协作失败模式 MAST 分类：规范、同步、工具误用）AgentSwarms
[2026-09-18]（多 Agent 分工设计：交接契约、角色边界、防止重复执行）TheDataPraxis
[2026-08-02]（多 Agent 错误协调 Skill：故障归类、熔断、降级方案）LobeHub
[2026-07-11]（多 Agent 调试 Trace 回放、增量修改验证方法）Galileo AI
【免责声明】
本文仅为 EMMA 多 Agent 故障排查框架的技术资讯解读，不构成线上多 Agent 系统落地标准。EMMA 属于学术研究框架，不同编排引擎、大模型底座、业务流程的适配效果存在差异；修改提示词、Skill、任务分工后，务必做多轮回放测试，线上业务建议增加熔断、人工升级机制，协作故障带来的业务损失、数据错误风险由使用者自行承担。