Agent 轨迹将已接入的 Trace 加工为 ATIF 标准的结构化执行记录，帮助您浏览 Agent 的输入、输出、模型调用、工具调用和完整执行步骤，并将有价值的轨迹加入数据集，用于后续评估、训练和迭代优化。本文介绍如何开启轨迹采集、筛选轨迹、查看详情和加入数据集。
什么是 Agent 轨迹
Agent 轨迹是链路 Trace 数据根据 ATIF 标准生成的 JSON 规划的结构化数据。ATIF 标准全称为Agent Trajectory Interchange Format（智能体轨迹交互格式）。在 ATIF 规范中，轨迹被定义为用户与智能体之间的一系列交互过程，涵盖了智能体的内部推理、执行动作及环境观测信息。该轨迹记录了完整的交互历史，包括所有用户消息（初始消息及后续消息）、智能体响应、工具执行情况以及环境反馈。
因此，Agent 轨迹有以下优点：
AI 原生可读：标准化 JSON Schema 直接建模 agent loop，AI 无需拼接 span 即可解析完整决策链路。
评估零拼接：Step 级输入输出与 Trajectory 级聚合指标一体记录，评估分析开箱即用。
去除冗余信息：Agent 轨迹只保留了OpenTelemetry 标准的Trace 中的Agent 行为信息，去除了Agent 的基础设施数据（例如主机、操作系统、进程、容器、Kubernetes、部署环境等），减少了冗余信息对评估的影响和Token的消耗。
会话、Trace、Agent 轨迹的关系
会话（Session）→ 链路 Trace → Agent 轨迹（Agent Trajectory）三者逐层展开，关系为 1:N:N。
会话（Session）：用户与 Agent 应用的一次完整交互过程，包含多轮对话。
Trace：会话中的一轮交互，即用户一次输入到系统给出最终输出的完整链路。一条 Trace 记录了这一轮输入输出的所有调用详情，包含主子Agent的所有调用明细、耗时等，是链路追踪的基本单元。
Agent 轨迹（Agent Trajectory）：单个 Agent 实例在处理该轮请求时的完整执行过程，包括模型调用、思考过程（Reasoning）、工具调用（Tool Call）、输入输出内容与 Token 消耗等明细。
层级关系说明
三者呈逐层展开的包含关系，具体基数关系如下：
会话（Session） → 链路（Trace）：1:N
一个完整的会话包含多轮交互，因此对应多条 Trace。链路（Trace） → Agent 轨迹（Agent Trajectory）：1:1
一条 Trace（一轮交互）在清洗后，对应生成一条完整的 Agent 轨迹 JSON 数据。
注意：如果该轮交互涉及主子 Agent 调用，子 Agent 的执行明细将作为嵌套结构包含在这条唯一的 Agent 轨迹 JSON 数据中，而不会拆分为多条独立的轨迹记录。
开启或关闭轨迹采集
创建 AgentSpace 时开启
新建 AgentSpace 时，Agent 轨迹默认勾选。保留勾选并创建空间后，系统会开启该空间的轨迹采集；如暂不需要，可在创建前取消勾选。
为已有 AgentSpace 开启
登录 AgentLoop 控制台，选择目标 AgentSpace。
在左侧导航栏选择数据中心，然后选择Agent 轨迹。
根据页面状态执行操作：
尚未初始化轨迹存储时，单击开启轨迹清洗，然后在确认对话框中单击确认开启。
轨迹采集已关闭时，单击开启轨迹采集，然后确认开启。
页面提示尚未接入观测数据时，单击前往接入数据，完成数据接入后再返回本页面。
说明：开启轨迹采集可能产生轨迹清洗相关费用。
关闭或开启轨迹采集
在Agent 轨迹页面右上角，单击关闭轨迹采集或开启轨迹采集，并在确认对话框中确认操作。
关闭后，系统立即停止将新 Trace 加工为 Agent 轨迹，已有历史轨迹会保留。再次开启后，系统从新的时间点开始清洗，只处理该时间点之后产生的 Trace，不会延续关闭前的清洗进度，也不会补清洗关闭期间产生的数据。
浏览和筛选轨迹
在目标 AgentSpace 中，选择数据中心 > Agent 轨迹。
在页面右上角设置要查看的时间范围。
单击筛选框或快捷筛选，按需设置一个或多个条件。
筛选条件
说明
Agent 应用
选择一个或多个 Agent 应用。
模型
选择轨迹中调用的模型。
工具调用
选择轨迹中调用的工具。
Steps
按步骤数大于、小于、等于或区间筛选。
耗时
按耗时大于、小于、等于或区间筛选，支持秒和分钟。
TraceID
输入 TraceID 进行精确匹配。
SessionID
输入 SessionID 进行精确匹配。
输入、输出
选择语义搜索或关键字匹配，搜索轨迹的输入或输出内容。
单击搜索。已生效的条件显示在筛选框中，可逐个移除；如需清除全部条件，单击重置或清空全部。
在列表中查看结果。各列说明如下。
列
说明
输入、输出
本次 Agent 执行的主要输入和最终输出。
Agent
Agent 应用或 Agent 名称。
Tokens
本条轨迹消耗的 Token 总数。
耗时
本条轨迹从开始到结束的总耗时。
Steps
轨迹包含的步骤数。
模型调用
调用的模型及调用次数。
工具调用
调用的工具及调用次数。
开始时间
本条轨迹的开始时间。
Trajectory
ATIF 轨迹内容的预览。
单击模型或工具名称，可将该值快速添加到查询条件。单击任意轨迹所在行，可进入轨迹详情页。
查看轨迹详情
轨迹详情页从整体指标、执行步骤和基础信息三个层面展示一条 Agent 轨迹。
查看整体指标
页面顶部展示以下统计卡片：
Steps：总步骤数，以及 system、user 和 agent 各角色的步骤数。
工具调用：工具调用总数，以及成功和失败的调用数。
Tokens：Token 总数，以及输入和输出 Token 数。
耗时：总耗时和执行起止时间。
模型：轨迹使用的主要模型。
查看执行步骤
在执行步骤区域，可以：
按关键字搜索步骤。
查看每个步骤的角色、时间、内容、模型调用、工具调用、Tokens 和耗时。
单击步骤展开完整内容。轨迹包含相应数据时，还可查看推理过程、工具调用入参与执行结果，以及关联的子 Agent 轨迹。
使用展开全部或收起全部统一控制步骤详情。
查看输入、输出和基础信息
页面右侧提供以下信息：
输入、输出：切换页签查看本次执行的完整输入和输出。
基础信息：查看并复制会话 ID、轨迹 ID，查看 ATIF 版本。
Agent 信息：查看 Agent 名称、版本、模型和工具定义。
查看轨迹 JSON
单击页面右上角的查看轨迹 JSON，可以查看完整 ATIF JSON，并在 JSON 面板中搜索、折叠或复制内容。
将轨迹加入数据集
您可以从轨迹列表批量加入，也可以在详情页加入当前轨迹。
从轨迹列表加入
在轨迹列表中勾选一条或多条轨迹；如需处理当前筛选范围内的全部结果，单击选择全部。
单击页面底部的加入数据集。
选择新建数据集或写入已有数据集，并按页面提示选择字段或完成字段映射。
确认写入。
数据量较大时，系统会创建后台导入任务。可按页面提示前往任务列表查看进度。
从轨迹详情加入
在轨迹详情页右上角单击加入数据集。
选择目标数据集和需要写入的字段，然后确认写入。
常见问题
关闭采集后，历史轨迹是否会被删除
不会。关闭采集只会停止生成新的 Agent 轨迹，已有历史轨迹会保留。再次开启时，系统从新的时间点开始清洗，不会补清洗关闭期间产生的数据。