轨迹分析概述

轨迹分析是AgentArts智能体调优体系中的问题诊断入口。它通过自动化采样与分析Agent运行过程中产生的会话轨迹（Trace），帮助开发者快速定位Agent在真实业务场景下的运行瓶颈。

在过去，当Agent回答错误或执行中断时，开发者需要人工翻阅成百上千条日志抓包，逐一排查。轨迹分析将这一过程自动化与智能化，提供以下分析方向：

失效分析：

对Agent会话进行根因归因，识别导致Agent输出不正确或任务未能完成的原因。系统会自动将失效会话归类为若干故障类别（如“智能体决策与推理失效”、“工具执行失败”等），并针对每类故障归纳具体的根本原因，精确定位到受影响的会话和执行步骤（Span）级别。

适合场景：Agent经常给出错误结果、任务频繁中断或未能完成，但不清楚根因时。

单智能体

在AgentArts平台上创建的单智能体，系统默认开启Trace数据的自动上报。智能体通过API调用后，平台会自动采集完整的执行链路数据，无需开发者进行额外配置，可直接作为轨迹分析的数据来源。

当前暂不支持采集控制台预览调试产生的Trace数据，仅支持通过API调用产生的数据。

第三方托管

第三方托管是指在AgentArts平台以外独立开发和运行的智能体，通过对接AgentArts观测OpenAPI的方式将Trace、Metric、Log等数据上报至平台，从而纳入平台的统一观测和分析体系。

适合已有独立Agent基础设施、希望借助AgentArts的轨迹分析能力持续改进Agent表现的场景。

如需了解第三方智能体数据上报的配置方法，请参考上报第三方智能体 Trace、Metric、Log 数据。

无论哪种类型的智能体，轨迹分析均依赖会话Trace数据。在创建轨迹分析任务前，请确保目标智能体已在指定时间范围内产生了足够量的Trace数据，否则分析结果的覆盖度和准确性将受到影响。可在AgentArts平台“观测与优化 > 观测”功能中查看。