跳到主要内容
版本:1.11.1

开放平台-对话

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

渠道配置

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

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

  • 预处理:对用户消息进行改写。
  • 后处理:对机器人消息进行改写。 message-processing
caution

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

使用开放平台渠道

调用前准备

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

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

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

  1. 平台提供机器人的创建用户接口,调用这个接口需要提供如下两个固定参数:
参数名参数说明查找方式
agentId机器人ID,创建机器人后生成前端URL或机器人设置中
channelId渠道ID,创建渠道后生成渠道配置中
  1. 平台提供机器人的收发消息接口,调用这个接口需要提供如下三个固定参数:
参数名参数说明查找方式
agentId机器人ID,创建机器人后生成前端URL或机器人设置中
channelId渠道ID,创建渠道后生成渠道配置中
environment指定环境,SKETCH即测试环境,PRODUCT即生产环境根据对接的渠道类型,自行选择
  • 接口可以传入未创建用户,未创建用户可以正常回复,但是不会出现在数据统计与消息记录中
  • 接口channelId支持传-,用户可以正常回复,但不会出现在数据统计与消息记录中

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

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

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

参数名参数说明查找方式
agentId机器人ID,创建机器人后生成前端URL或机器人设置中
channelId渠道ID,创建渠道后生成渠道配置中
username用户名,创建用户后生成-
  1. 收发消息接口也支持传metadata,同名metadata会直接覆盖用户属性。