文档中心

全栈可观测平台

通用 AI 应用监控

Agent 轨迹

Agent 轨迹用于记录并展示 AI Agent 从接收请求到生成响应的完整执行过程。您可以通过该功能查看 Agent 的输入/输出信息、执行步骤、工具调用、模型响应以及耗时和 Token 消耗等关键性能指标，分析 Agent 的决策逻辑，定位推理异常、工具调用失败或响应耗时过长等问题。本文为您详细介绍如何查看目标对话的 Agent 执行轨迹。

背景信息

Step 是 Agent 执行轨迹中的最小执行单元，按执行顺序从 1 开始递增编号。每个步骤对应 Agent 在一次任务中的一次具体操作，例如接收用户输入、调用模型推理或执行工具调用。

前提条件

已经将 LLM 相关应用接入 AI 应用监控，并正常上报观测数据。不同语言的接入方式各不相同，更多详细说明参见：接入方式。

操作步骤

步骤一：查看统计和轨迹筛选

在左侧导航栏选择 Agent 轨迹，前往 Agent 轨迹页面。

Agent 轨迹页面由统计卡片、筛选与查询区域、轨迹列表组成。各筛选项和功能说明如下。

序号	模块	说明
1	工作区	筛选指定工作区中的数据。说明请确保所选工作区与 Agent 服务接入的工作区一致。
2	时间范围	数据筛选的时间范围。支持手动刷新和自动刷新，可根据实际需求配置。按最近筛选：根据当前时间，动态筛选最近时间段内的 Trace 数据，例如：筛选最近 1 小时的数据。指定时间范围：指定时间范围，静态筛选某个时间段内的 Trace 数据，例如：筛选 2025-11-08 00:00:00 到 2025-11-10 00:00:00 时间段内的数据。
3	数据清洗	开启后，系统将对上报的数据进行标准化清洗，以提升数据质量。说明关闭后，系统将不再从新增链路数据中生成 Agent 轨迹，请谨慎操作。
4	输入、输出内容关键字	根据输入或输出内容中的关键词筛选轨迹。
5	统计指标	当前筛选条件下的核心指标，包括 Agent 服务、用户数、平均步骤数、平均 Token 消耗和平均耗时。 Agent 服务：展示当前工作区下活跃的 Agent 服务总数。数值越高，说明当前 Agent 服务的运行规模越大。用户数：展示调用 Agent 的独立用户数量。可用于判断业务活跃度和用户覆盖范围。平均步骤数：展示单个会话中 Agent 平均执行的步骤数。步骤数较高时，可能表示任务链路较长或存在重复推理。平均 Token 消耗：展示单次任务平均消耗的 Token 总量，可用于评估模型调用成本和上下文使用情况。平均耗时：展示从请求发起到推理结束的平均响应时间，可结合步骤数和工具调用情况进一步排查性能瓶颈。
6	管理	单击管理，可自定义筛选面板中展示的筛选字段；也可单击恢复默认，将筛选字段还原成系统默认配置。
7	其他属性筛选	多个轨迹关联信息的筛选项，用于精细化筛选，例如：Agent 服务、Agent 名称、用户 ID、会话 ID、Trace ID、轨迹 ID、模型名称、工具名称、轨迹状态、输入、输出、耗时、模型调用次数、工具调用次数等。说明多个筛选项按“与”逻辑生效，即匹配到所有筛选规则的数据才会被筛选出来。

步骤二：查看轨迹详情

单击目标轨迹，可查看目标轨迹的详细信息。

序号	模块	说明
1	轨迹信息	显示当前轨迹相关详细信息，包括轨迹状态、轨迹 ID、Agent、Trace ID、SESSION ID、开始时间、总耗时、应用数、Span 数、状态码以及当前 Trace 的用户点赞/点踩数等。轨迹 ID：该次执行的唯一标识，与 Trace ID 相同。 Trace ID：链路追踪 ID，用于标识本次请求的完整调用链路。可单击 Trace ID 跳转至 Trace 分析页面查看详情。 SESSION ID：会话 ID，用于关联同一会话中的多条轨迹。可单击 SESSION ID 跳转至会话分析页面查看详情。
2	查看原始 JSON	以 JSON 格式查看完整的结构化元数据并支持一键复制。
3	统计指标	当前轨迹的核心指标，包括执行耗时、步骤、模型调用、工具调用、Token 总量和缓存命中率。执行耗时：当前对话从用户请求发起到最终响应完成的全链路总耗时，可直观反映单次对话的端到端响应效率，是衡量使用体验的核心指标。步骤：展示当前会话中 Agent 完成任务的平均步骤数。步骤数较高时，可能表示任务链路较长或存在重复推理。模型调用：当前对话向大模型发起的推理请求总次数，反映对话中 Agent 的推理轮次与决策复杂度。工具调用：当前对话实际发起的工具调用的总次数，反映对话中工具协作的复杂度与依赖度。 Token 总量：当前轨迹的 Token 总消耗（Token 消耗 = 输入 Token + 输出 Token + 输入缓存 Token），用于衡量对话的资源消耗。缓存命中率：当前对话中，输入 Token 被缓存命中的比例（输入 Token 缓存命中率 = 输入缓存 Token / Token 消耗 *100%），反映对话中上下文复用的效率，衡量缓存策略的有效性。
4	输入、输出	该区域展示本次任务的原始输入内容和 Agent 的最终输出内容，用于判断实际请求和响应是否符合预期。输入：展示 Agent 接收到的指令或上下文内容。内容较长时默认截断显示，单击查看全部可展开查看完整内容。输出：展示 Agent 最终生成的回复内容，单击查看全部可查看完整文本。说明单击查看全部后，弹窗内提供两种查看模式：格式化：以结构化、易读的方式展示内容，适合快速阅读理解。原始数据：以原始文本格式展示，适合复制完整内容或对接技术分析。
5	执行轨迹列表	该区域按时间顺序逐步展示 Agent 从接收指令到生成响应的每一步操作，包括系统初始化、用户输入传递、模型推理和工具调用等完整过程。当任务出现异常或耗时偏长时，可通过该区域逐步定位问题发生的具体步骤。各功能说明如下。关键字搜索：在步骤内容中搜索特定文字，快速定位包含目标信息的步骤。角色筛选：按执行角色过滤步骤。可选值包括 System（系统初始化指令）、User（用户输入内容）和 Agent（模型推理步骤）。性能指标：勾选后，在每个步骤中额外展示该步骤的耗时和 Token 消耗数据，适合排查性能瓶颈。仅看异常：勾选后，仅展示执行状态异常的步骤，用于快速聚焦问题节点。逐级展开：展开所有步骤的详情子面板，适合全量浏览执行过程。逐级收起：收起所有展开的详情子面板，恢复列表紧凑视图。

步骤三：查看轨迹步骤

可在轨迹列表中查看该轨迹的所有步骤，列表参数说明如下。

说明

单击轨迹列表中的任意步骤，可查看该步骤的详细信息。

参数	说明
Step	该步骤的序号，从 1 开始按执行顺序递增，反映 Agent 各操作的先后关系。
角色	该步骤的执行主体，用于区分操作类型。包括：User（用户输入）、Agent（模型推理与响应）、Tool（工具调用）、System（系统初始化指令）。
内容	该步骤的执行内容摘要，默认截断显示。单击查看详情可查看完整内容。
耗时	该步骤单独执行所消耗的时长，是定位性能瓶颈的关键依据。

最近更新时间：2026.10.30 16:22:02

这个页面对您有帮助吗？

有用

无用