> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Skills

> 创建、配置、测试和管理可重复使用的 AI Skills，以处理可重复的客户任务。

<Tip>
  Skill 通过定义任务启动时机以及 Agent 应遵循的步骤，指导 AI Agent 如何完成特定的、可重复的任务。将 Skills 用于诸如退款处理、销售线索资格审查、订单查询、预约预订或其他多步骤客户请求等流程。
</Tip>

## 何时应该创建 Skill？

选择 AI 能够显著减少人工工作量且预期流程可以清晰描述的工作流。

### 适合的场景

* 目前由您的团队处理的重复性、高频任务
* 在完成前需要进行多次提问或核对的任务
* 具有明确业务规则、所需信息和退出条件的流程
* 需要通过数据连接器从外部系统获取数据的任务
* 在特定条件下可能需要转接人工的流程

### 开始之前

* 选择一个定义明确的业务任务
* 记录正确的流程和重要的极端情况
* 确认该任务需要哪些客户信息
* 准备并启用任何所需的数据连接器
* 定义 AI 必须停止或将对话转接给人工的时机

<Check>
  **建议：** 从一到两个高价值的 Skill 开始。一个小而经过充分测试的 Skill 通常比试图处理许多不相关任务的单个 Skill 更可靠。
</Check>

***

## 创建和管理 Skills

### 打开 Skills 页面

1. 打开您想要配置的 AI Agent。
2. 打开 **Settings**，然后选择 **Skills** 标签页。
3. 选择 **New Skill**。

[打开 YCloud Skills 页面](https://www.ycloud.com/console/#/app/chatbot/agent/6a2906717c73707cc395680f/skills)

### 管理现有 Skills

Skills 列表显示每个 Skill 的名称、Start 触发器、最后更新时间和状态。

* **Search：** 按名称查找 Skill。
* **Used / Unused：** 使用状态开关控制 AI Agent 是否可以使用该 Skill。
* **Edit：** 选择 Skill 名称以更新其触发器或指令。
* **Delete：** 打开 Skill 的 Action 菜单并选择 Delete。

<Tip>
  禁用 Skill 会阻止 AI Agent 使用它。仅在您不再需要其配置时才删除 Skill。
</Tip>

***

## 配置 Skill

<Frame caption="Define when the Skill should start before writing the procedure it should follow.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-skill-create-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=3a034063698d0a90839f4dacec5db19b" alt="New Skill 编辑器，在分步指令上方高亮显示 Start 触发器。" width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-skill-create-annotated.svg" />
</Frame>

### 1. 输入清晰的标题

命名具体的成果或任务，而不是宽泛的部门或主题。清晰的标题使 Skills 更容易查找和维护。

| **质量** | **示例** | **原因** |
| - | - | - |
| **推荐** | 处理退款请求 | 描述了一项具体的客户任务 |
| **避免** | 客户服务 | 过于宽泛，无法表明 Skill 的实际作用 |

### 2. 定义 Start 触发器

Start 触发器告诉 AI Agent 何时以及何时不使用该 Skill。包含客户意图、所需上下文和重要的排除条件。

> 当客户明确要求取消符合条件的订单并获得退款时使用此 Skill。请勿将其用于退换货政策咨询、支付失败或已发货的订单。

#### Start 触发器核对清单

* 使用自然语言描述客户意图。
* 在适用的情况下，包含请求的常见变体表述。
* 如果类似请求需要不同的流程，请说明何时不能运行该 Skill。
* 避免模糊的触发器，例如“需要时”或“用于支持问题”。

### 3. 编写分步指令

描述 AI Agent 应遵循的完整流程。每个步骤应有明确的目的并以动作开头。

1. **确认** 客户的请求。
2. **收集** 识别订单所需的信息。
3. **检查** 请求是否符合退款政策。
4. **使用** 相应的数据连接器来检索或更新订单。
5. **确认** 结果并说明后续步骤。
6. 达到相关条件时**转接** 或结束对话。

#### 编写最佳实践

* 按照运行顺序对步骤进行编号。
* 保持每个步骤专注于一个动作或决策。
* 明确指定所需信息，而不是期望 AI 自行推断。
* 定义在数据缺失、无效或矛盾时的处理方式。
* 明确说明完成和转接条件。
* 将冗长或包含条件的指令拆分为较小的步骤。

<Warning>
  **避免无事实根据的推测。** 如果指令、Profile、Knowledge base 或连接的系统没有提供所需的信息，请指示 AI Agent 询问客户、停止流程或转接给人工。
</Warning>

***

## 在 Skill 指令中使用命令

在分步指令编辑器中，输入 **/** 即可插入可用命令。菜单会显示内置操作以及 AI Agent 可用的已激活数据连接器。

### 内置操作

| **操作** | **用途** | **示例条件** |
| - | - | - |
| **转接人工** | 将会话转接给人工客服或团队 | 退款超出政策范围、客户对结果有争议或需要人工审批 |
| **结束会话** | 在技能成功完成后结束会话 | 结果已确认且客户不需要进一步协助 |
| **添加到退订列表** | 将当前联系人添加到您的退订列表中 | 联系人明确要求停止接收营销消息 |

要插入操作，请在 **分步指令**中输入 **/** ，然后在 **内置操作**下选择该操作。该操作将作为命令显示在技能指令中。

### 数据连接器

数据连接器允许技能查询或更新外部业务数据。命令菜单中仅显示已配置且处于激活状态的连接器。

对于每个连接器步骤，请明确描述：

* 何时应使用该连接器
* 应收集或传递哪些输入值
* AI Agent 应如何解读结果
* 当请求失败或未返回匹配数据时应如何处理
* 在更改数据之前是否必须经客户确认

<Tip>
  请勿指示技能使用尚未配置和激活的连接器。在发布前，请务必测试连接器的成功、空结果、无效输入以及失败响应等情况。
</Tip>

***

## 预览、发布和改进

### 在预览中测试

编辑技能时请使用预览面板。既要测试应该触发该技能的请求，也要测试不应触发该技能的类似请求。需要重新开始干净会话时，可重启预览。

#### 最低测试清单

* 典型的客户请求能够触发正确的技能
* 类似但被排除的请求不会触发该技能
* AI Agent 在执行操作前收集了所有必需的信息
* 步骤按预定顺序运行
* 数据连接器的成功和失败路径均表现正常
* 当需要人工判断或审批时，技能能够顺利转接人工
* 仅在任务完成后才关闭会话
* AI Agent 不会虚构数据、资格或操作结果

### 启用并发布

1. 返回技能列表，将技能状态设置为 **已使用**。
2. 选择 **发布** 以使 Agent 的技能更改生效。
3. 在将要使用已发布 Agent 的客户渠道中对其进行测试。
4. 查看真实会话，并在发现反复出现故障时优化启动触发器或指令。

<Check>
  可靠的技能是经过迭代构建出来的。建议先从简单的流程开始，测试真实的边界情况，发布上线，并逐一改进反复出现的问题。
</Check>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.