# 创建轨迹分析任务
在对智能体进行故障排查与质量治理前，您需要先创建一个轨迹分析任务。您可以针对指定的智能体对象（支持单智能体、第三方托管智能体），选择所需的分析方向（失效分析），并配置灵活的Trace采样策略与执行周期。
任务创建并提交后，平台将自动调取Trace数据进行后台分析，并生成精细至Span级别的诊断报告。
支持进行轨迹分析的智能体类型，请参考[支持的优化对象（智能体类型）](https://support.huaweicloud.com/ops-agentarts/agentarts_14_0145.html#agentarts_14_0145__section51761835171618)。
#### 操作步骤
1. 填写轨迹分析任务基础信息。 
   在AgentArts左侧导航栏中选择"观测与优化 \> 优化"，在"轨迹分析"页签单击"创建轨迹分析"。
   填写任务名称、描述。
   
   
2. 选择分析方向。 
   当前支持"失效分析"，该模式会对Agent会话进行根因归因，识别导致Agent输出不正确或任务未能完成的原因。
   支持添加标签，标签用于对轨迹分析任务进行自定义标记和分类管理。每个标签包含一个"键"和一个"值"，可按需添加。
   图1创建轨迹分析任务   
   ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002761817875.png "点击放大")
   
   
3. 配置优化对象。 
   单击"选择优化对象"，在弹出的选择器中选择需要分析智能体。轨迹分析支持以下类型的智能体，请根据您的Agent构建方式选择对应类型：
   表1智能体类型 
   | 类型     | 适用范围                                       | Trace上报方式 |
   |:---|:---|:---|
   | 单智能体 | 在AgentArts平台通过低代码方式创建的单智能体。              | 平台自动上报      |
   | 第三方托管 | 在AgentArts平台以外独立运行，通过观测OpenAPI上报数据的智能体。 | 需手动对接上报    |
      
   ![](https://support.huaweicloud.com/ops-agentarts/public_sys-resources/note_3.0-zh-cn.png)
   - 轨迹分析依赖历史会话Trace数据。创建任务前，请确保目标智能体在指定时间范围内已产生足够量的Trace数据，否则分析结果的覆盖度和准确性将受到影响。您可在AgentArts平台"观测与优化 \> 观测"功能中查看已上报的Trace数据。
   
   - 单智能体当前仅支持采集通过API调用产生的Trace数据，暂不支持控制台预览调试产生的数据。
    
   
   
4. 选择委托。 
   在"委托"下拉框中选择已创建的IAM信任委托，用于授权平台访问该Agent的Trace数据。如未创建，单击"前往创建"跳转至IAM平台完成创建后返回。
   创建委托时各参数要求如下：
   - 委托名称：由用户自定义
   
   - 信任主体类型：选择"云服务"
   
   - 云服务：填写"智果Agent优化"
   
   - 其他参数：使用默认配置
   
   
   委托创建完成后，按照页面提示进行授权，授权项选择"AgentArtsRLAnalysisTaskAgencyPolicy"。
   
   
5. 配置执行周期与数据采样信息。 
   根据使用场景选择执行方式：
   - 单次执行：设置一个时间范围，系统从该时间段内的Trace中采样进行分析，适合临时诊断。
   
   - 重复执行：设置周期性自动运行计划，适合需要持续监控Agent健康状态的场景。
   
   
   单击"添加筛选条件"，可按特定属性过滤目标Trace，将分析范围缩小到您关注的会话子集。例如，仅分析特定用户群或特定业务流程的会话。
   设置数据采样比例、采样数据上限。首次分析可使用默认值；若数据量较少，可适当提高比例。
   图2配置优化对象与执行周期   
   ![](https://support.huaweicloud.com/ops-agentarts/zh-cn_image_0000002732281648.png "点击放大")
   
   
6. 确认所有配置无误后，单击"保存并运行"，任务开始运行。 
   您可在轨迹分析任务列表中查看任务的运行状态。