关系诊断

Topology

Topology 当前是一个只读关系视图。它来自 agent metadata 和 allowed-subagent 配置,而不是来自真实调用量或延迟 trace。

/topology

概述#

当前的 Topology 页面用于帮助操作员理解哪些 Agent 在配置上存在关系,适合做结构检查、发现孤立 Agent,并进入单个节点的侧边面板继续排查。

它不是 trace graph、session replay,也不是 flow analytics 页面。这里出现一条边,只表示关系是从配置和 metadata 推导出来的,不表示这些 Agent 最近真的互相调用过。

前置条件#

前置条件
  • 至少已经同步过一个 connector 或 runtime-backed agent,保证页面能读取到当前 metadata
  • 可访问 `/topology` 对应的 Web 页面

使用反馈#

页面加载后,你应该看到:

  • -基于同一份关系数据的 graph view 和 table view
  • -在能够推导出边时,与连接图分开的 standalone agents 区域
  • -节点侧边面板,展示 external ID、model、tool profile、allowed subagents 和 workspace file 提示

Web 端操作#

请把这个页面当成结构诊断页,而不是观测分析仪表盘。

Graph View

图形视图把 Agent 按配置推导出的关系排布成一张关系图。点击节点即可查看详情。边有方向,但不代表流量、延迟或调用次数。

Table View

当你需要更快地盘点时切换到表格视图。它会展示 agent name、external ID、health、primary model、allowed subagent 数量和 tool 数量,而不用在图上逐个点选。

Side Panel

这个页面最有价值的运维面其实是侧边面板。用它来核对驱动关系图的具体 metadata,并判断某个 Agent 是否本来就应该是孤立节点。

常见问题#

问:为什么我的 Agent 之间没有连线?
答:页面只会渲染它能从当前 metadata 推导出的关系。如果没有 allowed-subagent 链接,这些 Agent 就会显示为 standalone,即使它们可能通过其他机制协作。
问:这个页面能证明某个 Agent 真的调用过另一个 Agent 吗?
答:不能。这个页面是 configuration-derived 的结构视图,适合做关系诊断,但不能证明真实流量或运行时因果链。
问:那应该去哪里看真实活动和证据?
答:去 Sessions、Activity、Audit 和 Evidence。这些页面更接近真实运行数据;Topology 负责的是结构层视角。
拓扑图 — ClawButler 用户手册