多代理执行过程可用序列图呈现消息与并行分支

  • Agent
  • 数据可视化
  • 时间线
来源
x.com
收录日期
状态
规约中
多代理执行过程可用序列图呈现消息与并行分支 规则实证样本

多代理执行过程可用序列图呈现消息与并行分支

要解决的问题

一个任务由多个代理和外部服务协作完成时,聊天式日志只能按时间堆叠,看不出谁在调用谁、哪些步骤并行、失败在哪一步重试。用户想知道“卡在哪里”时只能逐条翻。

规则和其他情况说明

  • 核心规则:把参与者(用户、主代理、子代理、GitHub、Vercel 等)排成顶部的列,每条消息或调用画成两列之间的箭头,纵轴是时间。
  • 结构块:并行步骤用 PAR 框包住,重试用 RETRY 框包住,失败消息以红色标出,嵌套关系一眼可见。
  • 随执行增长:图从上往下实时追加,顶部状态行同步显示“几个在运行”、消息数和已用时间。
  • 点开看细节:点击任一箭头,弹出卡片显示发送方 → 接收方、调用内容(参数 JSON)、发送时间与耗时。

关键截图与效果

flohoeller-代理序列图-20261115.jpg

  • 页面或任务场景:任务“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”。
  • 支持的结论:序列图把“谁对谁、并行还是串行、哪里重试”同时放到一屏,适合解释多代理任务的执行过程。

适用场景

  • 多代理编排、工具调用较多的代理任务的执行详情页或调试视图。
  • 需要回放任务过程、定位失败步骤的场景。

不适用场景

  • 单代理、少量步骤的任务,普通活动列表更轻。
  • 参与者超过六七列时,横向空间不足,需要折叠或分组。

复核清单

  • 并行与重试是否用框而不是只靠颜色表示。
  • 失败步骤是否有颜色以外的标记(图标或文字)。
  • 长任务是否能收起已完成的部分,并跳到当前执行位置。
  • 相关模式:多步代理任务应先展示计划。