P
建议先明确审计目标:是用于故障回放、合规留痕,还是安全追责。不同目标决定日志粒度和保存周期。故障回放需要完整输入输出与中间状态;合规审计更关注谁在什么权限下触发了什么副作用;安全追责则要防止日志被运行进程或模型自身改写。前提假设是工具调用经过统一网关或适配层,而不是 Agent 直接连接各个业务系统;如果调用路径分散,第一步应先收口,否则关联 ID 很难可靠传递。
最小事件模型建议包含 trace_id、task_id、session_id、agent_version、prompt 或策略版本、tool_name、tool_version、调用方身份、授权范围、参数摘要、幂等键、开始结束时间、重试次数、结果状态、错误码、业务单据号。敏感字段不要原样落盘,可在入口做字段级脱敏或令牌化,同时保留哈希用于排查。参数和响应体建议单独存对象存储,审计表只保存引用地址、大小和校验值,避免主审计表被大 JSON 拖慢。
链路关联上,trace_id 应在用户请求进入时生成,并贯穿规划、工具调用、回调、异步任务和补偿操作;每次工具调用再生成独立 span_id,重试复用同一个业务调用 ID,但新增 attempt 序号。对于异步工具,不能只记录发起成功,还要记录回调、状态查询和最终业务状态,否则超时场景无法判断操作是否实际生效。若存在消息队列,生产、消费、死信都应带同一 trace_id,并记录队列消息 ID。
防篡改要分清边界。应用本地日志适合排查,不适合作为唯一可信证据;高风险操作可增加只追加存储、对象锁、签名摘要或外部审计投递。运行期 Agent 不应拥有删除审计记录的权限,写日志的身份与执行业务操作的身份分离。还要注意审计失败策略:普通查询可降级并告警,支付、删除、权限变更等高风险工具应配置为审计写入失败则拒绝执行或进入人工审核,不能默认放行。
排查时可按四步走:先确认入口是否生成并透传 trace_id;再检查统一工具层是否记录了标准化事件;接着核对异步回调和重试是否保持同一业务关联;最后验证日志权限、脱敏和完整性校验。常见缺口是只记录模型输出的工具调用文本,没有记录实际 HTTP/RPC 请求;或者重试生成新 ID,导致一次逻辑动作被误判成多次独立操作。AI 生成技术讨论,请结合权威文档核实。
最小事件模型建议包含 trace_id、task_id、session_id、agent_version、prompt 或策略版本、tool_name、tool_version、调用方身份、授权范围、参数摘要、幂等键、开始结束时间、重试次数、结果状态、错误码、业务单据号。敏感字段不要原样落盘,可在入口做字段级脱敏或令牌化,同时保留哈希用于排查。参数和响应体建议单独存对象存储,审计表只保存引用地址、大小和校验值,避免主审计表被大 JSON 拖慢。
链路关联上,trace_id 应在用户请求进入时生成,并贯穿规划、工具调用、回调、异步任务和补偿操作;每次工具调用再生成独立 span_id,重试复用同一个业务调用 ID,但新增 attempt 序号。对于异步工具,不能只记录发起成功,还要记录回调、状态查询和最终业务状态,否则超时场景无法判断操作是否实际生效。若存在消息队列,生产、消费、死信都应带同一 trace_id,并记录队列消息 ID。
防篡改要分清边界。应用本地日志适合排查,不适合作为唯一可信证据;高风险操作可增加只追加存储、对象锁、签名摘要或外部审计投递。运行期 Agent 不应拥有删除审计记录的权限,写日志的身份与执行业务操作的身份分离。还要注意审计失败策略:普通查询可降级并告警,支付、删除、权限变更等高风险工具应配置为审计写入失败则拒绝执行或进入人工审核,不能默认放行。
排查时可按四步走:先确认入口是否生成并透传 trace_id;再检查统一工具层是否记录了标准化事件;接着核对异步回调和重试是否保持同一业务关联;最后验证日志权限、脱敏和完整性校验。常见缺口是只记录模型输出的工具调用文本,没有记录实际 HTTP/RPC 请求;或者重试生成新 ID,导致一次逻辑动作被误判成多次独立操作。AI 生成技术讨论,请结合权威文档核实。