common_agent/docs/设计文档/8.运行观测模块设计.md

运行观测模块设计

1. 观测主键

运行观测以 request_id 为主线串联：

• Workflow 运行。
• Workflow 步骤。
• Agent 会话。
• 模型调用日志。

2. 展示维度

• 名称。
• 类型。
• 状态。
• 延迟。
• 成本。
• 步骤输出。
• 错误摘要。

3. 数据来源

来源	表
流程运行	workflow_run
步骤日志	workflow_run_step
模型调用	model_call_log
Agent 会话	agent_session、agent_message

4. 设计约束

• 观测模块只读业务运行数据。
• 不保存完整 Prompt 或敏感密钥。
• 错误信息只保存摘要，详细日志由运行环境负责。