开放平台-对话

本章节将讲解：如何使用“开放平台-对话”渠道与机器人对话。

渠道配置

1. 点击机器人菜单“部署-渠道”，点击“配置”即可查看渠道ID。渠道ID将用来进行对话API的调用。

2. 在一些场景下，可能需要对用户消息或机器人消息进行改写。例如：根据用户属性提供个性化回复，特定渠道只召回部分知识点，3次兜底之后自动转人工等。这时，你可以根据具体的业务需求来配置预处理或后处理服务。

• 预处理：对用户消息进行改写。
• 后处理：对机器人消息进行改写。

caution

处理服务的接口需要调用方开发，开发注意事项详见消息处理。

使用开放平台渠道

调用前准备

1. 手册顶部工具栏中“开放平台”包含全部的服务端接口和引擎层接口详情。其中服务端接口页面支持快速调用，操作指南请见调用开放平台接口。

2. 开放平台的所有接口调用均需增加鉴权，鉴权详情请见服务账号。

通过开放平台创建用户并收发消息

1. 平台提供机器人的创建用户接口，调用这个接口需要提供如下两个固定参数：

参数名	参数说明	查找方式
agentId	机器人ID，创建机器人后生成	前端URL或机器人设置中
channelId	渠道ID，创建渠道后生成	渠道配置中

2. 平台提供机器人的收发消息接口，调用这个接口需要提供如下三个固定参数：

参数名	参数说明	查找方式
agentId	机器人ID，创建机器人后生成	前端URL或机器人设置中
channelId	渠道ID，创建渠道后生成	渠道配置中
environment	指定环境，SKETCH即测试环境，PRODUCT即生产环境	根据对接的渠道类型，自行选择

• 接口可以传入未创建用户，未创建用户可以正常回复，但是不会出现在数据统计与消息记录中
• 接口channelId支持传-，用户可以正常回复，但不会出现在数据统计与消息记录中

通过开放平台为用户添加属性

1. 用户属性及元数据可以用于影响对话内容，定义及详情请见元数据与属性。

2. 平台提供机器人的更改用户的属性值接口，调用这个接口需要提供如下三个固定参数：

参数名	参数说明	查找方式
agentId	机器人ID，创建机器人后生成	前端URL或机器人设置中
channelId	渠道ID，创建渠道后生成	渠道配置中
username	用户名，创建用户后生成	-

3. 收发消息接口也支持传metadata，同名metadata会直接覆盖用户属性。