Skill优化概述
Skill 优化是智能体优化提供的Skill层定向优化服务。它通过分析Agent在真实业务场景中产生的全链路执行轨迹，自动识别Skill在执行逻辑、边界处理、异常应对等方面存在的短板，并生成优化后的Skill文档，从而改善Agent的任务执行质量。
Skill是Agent执行特定任务类型的行为规范文档，通常以Markdown格式编写，描述了Agent在该任务下应遵循的操作步骤、工具调用顺序、准入条件、边界场景处理、异常应对策略等执行逻辑。
Skill是Agent知道怎么做的核心载体。如果说工具（Tool）是 Agent 的扳手，那么Skill就是操作手册。它告诉Agent在什么条件下启动任务、按什么顺序调用哪些工具、遇到异常情况如何处理、什么时候任务算完成。
一个Agent通常配置多个Skill，分别覆盖不同的任务类型。
为什么需要Skill优化
Skill文档的质量直接决定了Agent的任务执行效果。当Skill文档存在缺陷时，即使模型推理能力足够、工具描述足够清晰，Agent也可能因为不知道怎么做而表现不佳。常见的问题包括：
| 问题类型 | 典型表现 |
|---|---|
| 执行步骤残缺 | Skill中遗漏了关键步骤，导致Agent跳过必要操作，任务结果不完整 |
| 边界场景遗漏 | Skill未覆盖某些特殊输入或边界条件，Agent遇到这些场景时行为不可预期 |
| 异常处理空白 | Skill未定义工具调用失败、参数缺失等异常情况的应对策略，Agent遇错即停或行为混乱 |
| 准入条件不明 | Skill未清晰定义任务的触发条件和前提要求，导致Agent在不满足条件时错误启动任务 |
| 工具调用顺序混乱 | Skill对多个工具的调用时序描述模糊，Agent按错误顺序调用工具导致任务失败 |
| 与实际能力脱节 | 业务迭代后工具能力已变更，但Skill文档未同步更新，导致Agent执行逻辑与实际环境不匹配 |
这类问题的根因不在模型或工具，而在Skill本身。任务执行过程中仅优化Skill文档的内容，让Agent在执行任务时有更准确、更完整的行为指引。
支持的优化对象（智能体类型）
Skill优化支持对以下类型的智能体进行优化：
| 类型 | 说明 | Trace数据来源 |
|---|---|---|
| 智能体运行时 | 通过高代码方式在本地开发、并托管至AgentArts运行时（Runtime）的智能体 | 部署至AgentArts运行时后自动上报 |
| 第三方托管 | 在AgentArts平台以外开发和运行、通过观测OpenAPI上报Trace数据的第三方智能体 | 手动对接AgentArts观测功能后上报 |
- 如需了解高代码开发和智能体运行时的详细说明，请参考高代码开发概述、基础示例：创建基础对话智能体。
- 如需了解第三方智能体数据上报的配置方法，请参考上报第三方智能体 Trace、Metric、Log 数据。
- 无论哪种类型的智能体，轨迹分析均依赖会话Trace数据。在创建轨迹分析任务前，请确保目标智能体已在指定时间范围内产生了足够量的Trace数据，否则分析结果的覆盖度和准确性将受到影响。可在AgentArts平台“观测与优化 > 观测”功能中查看。
