> ## 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 建议

> 将转接人工的对话转化为切实可行的 AI Agent 改进方案。

<Tip>
  将转接人工的对话转化为切实可行的 AI Agent 改进方案。AI 建议现已支持帮助您的团队识别 **内容缺失**、 **数据缺失**和 **操作缺失**，并引导管理员发布可复用的问答内容、创建数据连接器或构建技能来补齐缺失的能力。
</Tip>

## AI 建议的作用

当客户被转接给人工客服时，对话内容通常能揭示 AI Agent 无法完成任务的原因。AI 建议将重复出现的失败归类为不同的缺失类型，并建议管理员执行下一步操作：添加缺失的知识、连接实时客户或业务数据，或者为外部操作创建自动化技能。

| 缺失类型 | 含义 | 典型下一步操作 |
| - | - | - |
| **内容缺失** | AI Agent 缺少可复用的知识内容，例如政策、产品说明或排错解答。 | 审核并批准生成的问答草稿进入知识库。 |
| **数据缺失** | AI Agent 需要实时或客户专属数据，例如订单状态、账户详情、配送进度或订阅信息。 | 创建数据连接器，然后在技能中使用它，以便 AI Agent 能够查询所需数据。 |
| **操作缺失** | AI Agent 需要权限和工作流步骤来完成外部操作，例如取消订阅、更改地址、发起退款或更新访问权限。 | 如有需要先创建数据连接器，然后创建一个包含确认、校验、操作步骤以及回退处理的技能。 |

***

## 适用人群

此功能专为支持运营团队、客户体验运营团队、AI Agent 管理员以及任何负责保持 AI Agent 知识库准确完整的人员设计。

将 AI 建议作为定期的审核队列使用：打开页面，查看建议的最重要缺失项，并针对每种类型采取推荐的操作。

***

## 查找位置

1. 打开您的 AI Agent 配置。
2. 在左侧边栏中选择 **Recommendation**。

页面打开后将显示一个审核队列，列出根据多次转接对话由 AI 生成的建议。

<Frame caption="The YClouder Recommendations page shows the recommendation queue and the selected Q&A draft.">
  <img src="https://mintcdn.com/lchnan/3_MG7u4sxNnj0E_f/product-assets/english-help-context-2026-09-29/ai-recommendations-overview.jpg?fit=max&auto=format&n=3_MG7u4sxNnj0E_f&q=85&s=f42540a2dc97b14197f073099c34fe69" alt="YClouder 建议页面，包含内容缺失卡片、建议依据、问答草稿和建议详情" width="2370" height="1182" data-path="product-assets/english-help-context-2026-09-29/ai-recommendations-overview.jpg" />
</Frame>

***

## 如何解读页面

| 区域 | 含义 |
| - | - |
| 影响摘要 | 页面顶部总结了提高 Agent 解决率最有效的方法。 |
| 缺失分布 | 堆叠条形图显示了内容缺失、数据缺失和操作缺失的建议数量，以及各类型占总量的比例。 |
| 建议数量 | 项目计数显示符合当前筛选条件和搜索词的建议数量。 |
| 建议列表 | 每张卡片显示缺失类型、影响级别、建议标题、摘要、转接对话次数和生成时间。 |
| 详情页面 | 右侧内容因缺失类型而异。内容缺失会打开 **Review Q\&A draft**。数据和操作缺失会打开 **Connect data and create skill**。 |
| 建议详情 | 详情卡片显示缺失类型、预期影响、转接对话数、缺失能力和状态。 |

***

## 查找合适的建议

| 控件 | 使用方法 |
| - | - |
| 排序 | 使用排序控件（如 **Impact**）优先处理最有可能大幅减少人工转接的建议。 |
| 筛选器 | 使用 **Gap type**、 **Status** 和 **Generated time** 来缩小队列范围。例如，当您只想查看等待审核的建议时，将状态保持为 **Active** 。 |
| 搜索建议 | 当您想查找特定建议时，可以按建议标题、主题、缺失能力或客户问题中的关键词进行搜索。 |

