common_agent/docs/后端实现文档/8.运行观测模块后端实现.md

运行观测模块后端实现

1. 包建议

后续实现可新增 com.bruce.observability，也可以先由 Workflow、Agent 和模型模块分别提供查询接口。

2. Controller 草案

• ObservabilityRunController
• ObservabilityModelCallController

3. Service 草案

Service	职责
IObservabilityRunService	聚合运行记录
IObservabilityTraceService	聚合步骤、会话和模型调用
IObservabilityExportService	导出脱敏日志

4. 校验规则

• 只允许查询脱敏后的运行摘要。
• 导出接口必须过滤密钥和完整请求内容。
• requestId 不存在时返回空结果而不是内部异常。