# 轨迹分析概述
轨迹分析是AgentArts智能体调优体系中的问题诊断入口。它通过自动化采样与分析Agent运行过程中产生的会话轨迹（Trace），帮助开发者快速定位Agent在真实业务场景下的运行瓶颈。
在过去，当Agent回答错误或执行中断时，开发者需要人工翻阅成百上千条日志抓包，逐一排查。轨迹分析将这一过程自动化与智能化，提供以下分析方向：
**失效分析：**
对Agent会话进行根因归因，识别导致Agent输出不正确或任务未能完成的原因。系统会自动将失效会话归类为若干故障类别（如"智能体决策与推理失效"、"工具执行失败"等），并针对每类故障归纳具体的根本原因，精确定位到受影响的会话和执行步骤（Span）级别。
适合场景：Agent经常给出错误结果、任务频繁中断或未能完成，但不清楚根因时。
 #### 支持的优化对象（智能体类型）
轨迹分析支持对以下类型的智能体进行分析：
表1轨迹分析支持的优化对象 
| 类型    | 说明                                           | Trace数据来源            |
|:---|:---|:---|
| 单智能体 | 在AgentArts平台通过低代码方式创建的单智能体应用                   | 平台自动采集并上报，无需额外配置       |
| 第三方托管 | 在AgentArts平台以外开发和运行、通过观测OpenAPI上报Trace数据的第三方智能体 | 手动对接AgentArts观测功能后上报 |
   
**单智能体**
在AgentArts平台上创建的单智能体，系统默认开启Trace数据的自动上报。智能体通过API调用后，平台会自动采集完整的执行链路数据，无需开发者进行额外配置，可直接作为轨迹分析的数据来源。
![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/note_3.0-zh-cn.png)
当前暂不支持采集控制台预览调试产生的Trace数据，仅支持通过API调用产生的数据。
**第三方托管**
第三方托管是指在AgentArts平台以外独立开发和运行的智能体，通过对接AgentArts观测OpenAPI的方式将Trace、Metric、Log等数据上报至平台，从而纳入平台的统一观测和分析体系。
适合已有独立Agent基础设施、希望借助AgentArts的轨迹分析能力持续改进Agent表现的场景。
如需了解第三方智能体数据上报的配置方法，请参考[上报第三方智能体 Trace、Metric、Log 数据](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0008.html)。
![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/note_3.0-zh-cn.png)
无论哪种类型的智能体，轨迹分析均依赖会话Trace数据。在创建轨迹分析任务前，请确保目标智能体已在指定时间范围内产生了足够量的Trace数据，否则分析结果的覆盖度和准确性将受到影响。可在AgentArts平台"观测与优化 \> 观测"功能中查看。