AI Agent 工程 · 13
13.1 Observability：追踪一次客服任务
用请求 ID、日志、链路和指标定位客服工具调用的失败位置。
目标与流程
可观测性把 Logging（事件记录）、Tracing（一次请求的关联链路）与 Metrics（聚合指标）分开。没有它，客服只知道“失败”，不知道失败在身份验证、订单工具还是工单接口。
requestId → 身份校验 → 工具调用 → 建工单 → 响应
每步记录事件、状态和耗时，不记录密钥/完整 PII
实践与验收
V5 为模拟 API 写入 requestId、事件和工单 ID，并断言 trace 没有 apiKey 字段。它没有模型调用，故不报告 token 成本。验收：超时会保留可关联的失败事件；排查时先按 requestId 聚合，而不是打印客户全部资料。
主动回忆：日志为什么不能成为“把所有输入都保存下来”的借口？
- 必须记：trace 关联步骤，metric 看趋势。
- 建议记：日志字段应分级、脱敏并设保留期。
- 不用记：示例 request ID。