更新时间:2026-09-16 GMT+08:00
分享

创建Skill优化任务

当您确认Agent的任务执行异常,且根因在于Skill文档描述不够完整或准确时,可以创建一个Skill优化任务。

任务创建并提交后,平台将自动从该Agent的历史执行轨迹中提取与所选Skill相关的数据,批量分析执行过程中暴露的共性问题,并生成优化后的Skill文档,包括补充后的执行步骤、完善后的准入条件和边界处理逻辑等,供您参考。

除手动创建外,工具优化任务也可由轨迹分析的功能自动创建。系统将根据失效分析的诊断结果,自动从Trace中提取优化目标并启动任务,全程无需人工配置,详见一键智能优化。

操作步骤

  1. 填写Skill优化任务基础信息。

    在AgentArts左侧导航栏中选择“观测与优化 > 优化”,在“Skill优化”页签单击“创建Skill优化”。

    填写任务名称、描述。

    支持添加标签,标签用于对轨迹分析任务进行自定义标记和分类管理。每个标签包含一个“键”和一个“值”,可按需添加。

  2. 配置优化对象。

    单击“选择优化对象”,在弹出的选择器中选择需要分析智能体。轨迹分析支持以下类型的智能体,请根据您的Agent构建方式选择对应类型:

    表1 智能体类型

    类型

    适用范围

    Trace上报方式

    智能体运行时

    使用LangChain等框架本地开发,托管至AgentArts运行时的智能体。

    托管后自动上报

    第三方托管

    在AgentArts平台以外独立运行,通过观测OpenAPI上报数据的智能体。

    需手动对接上报

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

  3. 选择委托。

    在“委托”下拉框中选择已创建的IAM信任委托,用于授权平台访问该Agent的Trace数据。如未创建,单击“前往创建”跳转至IAM平台完成创建后返回。

    创建委托时各参数要求如下:

    • 委托名称:由用户自定义
    • 信任主体类型:选择“云服务”
    • 云服务:填写“智果Agent优化”
    • 其他参数:使用默认配置

    委托创建完成后,按照页面提示进行授权,授权项选择“AgentArtsRLAgentTuningTaskAgencyPolicy”。

  4. 配置数据采样信息。

    设置采样Trace的时间范围,系统将从该时间段内的Trace中提取工具调用数据进行分析。

    单击“添加筛选条件”,可按特定属性过滤目标Trace,将分析范围缩小到您关注的会话子集。例如,仅分析特定用户群或特定业务流程的会话。

    设置数据采样比例、采样数据上限。首次分析可使用默认值;若数据量较少,可适当提高比例。

    图1 配置优化对象与数据采集信息

  5. 确认所有配置无误后,单击“保存并运行”,任务开始运行。

    您可在Skill优化任务列表中查看任务的运行状态。

相关文档