Agent 轨迹

Agent 轨迹 Schema 如何保留任务证据

一条有用的 Agent 轨迹应能还原当时可见的信息执行的动作以及动作后的变化仅保存对话文本仍不够还需要把操作观察与产物关联到稳定的标识

Efflora·2026 年 9 月 18 日·技术指南

区分任务与执行实例

同一任务可能由不同 Agent 配置重复执行为任务设置稳定的版本标识为每次尝试分配独立执行标识并明确续跑与重试关系避免把恢复后的结果误当作独立成功

Harbor 提供 ATIF 作为 Agent 轨迹交换格式对接现有执行器时应先检查实际格式与版本下方为自拟审核字段建议并非 ATIF 标准定义

参考来源 · Harbor · ATIF

让每个事件都能定位证据

对于大尺寸截图日志和生成文件可使用引用而非全部嵌入事件正文引用应能在交付包中解析同时保存原始产物校验信息以区分后续标准化处理和最初记录

字段组	用途
任务与环境版本	定位准确的初始条件
执行与父执行标识	关联重试与续跑
步骤与工具调用标识	将每个动作与响应配对
观察与产物引用	定位当时的可见信息与结果
结论与验证器版本	说明最终状态如何被判定

一条合成事件示例

以下自拟示例展示工具结果与先前调用的关联未经过执行不含客户数据正式 Schema 还需定义时间戳编码规则及工具错误的表达方式

{
  "data_origin": "synthetic_website_demo",
  "execution_status": "illustrative_not_executed",
  "run_id": "demo-run-01",
  "step_id": "step-03",
  "tool_call_id": "call-02",
  "event_type": "tool_result",
  "evidence_ref": "artifacts/check-output.txt"
}

除了格式还要检查关联关系

文件可以正常解析却仍然引用不存在的证据检查工具响应是否有对应调用证据引用是否有效同时识别重复步骤标识与未解释的序列缺口区分内容为空和从未采集这两种状态

记录删除过的字段与删除原因工具输出脱敏后应保留事件标识并标注边界接收方才能判断剩余轨迹是否仍适合目标训练或评测用途