> ## 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 Agent

> 创建、配置、测试、发布并分配 AI Agent。

## 1. 创建 AI Agent

<Tip>
  新创建的 AI Agent 会保持草稿状态。请先完成设置，在预览中进行测试，并点击 **Publish** ，然后再将其分配给 WhatsApp 号码。
</Tip>

在 YCloud 控制台中，打开 **AI Agent** 并点击 **Create Agent**。

1. 输入 Agent 的名称。
2. 选择最符合您使用场景的角色。
3. 填写所需信息并点击 **Create**。

<Frame caption="Select a role that matches the customer task. This example shows Customer service before creation.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-create-service-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=51661e4297cccf5c0cb2df1dc94d98d7" alt="包含四个角色选项的创建 AI Agent 表单。" width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-create-service-annotated.svg" />
</Frame>

| 角色 | 适用场景 |
| - | - |
| 潜在客户获取 | 获取并筛选潜在客户。在创建过程中选择 Agent 应保存的联系人属性。 |
| 导购助手 | 帮助客户查找并了解产品。 |
| 客户服务 | 解答常见问题并提供 24/7 全天候支持。 |
| 自定义 Agent | 为自定义场景构建 Agent。在创建过程中描述其职责和目标。 |

***

## 2. 配置 Agent

### Profile（画像）

* **基本信息（Basic）：** 添加名称、描述和品牌背景。品牌信息有助于 Agent 了解您的行业、产品和服务。
* **引导指令（Guidance）：** 选择语气和后备语言。使用 Instructions（指令）来定义 Agent 的角色、回复风格、工作流程和边界。
* **操作（Actions）：** 配置关闭会话、转接人工客服、添加联系人标签以及更新联系人属性等操作。清晰地描述各项操作应在何时触发。

<Check>
  **提示：** 在 Instructions 中编写清晰、具体的步骤。说明 Agent 必须转接人工客服的时机，以及绝不能捏造的信息。
</Check>

<Frame caption="Complete the profile, then use Preview to test the agent before publishing.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/agent-profile-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=3466b5ef4209a28b3ff415a80e051fdc" alt="演示 Agent 的 AI Profile 基本设置和预览面板。" width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/agent-profile-annotated.svg" />
</Frame>

### Capabilities（能力）

* **技能（Skills）：** 将复杂任务分解为各个步骤，以便 Agent 能够遵循定义好的工作流程。
* **知识库（Knowledge base）：** 添加业务信息，供 Agent 用于回答客户的问题。

<Warning>
  **更改何时生效：** 对 Profile 和 Skills 的更改需要发布后生效。对知识库的更改会立即生效。
</Warning>

***

## 3. 预览与发布

1. 在 **Preview** 面板中输入常见的客户问题并查看回复。
2. 测试知识库问答、操作触发、人工转接以及意外问题。
3. 当您想要开始新的测试会话时，点击 **Restart preview** 。
4. Agent 准备就绪后，点击 **Publish**。如果状态为 **Draft · Unpublished**，则说明最新更改尚未生效上线。

***

## 4. 将 AI Agent 分配给 WhatsApp 号码

在将 Agent 分配给号码之前，请先完成配置并发布该 Agent。

前往 **WhatsApp accounts > Settings > Inbox > Assignment**。

> **选择您希望 AI Agent 处理的号码。**

> **分配设置**

在 **Assign to** 下，选择 **AI Agent**，然后选择应该处理该会话的 AI Agent。

<Frame caption="Open Inbox > Assignment for the selected number, then choose AI Agent under Assign to.">
  <img src="https://mintcdn.com/lchnan/gXEJIQXV2JH2VUQJ/product-assets/english-help-2026-09-22/inbox-assignment-target-annotated.svg?fit=max&auto=format&n=gXEJIQXV2JH2VUQJ&q=85&s=16e8a6d729c7a835c86c0511190cb978" alt="带有 AI Agent 选项的 WhatsApp 号码收件箱分配菜单。" width="3024" height="1656" data-path="product-assets/english-help-2026-09-22/inbox-assignment-target-annotated.svg" />
</Frame>


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