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