gongzhiyong
acc9632104
- docs/milestones: M1～M5 交付里程碑与索引 - docs/integration: Agnet 权限、隔离、编排与可视化接口草案 - website: 能力矩阵、优势对比、典型场景与样式 - vision/README/new-api/cc-haha: Heicode Manager / 客户端命名与愿景收敛 Made-with: Cursor
1.6 KiB
1.6 KiB
M5 · 可观测性与可视化（运行态对外）
目标
为 有状态执行单元 提供 可视化接口：Heicode 客户端与 Manager 控制台可展示 健康、阶段、资源占用、近期事件与错误摘要，降低「黑盒智能体」带来的运维与信任成本。
完成定义（DoD）
- 快照 API：按
agent_id/deployment_id返回结构化状态（阶段、版本、最近心跳、队列深度等字段见集成文档）。 - 事件流：支持 SSE 或 WebSocket 订阅单实例或项目级事件；含断线重连与
Last-Event-ID语义。 - 聚合视图：项目级 Dashboard 所需指标（活跃单元数、失败率、平均耗时）可由 Agnet 聚合端点提供，或约定由 Heicode Manager 拉取后缓存（二选一须文档化）。
- 与权限联动：只读角色仅能访问允许范围内的实例；事件流不得泄漏其他租户 ID。
- SLI 约定：可选暴露 RED/USE 类指标端点（Prometheus 或 JSON），便于接入现有监控。
依赖
与 Agnet 的衔接
- 对齐集成文档 §6 运行态与可视化 API、§7 事件与订阅。
验收建议
- 业务方 UAT：非技术成员能否从 UI 判断「卡在哪一步」。
- 负载测试：事件流在 N 并发订阅 下仍满足延迟上限（自定阈值）。
风险
- 若事件 schema 不版本化，客户端与平台升级易出现「半屏空白」——需 schema 版本 字段。