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

AI 对话组件用于搭建对话式的低代码应用，支持绑定对话流、设置开场白和快捷指令。
:::tip 说明
搭建小程序和 H5 界面时，请注意不同发布渠道，AI 对话组件的使用要求不同，具体如下：

* 微信渠道：AI 对话组件仅支持在企业主体小程序中使用，不支持在个人主体小程序中使用。
* 抖音渠道：由于抖音渠道仅支持企业主体小程序，AI 对话组件仅支持在企业主体小程序使用。
:::
## 属性设置 {#ca7558a1}
AI 对话组件提供了丰富的属性配置选项，以下是一些关键属性配置说明。关于组件尺寸、位置、样式、指针、变换等通用属性的设置方法，请参考[设置组件属性和事件](/guides/set_properties_events)。
### 绑定对话流 {#6c09821a}
为 AI 对话组件绑定对话流，可以实现对话式的低代码应用开发。
在低代码应用的**业务逻辑**页面中创建对话流后，你可以在**用户界面**中，选中 AI 对话组件，并在其属性的**对话流**参数中，绑定该对话流。详情请参考[使用对话流搭建低代码应用](/guides/chatflow_quickstart)。

::::cols
@col 50
**创建对话流**
![Image=1270x355](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/181361979199433d9a7a542b8916ccd6~tplv-goo7wpa0wc-image.image)



@col 50
**绑定对话流**
![Image=264x146](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/c44ae3b350b545eca823434f5ffa7737~tplv-goo7wpa0wc-image.image)

::::

### 在对话流中设置角色信息 {#d036065b}
你可以在低代码应用的**业务逻辑**页面中，单击**角色**图标，设置角色信息。角色是智能体的人物形象，通过角色相关的配置可以提高智能体的拟人程度。
![Image=827x480](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f18f6908972a40ed91f4ee1cb2d5ae66~tplv-goo7wpa0wc-image.image)
<!-- @cols-width: 140,712 -->
| | | \
|**属性** |**说明** |
|---|---|
| | | \
|角色名称 |设置角色名称。 |
| | | \
|角色描述 |设置角色的详细信息，帮助用户了解角色的背景和功能。 |
| | | \
|角色头像 |设置角色头像，支持 AI 生成，也支持上传 `.png` 或 `.jpg ` 格式的图标。上传的图标最大不超过 5MB。 |
| | | \
|开场白文案 |设置 AI 对话组件的开场白，开场白是用户进入低代码应用后自动展示的引导信息，它的主要目的是帮助用户理解应用的用途，以及如何与其进行交互。 |
| | | \
|开场白预置问题 |配置 AI 对话组件的预置问题，用户与低代码应用对话时，可以直接通过预置问题发起预设的对话。 |
| | | \
|用户问题建议 |打开**用户问题建议**开关后，当智能体完成回复时，系统会根据当前的 Prompt，提供最多 3 条与之相关的提问建议。你可以根据这些建议，进一步优化提问的 Prompt，以便获得更精准、更有针对性的回答。 |\
| |你也可以自定义用于生成提问建议的 Prompt。 |
| | | \
|背景图片 |设置对话框的背景图片。 |
| | | \
|Agent 声音 |设置 Agent 的语音音效。 |\
| |如果打开**文本转语音**开关，系统将支持使用你所选择的音效播放智能体的回复内容。 |
| | | \
|用户输入方式 |设置用户与 Agent 交互的输入方式，支持打字输入和语音输入。 |

### 为角色信息绑定动态数据 {#1f5f961d}
你可以通过 AI 对话组件的**动态角色信息**参数，动态设置角色信息。例如设置**角色昵称**为 `{{appInfo.name}}`，即表示引用低代码应用的名称，当低代码应用名称发生变化时，角色昵称也会随之改变。
:::tip 说明
如果在对话流中设置了角色信息，又在**动态角色信息**参数中设置了角色信息，那么将以**动态角色信息**参数中的配置为准。
:::
![Image=319x334](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/f06ef52f04fa468b9b2931d2c2a87ce3~tplv-goo7wpa0wc-image.image)
### 设置用户信息 {#589c9a8c}
你可以在扣子编程账号**个人主页**的**设置**页面中设置用户头像和名称，不支持在 AI 对话组件中设置用户信息。具体操作，请参考[设置个人资料](/guides/setting_up_your_profile)。
![Image=488x290](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0c4aecd05b4b4d9ca8b52f6aec39d1cb~tplv-goo7wpa0wc-image.image)
### 上传文件 {#363df567}
在 AI 对话组件的属性中，打开**文件上传按钮**开关，AI 对话中将展示**文件上传**图标，用于在对话过程中上传文件，支持上传 Image、pdf、docx、excel、csv、audio 类型。例如在图像生成类应用中，可以上传图片文件，低代码应用根据原图片和指定的风格自动生成创意图片。
:::tip 说明
发布低代码到微信小程序，不支持上传文件。
:::

::::cols
@col 50
**属性配置**
![Image=268x284](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/0c08262ddff1416180c081d3410bfce5~tplv-goo7wpa0wc-image.image)


@col 50
**效果**
![Image=365x80](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/3a3a250e13304ad39dcd8d1dc9b7aea6~tplv-goo7wpa0wc-image.image)


::::

### 清除对话 {#a64edd14}
在 AI 对话组件的属性中，打开**对话清除按钮**开关，AI 对话中将展示**对话清除**图标。单击该图标即可一键清除对话内容。

::::cols
@col 50
**属性配置**
![Image=262x299](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/4403a2db5cca4dfd8d44ad47f0ab2f56~tplv-goo7wpa0wc-image.image)


@col 50
**效果**
![Image=363x83](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/98a4f661c71742269a0aba42308b5322~tplv-goo7wpa0wc-image.image)


::::

### 隐藏组件 {#f27d51e9}
AI 对话组件的可见性可通过设置常用条件或表达式灵活控制，以实现特定场景下的隐藏或显示。

* 表达式方式
   * 设置为 false：显示组件。
   * 设置为 true：隐藏组件。
   * 设置为变量：通过变量值（true 或 false）动态控制组件的可见性。配置示例，请参考[隐藏组件](/guides/set_properties_events#46d8e38f)。
* 常用条件方式
   支持通过可视化界面设置条件，以控制组件的可见性。配置示例，请参考[隐藏组件](/guides/set_properties_events#46d8e38f)。

## 事件设置 {#23196d0b}
通过配置 AI 对话组件的事件，可以为 AI 对话组件添加丰富的交互功能，
<!-- @cols-width: 148,709 -->
| | | \
|**事件项** |**说明** |
|---|---|
| | | \
|事件类型 |AI 组件不支持配置事件类型。 |
| | | \
|组件方法 |支持以下方法： |\
| | |\
| |* 设置禁用：使组件变为禁用状态，用户无法与之交互。 |\
| |* 设置隐藏：隐藏组件，使其不可见。 |

##  {#a84a5121}