> For the complete documentation index, see [llms.txt](https://docs.chatalog.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatalog.ai/zh-cn/ai-tools/ai-zhi-neng-dai-li.md).
# AI 智能代理
AI 智能代理可帮助您在对话流程编辑器中构建 AI 对话流程。通过设置 AI 的角色、目标和完成条件，AI 能够理解客户需求、回答问题，并可根据需要执行搜索知识库、创建预约或访问 Google Sheet 等操作。
{% hint style="info" %}
AI 智能代理目前为 Beta 版本，适用于**商务版**及以上方案。
{% endhint %}
## 开始之前
在配置 AI 智能代理前，请确认您已满足以下条件：
* 使用 **商务版** 或以上方案。
* 已创建一个对话流程。
* （可选）如需创建预约，请先创建预约项目。
* （可选）如需访问 Google Sheet，请先完成 Google Sheet 连接。
* （可选）如需回答知识库内容，请先上传相关文档。
> **注意：** AI 智能代理目前为 **Beta** 功能，功能及支持的操作可能会在后续版本中调整。
***
## 添加 AI 智能代理模块
1. 打开对话流程编辑器。
2. 将 **AI 代理** 模块拖入流程中。
3. 将模块连接到流程。
4. 点击 **配置(Configure)** 进行设置。
***
## 配置 AI 智能代理
AI 智能代理包含三个主要配置项。
### 角色
设置 AI 应扮演的角色。
此设置可定义 AI 的身份、专业能力及回复风格。
**示例**
> 你是一名美容院客服。
***
### 目标
设置 AI 需要完成的任务。
请清晰描述希望 AI 完成的工作内容。
**示例**
> 回答客户咨询、推荐合适疗程、协助客户预约，并收集创建预约所需的信息。
***
### 完成条件
定义 AI 在什么情况下视为完成任务。
您可以添加一个或多个完成条件。
**示例**
* 已回答客户问题。
* 已成功创建预约。
* 已收集所有必要信息。
* 客户无需进一步协助。
***
## 收集动作（可选）
收集动作可扩展 AI 智能代理的能力。
您可根据业务需求配置一个、多个或不配置任何操作。如果未配置任何操作，AI 智能代理将根据角色、目标、完成条件以及当前对话内容进行回复。
***
### 设置自定义字段(Set Custom Field)
允许 AI 智能代理将收集的信息保存至联系人自定义字段。
常见用途包括：
* 客户姓名
* 会员编号
* 偏好语言
* 产品偏好
***
### 设置标签(Set Label)
允许 AI 智能代理自动为会话添加标签。
例如：
* VIP
* 新客户
* 有兴趣
* 待跟进
***
### 搜索知识库 (Search Knowledge Base)
允许 AI 智能代理搜索已上传的知识库项目文档，以回答客户问题。
适用于：
* 常见问题
* 产品信息
* 内部文档
* 公司政策
* 服务指南
***
### 创建 Booking
允许 AI 智能代理为客户创建预约。
添加此操作后：
1. 选择预约项目。
2. （可选）添加预约说明。
3. 配置元数据字段。
4. 将必要字段标记为 **必填**，AI 将在创建预约前收集相关信息。
#### 元数据字段
元数据字段可帮助 AI 判断需要收集哪些信息。
例如：
* CustomerName：客户姓名
* PhoneNumber：联系电话
* AppointmentDate：预约日期
* SkinConcern：皮肤问题
您可自定义每个字段的说明，帮助 AI 更准确地收集信息。
***
### Google Sheet
允许 AI 智能代理访问已连接的 Google Sheet。
#### 第一步
从 Google Drive 选择电子表格。
#### 第二步
（可选）指定工作表名称。
如留空，将使用默认工作表。
#### 第三步
输入操作说明，描述 AI 应如何使用 Google Sheet。
**示例**
> 回复客户前，先查询会员资料。
#### 配置字段（可选）
您可指定 AI 可访问的字段。
每个字段可设置以下权限：
* 读取
* 新增
* 更新
如未指定字段，AI 将根据授权访问所有字段。
#### Sheet 权限
可设置 AI 执行以下操作：
* 允许读取数据
* 允许新增数据行
* 允许更新数据行
建议仅授予必要权限。
***
## 继续构建流程
完成 AI 智能代理配置后：
1. 点击 **完成** 保存配置。
2. 继续将 AI 智能代理与其他对话流程模块连接。
3. 完成流程后，点击 **保存** 和 **发布** 即可正式启用。
> **提示：** AI 智能代理是对话流程中的流程模块，可搭配消息、条件判断、关键词触发等其他模块，构建完整的对话流程。
***
## 最佳实践
* 清晰定义 AI 的角色与职责。
* 将目标聚焦于单一业务场景。
* 使用完成条件定义 AI 何时完成任务。
* 仅启用实际需要的操作。
* 为元数据字段提供清晰的说明。
* Google Sheet 仅授予必要权限。
* 发布前请充分测试流程。