
# 配置智能问答机器人连接器
智能问答机器人连接器用于对接华为云智能问答机器人（QABot）。
智能问答机器人，帮助企业快速构建，发布和管理智能问答机器人系统，可应用于售后自动问答、坐席助手、售前咨询等场景。
#### 创建智能问答机器人连接
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)。

2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。
3. 选择"智能问答机器人"连接器。
4. 在弹窗中配置连接信息，完成后单击"确定"。
   
   | 参数     | 说明                                                                                                                                                         |
   |:---|:---|
   | 连接名称   | 填写连接器实例名称。                                                                                                                                                 |
   | 访问密钥ID | 当前账号的AK（Access Key ID）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取AK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为：credentials.csv。    |
   | 秘密访问密钥 | 当前账号的SK（Secret Access Key）。请参考[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)获取SK，如果已生成过AK/SK，找到原来已下载的AK/SK文件，文件名一般为credentials.csv。 |
   | 描述     | 填写连接器的描述信息，用于识别不同的连接器。                                                                                                                                     |
      
   
 
#### 支持的动作
- 获取视频详情
- 删除视频
- 更新视频名
- 创建视频
- 获取视频列表
- 关闭会话
- 处理会话
- 开启会话
- 关键词统计
- 问答统计
- 访问统计
- 问答机器人会话
 
#### 配置参数
表1获取视频详情 
| 参数         | 说明           |
|:---|:---|
| project_id | 项目ID，用于资源隔离。 |
| video_id   | 视频ID。        |
| region_id  | 区域ID。        |
   
表2删除视频 
| 参数         | 说明           |
|:---|:---|
| project_id | 项目ID，用于资源隔离。 |
| video_id   | 视频ID。        |
| region_id  | 区域ID。        |
   
表3更新视频名 
| 参数         | 说明           |
|:---|:---|
| project_id | 项目ID，用于资源隔离。 |
| video_id   | 视频ID。        |
| region_id  | 区域ID。        |
| name       | 视频名称。        |
   
表4创建视频 
| 参数         | 说明           |
|:---|:---|
| project_id | 项目ID，用于资源隔离。 |
| region_id  | 区域ID。        |
| name       | 视频名称。        |
   
表5获取视频列表 
| 参数         | 说明              |
|:---|:---|
| project_id | 项目ID，用于资源隔离。    |
| region_id  | 区域ID。           |
| limit      | 范围：大于等于1；默认：10。 |
| name       | 名称，长度小于63。      |
| offset     | 范围：大于等于0；默认：0。  |
   
表6关闭会话 
| 参数         | 说明           |
|:---|:---|
| project_id | 项目ID，用于资源隔离。 |
| qabot_id   | 机器人标识符。      |
| session_id | 会话标识符。       |
| region_id  | 区域ID。        |
   
表7处理会话 
| 参数                                              | 说明                                                                                                                                                                                                                |
|:---|:---|
| project_id                                      | 项目ID，用于资源隔离。                                                                                                                                                                                                      |
| qabot_id                                        | 机器人标识符。                                                                                                                                                                                                           |
| session_id                                      | 会话标识符。                                                                                                                                                                                                            |
| region_id                                       | 区域ID。                                                                                                                                                                                                             |
| extends                                         | 扩展参数。                                                                                                                                                                                                             |
| tag_ids                                         | 待匹配的答案标签ID列表。                                                                                                                                                                                                     |
| should                                          | 必须要包含其中之一的答案标签ID列表。                                                                                                                                                                                               |
| domain_ids  | 领域列表，多个领域用分号隔开。如果设置了领域且领域不为空，就从这些领域中匹配答案，否则就从该用户的全部知识库匹配答案。 当前最多支持10个领域。                                                                                                            |
| source                                          | 问题来源，支持用户自定义，最终体现在问答日志里。                                                                                                                                                                                          |
| chat_enable                                     | - true：使用内部闲聊语料进行兜底 ，默认true。  - false：不使用闲聊兜底。   |
| user_id                                         | 用户ID，在日志中用于标识不同用户，可以为任意String。                                                                                                                                                                                    |
| question                                        | 用户输入。                                                                                                                                                                                                             |
   
