1.7 调用问答机器人
1.7.2 调用 API
在配置完问答语料、词典和模型训练后，您可以通过调用API的方式直接调用对话机器 人，为您的客户提供问答服务。
问答机器人面向客户的问答界面需要您根据自己业务需求进行开发，前台界面收到客 户问题后，调用问答机器人的接口，并与机器人进行交互，最终将问答机器人返回的 答案呈现给客户。交互的过程中，问答机器人会基于知识库配置，对传入的客户问题 进行搜索处理，并返回答案。
问答机器人中常用的接口如下所示，其他接口信息请参见《问答机器人服务API参 考》。为您提供以下两种调用API接口的方法：
使用Postman调用API 使用API Explorer调用API
准备工作
已注册华为云帐号，并完成实名认证，帐号不能处于欠费或冻结状态。
使用 Postman 调用 API
步骤1 配置环境。
1. 下载并安装Postman。
Postman建议使用7.24.0版本。
2. 下载问答机器人的Postman配置文件。
下载地址：CBS_OpenApi.postman_collection.json。
3. 导入配置文件。
a. 打开并登录Postman。
b. 单击左上角“File > Import > Import File > Choose Files”导入配置文件。
图1-46 导入配置文件
配置文件导入成功后，将显示在Postman左侧导航栏中。
图1-47 配置文件
说明
本配置文件中服务所属区域为“华北-北京四”，如果您在开通服务时，选择了其他 区域，在执行步骤3、步骤4时请将配置文件中的所有“cn-north-4”字段替换为实际 区域，服务部署的区域具体请参见终端节点。
步骤2 Token认证鉴权。
Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需 要使用Token进行鉴权。
1. 在Postman左侧导航栏中单击“get-token”配置文件。
2. 单击“Body”配置项。填写用户名、密码、帐号名。
请登录“我的凭证”页面，复制IAM用户名、帐号名至username、domainname 参数处，并填写密码。
图1-48 Token 认证鉴权
3. 单击“Send”，发送请求，获取并复制Token。
获取返回结果“Headers”中的“X-Subject-Token”即为Token。Token有效期为 24小时。
图1-49 获取 Token
步骤3 调用服务。
1. 在Postman左侧导航栏中单击“ExecuteQaChat”配置文件。
2. 登录我的凭证，获取“华北-北京四”区域的项目ID，替换配置文件URL中的 {project_id}。
3. 登录对话机器人服务管理控制台，在左侧菜单栏中选择“智能问答机器人”。在 机器人列表，复制机器人ID，替换配置文件URL中的{qabot_id}。
图1-50 机器人 ID
4. 单击“Headers”配置项。将获取的Token复制到{X-Subject-Token}中。
图1-51 填写 Token
5. 单击“Body”配置项，修改配置文件内容。其中，question参数为必填项，其他 参数项为非必填，其他参数请参见请求参数。
图1-52 修改配置文件
6. 单击“Send”，发送请求，获取调用结果。
图1-53 响应结果
----结束
使用 API Explorer 调用 API
图1-54 参数填写
表1-3 参数填写说明
必填项 必填参数 描述 填写方法
Region Region 可调用的地域。 单击 ，选择区域名 称。
Headers X-Auth-Token 用户Token。 登录后会自动获取。
Parameter
s project_id 项目ID，用于资源隔 离。
登录后会自动填充。
qabot_id 机器人标识符，qabot
编号，UUID格式。 在机器人列表，复制 机器人ID后填写。
Body question 用户问题。 自定义填写。
4. 参数填写完成后，单击“调试”。
5. 在“调试结果”页签查看响应结果。
图1-55 响应结果
1. 在机器人列表，单击机器人的ID或者“机器人管理”按钮，进入的“知识库 > 问 答训练”页面。
2. 单击“问答诊断”进入处理页面。
3. 输入“用户问”和“问题类别”，单击“Debug”。
其中“问题类别”可以设置多个，最多设置10个，也可以不设置问题类别进行诊 断。
4. 界面显示“分词结果”、“短语匹配”、“初筛结果”、“重排序结果”、“闲 聊结果”的匹配结果。
图1-56 问答诊断
表1-4 问答诊断参数说明
参数名称 参数说明
分词结果 显示用户问的分词结果，即分词后的有效词语。
短语匹配 当用户问的分词结果与知识库中语料的问题或扩展 问分词结果一致时，显示该问题的具体信息。
说明
只需与分词结果中的词语一致，不区分词语顺序。请参见 短语匹配示例了解详情。
初筛结果 根据用户问，使用自研搜索引擎，搜索知识库中的 问题及扩展问，并按相似得分降序展示搜索结果。
重排序结果 根据初筛结果，对用户问进行语义识别，并根据相 似度得分重新排序，按得分倒序展示结果。
说明“score”的范围为0~1。请参见 初筛结果和重排序结果对 比示例了解初筛结果和重排序结果的不同。
参数名称 参数说明
闲聊结果 当重排序结果的最高相似度得分低于一定阈值时，
系统会根据预置的闲聊问答语料进行匹配，并展示 匹配到的闲聊问题及答案。
请参见 闲聊结果示例了解详情。
– 短语匹配示例
此示例中，分词结果与问题完全匹配，此时将显示此问题的语料ID、问题、
扩展问、以及答案等信息。
图1-57 分词结果完全匹配
– 初筛结果和重排序结果对比示例
此示例中，初筛结果排序最高的得分为13.297，重排序结果排序最高的得分 为0.842，从匹配出的语料可以看出，重排序匹配后的内容与用户问的匹配度 更高。
图1-58 初筛结果和重排序结果对比
图1-59 闲聊匹配结果
1.9 运营面板
1.9.1 数据总览
您可以定期查看机器人的统计数据和运营数据，并根据数据情况提出解决方案，如补 充知识库、管理词典等措施，来提升对话机器人的体验效果。当前对话机器人服务提 供了数据总览功能方便用户查看问答数据。
数据总览界面入口：
进入对话机器人服务管理控制台，在左侧菜单栏中选择“智能问答机器人”。在机器 人列表，单击该机器人的ID或者“机器人管理”按钮，进入“运营面板 > 数据总览”
页面。
主要包含以下功能：
● 问答统计
● 访问统计
● 热点问题
● 关键词统计
问答统计
问答统计提供了问答机器人问答相关的一些数据信息，您可以通过不同的时间维度来 查看统计数据。
说明
“问答统计”只统计最近三个月的数据。
如图1-60所示，问答统计按如下几个维度进行统计展示。
● 问答占比统计
如图1-61所示，访问统计按如下几个维度进行统计展示。
● 访问数：指定时间段内用户和智能问答机器人问答会话的个数，每唤起一次机器 人即为一个访问数。
● 独立用户数：指定时间段内不同用户访问智能问答服务的用户个数。
● 平均对话轮数：指定时间段内每个用户平均与问答机器人对话的轮数，其计算公
图1-61 访问统计
热点问题
热点问题指问答机器人在某一段时间内用户问的最多的问题。
热点问题根据用户提问的次数由高到低排序。
图1-62 热点问题
关键词统计
关键词统计提供了指定时间内，用户问中出现频率较高的关键词信息。
如图1-63所示，展示了关键词及其词频，且根据词频由大到小排序。
图1-63 关键词统计
1.9.2 对话分析
您可以定期查看机器人的统计数据和运营数据，并根据数据情况提出解决方案，如补 充知识库、管理词典等措施，来提升对话机器人的体验效果。当前对话机器人服务提 供了对话分析的功能，您可以通过查看对话分析解决现有的对话问题。
对话分析界面入口：
进入对话机器人服务管理控制台，在左侧菜单栏中选择“智能问答机器人”。在机器 人列表中，单击该机器人的ID或者“机器人管理”按钮，进入“运营面板”页面，选 择“对话分析”。
主要包含以下功能：
● 对话日志
● 未解决问题
对话日志
展示机器人在对话体验、接口调用等场景下产生的所有日志。您可以根据日期、问答 类型、用户问关键词、对话ID来筛选搜索对话日志。通过右上角 按钮，导出筛选 的结果，导出的文件需保存在OBS桶内，可跳转至OBS管理页面进行下载查看。可以 通过查看解析日志，来查看机器人对指定问题解析的JSON体。问答类型包括以下几 种：
● 知识-直接命中：机器人直接返回答案。
● 知识-推荐知识：机器人无法直接返回答案，返回推荐的相似问。
● 知识-无效问题：机器人匹配到无效问题。
● 兜底：机器人返回识别失败回复。
● 闲聊：机器人返回闲聊匹配的答案。
● 技能：机器人调用技能返回答案。
● 文档问答：机器人返回匹配的文档答案。
● 表格问答：机器人返回匹配的表格答案。
● 图谱问答：机器人返回匹配的图谱答案。
问答机器人在运营一段时间后，CBS服务将记录用户提问和机器人返回的详细日志，方 便管理员查看机器人实时的问答效果。
系统记录的问答日志如图1-64所示。
图1-64 问答日志
说明
“对话日志”只保存最近三个月数据，如果您需要永久保存，请使用上角 按钮，导出筛选 的结果，并在本地存储。
未解决问题
– 推荐问：机器人无法直接返回答案，返回推荐的相似问。
● 闭环处理操作
– 添加语料：可以把指定问题添加进知识库。
i. 在操作列单击“添加语料”。
ii. 在“添加语料”页面，您可以根据业务情况选择问题类别并填写相关配 置。
iii. 单击“确认”保存语料，新增的语料将呈现在知识库的列表中。
– 关联语料：可以把指定问题关联成某个问题的扩展问。
i. 在操作列单击“关联语料”。
ii. 在“关联语料”页面的搜索框中，输入问题关键词查找对应的语料，然 后勾选此语料。
iii. 单击“确认”保存。
– 忽略：对该问题不做处理，忽略该问题。
1.10 高级设置
1.10.1 基本信息
基本信息主要用于定义机器人个性化形象，如性别、年龄等。建议您根据业务情况，
定义问答机器人的基本属性。机器人识别异常时，可对机器人进行设置。
设置完成后单击右上角“对话体验”，可以在对话体验中查看设置效果。
基本信息
1. 在机器人列表，单击机器人的ID或者“机器人管理”按钮，进入“高级设置 > 基 本信息”页面。
2. 在“基本信息”页面，设置机器人名称、对话发起后的欢迎语，设置后自动保 存。
图1-65 基本信息设置
机器人角色形象设置
在“机器人角色形象设置”页面，设置机器人名字、生日、母亲、父亲等，设置后自
在“机器人角色形象设置”页面，设置机器人名字、生日、母亲、父亲等，设置后自