<Frame caption="Filter recommendations by gap type, status, and generated time.">
  <img src="https://mintcdn.com/lchnan/3_MG7u4sxNnj0E_f/product-assets/english-help-context-2026-09-29/ai-recommendations-filters.jpg?fit=max&auto=format&n=3_MG7u4sxNnj0E_f&q=85&s=a92253a1ac6932bcd9086f912230bae9" alt="YClouder 建议页面，已打开缺失类型、状态和生成时间的筛选面板" width="2370" height="1182" data-path="product-assets/english-help-context-2026-09-29/ai-recommendations-filters.jpg" />
</Frame>

***

## 审核建议

1. 从列表中选择一条建议。如果您希望快速减少重复转接，请从高影响力的项目开始。
2. 检查 **缺失类型** ，以便了解该建议应转换为知识内容、数据连接器还是自动化技能。
3. 阅读摘要、差距证据、AI Agent 失败原因以及缺失的功能。这些字段说明了 AI Agent 无法回答或执行的内容。
4. 点击 **查看源会话** 以检查 AI 选出的转接会话。这些来源有助于你核实该推荐是否基于真实的客户需求以及有用的人工回复。
5. 对于 **内容缺口**，请查看 AI 生成的问答草稿。您可以在发布前编辑标题和答案。
6. 对于 **Data Gap** 或 **Action Gap**，在创建自动化之前请先检查建议的数据连接器（Data Connector）字段和技能（Skill）步骤。
7. 如果建议准确无误，请根据其类型使用主要操作：针对内容缺失（Content Gaps），使用 **Approve as Q\&A** （批准为问答）；针对数据和操作缺失（Data and Action Gaps），使用 **Create a data connector**（创建数据连接器）、 **Create a skill**（创建技能）以及 **Mark as done** （标记为完成）。

<Tip>
  源对话为只读模式。它们用于帮助审核人员了解生成该推荐的原因，以及建议的问答、连接器或技能（Skill）是否可信。
</Tip>

<Frame caption="Source conversations are read-only and show the evidence selected by AI.">
  <img src="https://mintcdn.com/lchnan/3_MG7u4sxNnj0E_f/product-assets/english-help-context-2026-09-29/ai-recommendations-source-conversations-privacy.png?fit=max&auto=format&n=3_MG7u4sxNnj0E_f&q=85&s=8eeb82934d6af04e3e3703bd1dfe75a4" alt="针对 YClouder 内容缺口推荐的来源对话面板，其中客户姓名和电话号码已模糊处理" width="1776" height="886" data-path="product-assets/english-help-context-2026-09-29/ai-recommendations-source-conversations-privacy.png" />
</Frame>

***

## 解决数据与操作差距

数据与操作缺失建议会打开 **连接数据并创建技能** 页面，而不是问答草稿。使用此页面查看依据、了解缺失的能力，并创建 AI Agent 所需的自动化功能。

| 页面区域 | 审查内容 | 后续操作 |
| - | - | - |
| **建议** | 阅读生成的摘要和状态。如果需要验证建议背后的已转接会话，请使用 **查看源会话** 。 | 如果该建议没有用，请拒绝它。如果有用，请继续进行自动化设置。 |
| **差距证据** | 查看 **智能体失败原因**、 **缺失的能力**以及 **智能体所需的数据**。数据字段以标签形式显示，例如账户余额、disputeId 或状态。 | 确认缺失的能力和所需字段符合实际运营需求。 |
| **创建自动化** | 页面会推荐两个设置卡片： **创建数据连接器** 和 **创建技能**。连接器卡片描述要添加的 API 能力；技能卡片描述将调用该连接器的工作流。 | 先创建并测试连接器，然后在技能构建器中选择该连接器并完成技能配置。 |
| **标记为已完成** | 在连接器和 Skill 配置并测试完成后，返回建议。 | 点击 **标记为已完成** ，使该建议移出活跃队列。 |