表8开启会话 
| 参数         | 说明           |
|:---|:---|
| project_id | 项目ID，用于资源隔离。 |
| qabot_id   | 机器人标识符。      |
| region_id  | 区域ID。        |
   
表9关键词统计 
| 参数         | 说明                               |
|:---|:---|
| project_id | 项目ID，用于资源隔离。                     |
| qabot_id   | 机器人标识符。                          |
| region_id  | 区域ID。                            |
| start_time | 查询的起始时间，long，UTC时间，默认值为0。        |
| end_time   | 查询的结束时间，long，UTC时间，默认值为当前时间的毫秒数。 |
| top        | 关键词最多显示的个数，默认值为10，取值范围0-50。      |
   
表10问答统计 
| 参数         | 说明                                                |
|:---|:---|
| project_id | 项目ID，用于资源隔离。                                      |
| qabot_id   | 机器人标识符。                                           |
| region_id  | 区域ID。                                             |
| start_time | 查询的起始时间，long，UTC时间，默认值为0。                         |
| end_time   | 查询的结束时间，long，UTC时间，默认值为当前时间的毫秒数。                  |
| interval   | 统计周期，目前支持month、week、day。                          |
| time_zone  | 请求所在时区，例如：中国东八区为"+08:00"；美国西五区为"-05:00"；默认为"UTC"。 |
| domain     | 所属领域。                                             |
   
表11访问统计 
| 参数                                                | 说明                                                                                    |
|:---|:---|
| project_id                                        | 项目ID，用于资源隔离。                                                                          |
| qabot_id                                          | 机器人标识符。                                                                               |
| region_id                                         | 区域ID。                                                                                 |
| start_time                                        | 查询的起始时间，long，UTC时间，默认值为0。                                                             |
| end_time                                          | 查询的结束时间，long，UTC时间，默认值为当前时间的毫秒数。                                                      |
| interval                                          | 统计周期，目前支持month、week、day。                                                              |
| time_zone domain | 请求所在时区，例如：中国东八区为"+08:00"；美国西五区为"-05:00"；默认为"UTC"。 所属领域。 |
   
表12问答机器人会话 
| 参数                                                | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|
| project_id                                        | 项目ID，用于资源隔离。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| qabot_id                                          | 机器人标识符。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| region_id                                         | 区域ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| extends                                           | 扩展参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| tag_ids                                           | 待匹配的答案标签ID列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| should                                            | 必须要包含其中之一的答案标签ID列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| domain_ids  | 领域列表，多个领域用分号隔开。如果设置了领域且领域不为空，就从这些领域中匹配答案，否则就从该用户的全部知识库匹配答案。 当前最多支持10个领域。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| source                                            | 问题来源，支持用户自定义，最终体现在问答日志里。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| return_all_answers                                | 是否返回所有类型的回答。 - true ：返回所有类型的回答。  - false：不返回所有类型的回答。                                                                                                                                                                                                                                                                                                                                        |
| chat_enable                                       | 是否使用内部闲聊语料进行兜底。 - true ：使用内部闲聊语料进行兜底 ，默认true。  - false：不使用闲聊兜底。                                                                                                                                                                                                                                                                                                                        |
| user_id                                           | 用户ID，在日志中用于标识不同用户，可以为任意String。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| question                                          | 用户输入。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| session_id                                        | 会话标识符，UUID格式。如：c04e6f7b-61d7-4a2d-a0c8-f9ecd2f62359。 每次对话开启，机器人创建会话ID，下次请求中传入该ID表示继续该轮对话，每轮会话有效时间为2分钟。 若传入的会话ID已过期或者为空，则机器人会重新创建新的会话ID（重新创建会话id会消耗一定时间）。                                                                                                                                                                                                                                                                                                                                                                                                   |
| query_types                                       | 指定发送的机器人类型集合。 - 0 ：知识库问答。  - 1 ：技能问答。  - 2 ：闲聊问答。  - 3 ：图谱问答。  - 4 ：文档问答。  - 5 ：表格问答。   非必填字段。如果不填，会使用默认的机器人融合策略。 |
   
