动手实战 · 权限与安全概念

Agent 干了什么你知道吗

定义

Agent 可观测性把运行轨迹变成可查询的事件、指标和关联关系，使团队能回答“做了什么、耗时与用量在哪、为什么失败”，而不是只留一段最终日志。

说明

基础事件通常覆盖轮次、模型请求、工具调用、状态变化、错误和用量。事件名称与属性应由产品定义并保持稳定；若接入 OpenTelemetry，再按所采用的语义约定建立映射。

日志是离散记录，可观测性还包括指标、追踪和它们之间的关联。单条日志能说明发生了什么，完整 trace 才能把一次用户任务中的模型、工具和重试串起来。

开发者可据此定位失败和无效循环，产品与成本团队则能分析延迟、成功率和用量分布。采集时仍要做数据最小化、脱敏和访问控制，不能为了排障完整记录敏感输入。

边界与误区

可观测性对开发者和产品经理分别有什么价值： 开发者用它定位调用链和失败原因；产品经理用聚合指标观察成功率、延迟和成本，二者不必读取所有原始内容。
Agent 场景最需要追踪什么： 任务标识、轮次、模型与工具调用、耗时、用量、重试以及最终状态，并确保这些记录可以关联。
可观测性和日志有什么区别： 日志是证据的一种；可观测性还依赖指标、追踪、关联 ID 和查询能力，用多种信号解释系统状态。