SuperAPI AI 工具集

agentobservability

智能体与模型

查看项目

更新于 10-16 00:04

技能介绍

用途:为多智能体 Claude Code 会话提供实时可观测性仪表盘,用于监控智能体活动、调试多智能体工作流、跟踪并行子智能体执行、可视化工具使用模式并实时分析会话流程。

主要能力:以泳道形式展示多个智能体(如 kai、designer、engineer 等)并行运行;按时间顺序展示事件时间线;提供工具使用图表;跟踪单个会话及其生命周期;支持按智能体名称、事件类型、会话 ID 过滤,并可搜索事件负载。捕获的事件类型包括 SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SubagentStop、SessionEnd。事件以 JSONL 格式存储于 ~/.claude/history/raw-outputs/YYYY-MM/YYYY-MM-DD_all-events.jsonl,服务端在内存中保留最近 1000 条事件,通过 WebSocket 实时推送,无数据库开销。

使用方式:前置条件为安装 Bun 运行时、配置 Claude Code hooks、设置 PAI_DIR 环境变量。安装步骤包括设置 export PAI_DIR="$HOME/.claude"、合并 settings.json.example 中的 hooks 配置、执行 mkdir -p ~/.claude/history/raw-outputs、在 apps/server 与 apps/client 分别执行 bun install。启动时在两个终端分别运行 bun run dev(服务端与客户端),浏览器打开 http://localhost:5173。之后在 Claude Code 中使用任意工具或通过 Task 工具启动子智能体,事件会实时出现在仪表盘。

适用场景:需要观察多智能体协作过程、排查工具调用问题、分析会话流程的开发者。

限制:依赖 Bun 运行时与 hooks 配置;服务端默认端口 3001,客户端 5173;采用文件系统事件捕获与内存流式传输,非数据库持久化;历史数据持久化、导出、告警、会话回放等为待改进方向,暂未提供。部分安装路径示例为作者本地路径,需按实际环境调整。