多代理执行过程可用序列图呈现消息与并行分支
要解决的问题
一个任务由多个代理和外部服务协作完成时,聊天式日志只能按时间堆叠,看不出谁在调用谁、哪些步骤并行、失败在哪一步重试。用户想知道“卡在哪里”时只能逐条翻。
规则和其他情况说明
- 核心规则:把参与者(用户、主代理、子代理、GitHub、Vercel 等)排成顶部的列,每条消息或调用画成两列之间的箭头,纵轴是时间。
- 结构块:并行步骤用
PAR框包住,重试用RETRY框包住,失败消息以红色标出,嵌套关系一眼可见。 - 随执行增长:图从上往下实时追加,顶部状态行同步显示“几个在运行”、消息数和已用时间。
- 点开看细节:点击任一箭头,弹出卡片显示发送方 → 接收方、调用内容(参数 JSON)、发送时间与耗时。
关键截图与效果

- 页面或任务场景:任务“Fix the checkout crash”,参与者为 You、Lead、Researcher、Coder、GitHub、Vercel。
- 具体观察:Lead 先给出 “Plan: find, patch, preview”;
PAR框内 Researcher 调用search_code("emptyCart")得到 “3 matches”,同时 Coder 准备分支;之后RETRY框中deploy_preview()先 “Build failed” 再 “Preview ready”,最后 “PR #482 opened”。左侧时间刻度从 0:00 到 1:10,右上显示 “1 working · 14 messages · 1:10”(直接观察)。视频中点开消息会显示 “Coder → Lead”、内容、“Sent 0:08 · Took 5s”。 - 支持的结论:序列图把“谁对谁、并行还是串行、哪里重试”同时放到一屏,适合解释多代理任务的执行过程。
适用场景
- 多代理编排、工具调用较多的代理任务的执行详情页或调试视图。
- 需要回放任务过程、定位失败步骤的场景。
不适用场景
- 单代理、少量步骤的任务,普通活动列表更轻。
- 参与者超过六七列时,横向空间不足,需要折叠或分组。
复核清单
- 并行与重试是否用框而不是只靠颜色表示。
- 失败步骤是否有颜色以外的标记(图标或文字)。
- 长任务是否能收起已完成的部分,并跳到当前执行位置。
- 相关模式:多步代理任务应先展示计划。