<Check>
  该技能依赖于数据连接器。请先配置并测试连接器，然后即可在技能构建器中进行选择。
</Check>

***

数据与操作缺失（Data and Action Gap）建议不会直接发布问答答案。它们会引导您完成缺失的自动化配置，以便 AI Agent 能够检索到正确的数据或完成安全的操作调用。

| 步骤 | 配置内容 | 作用说明 |
| - | - | - |
| **1. 创建数据连接器** | 打开现有的数据连接器模块，其中已预填推荐的连接器名称和返回字段。添加您的 API 端点、身份验证、请求参数和响应映射。 | 这使 AI Agent 能够访问实时客户或业务数据，而不仅仅依赖静态知识库内容。 |
| **2. 创建技能** | 使用调用数据连接器的推荐步骤打开技能构建器。对于操作缺口，请包含身份确认、资格检查、用户确认、操作步骤以及在无法安全完成操作时转接人工支持的兜底方案。 | 这将缺失的能力转化为 AI Agent 可以遵循的可重复工作流。 |
| **3. 标记为完成** | 在连接器和 Skill 配置并测试完成后，返回建议并点击 **标记为完成**。 | 该建议将移动至 **已批准**，同时仍可通过状态筛选条件进行查看。 |

<Check>
  在完成技能（Skill）之前，请先构建并测试数据连接器（Data Connector）。技能依赖连接器的响应字段来查询数据或可靠地完成推荐的操作。
</Check>

***

## 在批准前编辑草稿

生成的问答草稿会显示在“内容缺失”建议中。在批准之前，请确保问题听起来符合客户的实际提问方式，并且答案足够清晰，以便 AI Agent 能够重复使用。

| 问答标题 | 问答回复 |
| - | - |
| 使用自然的客户提问方式。既要足够具体以匹配重复出现的问题，又要足够宽泛以适用于未来的客户。 | 编写直接、完整的回复。移除任何仅适用于单个客户的内容，例如个人账户信息或一次性排查记录。 |

***

## 拒绝建议

如果某条建议没有用处，请点击 **Reject**。当出现以下情况时，您可能会拒绝建议：证据不足以支持该建议、缺失的功能不值得自动化、来源会话过于针对特定客户，或者您的团队不希望 AI Agent 处理该话题。已拒绝的建议将离开活跃队列，但仍可通过状态筛选器找到。

<Frame caption="Use Reject to dismiss the recommendation or Approve as Q&A to publish the reviewed draft.">
  <img src="https://mintcdn.com/lchnan/3_MG7u4sxNnj0E_f/product-assets/english-help-context-2026-09-29/ai-recommendations-actions.jpg?fit=max&auto=format&n=3_MG7u4sxNnj0E_f&q=85&s=90da7e717c9ebd4af5b6ec337fdd50f2" alt="包含“查看来源会话”、“拒绝”和“批准为问答”按钮的建议操作区域" width="1589" height="278" data-path="product-assets/english-help-context-2026-09-29/ai-recommendations-actions.jpg" />
</Frame>

***

## 什么是优质建议

优质建议通常来自多个转接的人工会话，具有清晰的规律和充分的依据来确定下一步改进方向。最适合的建议类型取决于 AI Agent 所缺失的内容：可复用的知识、实时数据或安全的操作工作流。

| 缺失类型 | 适用场景 | 不适用场景 |
| - | - | - |
| **内容缺失** | 重复出现的产品、政策、账单或故障排查问题，可沉淀为稳定的知识库内容。 | 答案取决于单个客户的私人账户、订单、支付或配送状态。 |
| **数据缺失** | AI Agent 需要查询特定客户的信息或实时信息，且所需字段可通过 API 返回。 | 数据源不可用、无法安全公开，或变化过于不可预测而无法映射到连接器响应中。 |
| **操作缺失** | AI Agent 应执行可重复的操作，并具有明确的资格检查、确认、成功处理和回退规则。 | 该操作需要人工判断、不支持的权限或应由人工客服审批的政策决策。 |


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