Agent Observatory：Claude Code 多智能体工作流的实时可观测性工具

Agent Observatory是专为Claude Code多智能体工作流设计的实时可观测性工具，旨在解决复杂多智能体系统中的调用追踪、执行时间分析、成本核算等挑战。其核心价值在于通过无侵入式集成方案，提供调用树可视化、时间线追踪、成本估算等功能，帮助开发者实现AI工作流的透明化监控与优化。

随着Claude Code的Agent工具能力增强，开发者构建的多智能体工作流（主智能体协调多个子智能体并行/串行执行任务）面临三大挑战：智能体间调用关系难以追踪、执行时间分析困难、成本核算缺乏有效手段。Agent Observatory正是为应对这些问题而生。

Agent Observatory采用零代码改动的轻量级架构：

1. 钩子脚本：hook.py.py通过Claude Code的PreToolUse和PostToolUse钩子接收事件，通过Python标准库将JSON事件POST到服务端
2. 服务端：基于FastAPI+SQLite，负责事件持久化与SSE流推送
3. 前端：使用D3.js实现数据可视化 优势包括零依赖侵入、实时性（SSE秒级更新）、数据持久化（SQLite存储）、团队共享支持。

Agent Observatory提供五个互补的可视化视图：

• 调用树：D3.js层次化图形，展示智能体派生关系，节点按状态（运行中/已完成/中断）着色，悬停查看提示词预览
• 时间线：甘特图形式呈现执行时间与嵌套层级，实时NOW标记线识别性能瓶颈
• 流程图：展示智能体波次连接关系（实线派生/虚线上下文流），理解数据依赖
• 日志：CLI风格终端视图，记录事件并支持展开完整提示词与响应
• 聊天板：去中心化协作机制，智能体可读取共享消息板并自主回复

成本估算

基于提示词/响应文本长度（约4字符=1令牌），采用Claude Sonnet 4.6定价模型（输入$3/1M令牌，输出$15/1M令牌），支持修改常量调整模型。

智能体身份系统

命名智能体分配独特Unicode符号（如architecture-reviewer为⬡），未命名智能体生成趣味名称（如Jazzy Blobfish）与物种emoji。

团队共享模式

• 个人本地模式：本地运行服务器监控个人会话
• 团队共享模式：共享服务器部署，成员通过环境变量AGENT_OBSERVER_URL指向服务器

深度集成

点击调用树节点，详情面板提供“在Claude Code中继续”按钮，复制包含原始提示词、响应内容、父/子智能体信息的结构化跟进提示词到剪贴板，实现监控与开发无缝衔接。

局限

• 成本估算基于字符数近似，与实际令牌数存在偏差
• 聊天板功能的智能体自主参与度依赖提示词设计

未来方向

• 扩展至更多AI助手平台
• 更精确的成本估算模型
• 历史趋势分析与性能基准
• 智能体协作模式自动优化建议

总结

Agent Observatory填补了Claude Code多智能体工作流可观测性的空白，通过无侵入式架构、丰富可视化视图与实用功能，为开发者提供理解和优化复杂AI系统的有力工具，是多智能体应用团队值得尝试的开源项目。