华为云用户手册

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 face_sets_info Array of FaceSetInfo objects 人脸库信息集合，详见FaceSetInfo。 调用失败时无此字段。 表4 FaceSetInfo 参数 参数类型 描述 face_number Integer 人脸库中已有的人脸特征的数量。 external_fields Object 用户的自定义字段。 face_set_id String 人脸库ID，随机生成的包含八个字符的字符串。 face_set_name String 人脸库名称。 create_date String 创建时间。 face_set_capacity Integer 人脸库最大的容量。创建人脸库时，请求参数如果不设置face_set_capacity参数，默认每个人脸库最大容量为10万个人脸特征。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 error_code String 调用失败时的错误码，具体请参考错误码。 调用成功时无此字段。 error_msg String 调用失败时的错误信息。 调用成功时无此字段。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 人脸检测API的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://face.cn-north-4.myhuaweicloud.com/v2/{project_id}/face-detect

Token认证 需要使用同一个Token鉴权时，可以缓存起来，避免频繁调用。 关于Token有效期的详细说明请参见获取 IAM 用户Token（使用密码）。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 username、domainname、project name可登录控制台“我的凭证”页面获取。password为用户密码。 获取Token 时，如果出现账密报错“The username or password is wrong.”，请参见如何处理账密报错。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokensContent-Type: application/jsonRequest Body:{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "project name" } } } } 如下图所示，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。获取Token之后，您就可以使用Token认证调用FRS服务API。 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。 图1 获取用户Token响应消息头

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token请参考认证鉴权。 添加消息头后的请求如下所示。 POST https://face.cn-north-4.myhuaweicloud.com/v2/{project_id}/face-detectContent-Type: application/jsonx-auth-token: MIIaBgYJKoZIhvcNAQcC…

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 例如，对于人脸检测接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示。 POST https://face.cn-north-4.myhuaweicloud.com/v2/{project_id}/face-detectRequest Header:Content-Type: application/jsonX-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDT...Request Body:{ "image_base64": "/9j/4AAQSkZJRgABAgEASABIAAD...", "attributes": "2,12,13"} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12MB以内，12MB以上的请求请使用Token认证。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 AK/SK获取方式请参考获取AK/SK。

其他操作 删除 在问题类别区域，选中待删除的问题类别名称，单击删除问题类别。 在“删除问题类别”弹窗中单击“确定”。 图2 删除问题类别 编辑 在问题类别区域，选中待编辑的问题类别名称，单击编辑问题类别。 在“编辑问题类别”弹窗中单击“确定”。 图3 编辑类别 刷新 在问题类别区域，单击刷新问题类别列表。 查找 在问题类别区域，在查找框中输入问题类别名称，单击查找。 图4 查找问题类别 添加子级类别 鼠标悬浮在某一类别时，单击类别名称右侧的可新建子级类别。

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 表1 请求URI 参数 说明 URI-scheme 传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 承载REST服务端点的服务器 域名 或IP，不同服务在不同区域时，对应Endpoint不同，可以从终端节点中获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取。 例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 例如调用人脸检测接口，API的resource-path为“/v2/{project_id}/face-detect”。 query-string 查询参数，可选，查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如，您需要在“华北-北京四”区域调用人脸检测API，URI如下所示。其中face.cn-north-4.myhuaweicloud.com表示“华北-北京四”区域的Endpoint，{project_id}表示与区域对应的项目id，可在“我的凭证”页面获取。 https://face.cn-north-4.myhuaweicloud.com/v2/{project_id}/face-detect 图1 URI示意图 为查看方便，服务每个具体API的URI，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

问答统计 问答统计提供了 问答机器人 问答相关的一些数据信息，您可以通过不同的时间维度来查看统计数据。 “问答统计”只统计最近三个月的数据。 如图1所示，问答统计按如下几个维度进行统计展示。 问答占比统计 问答类型分为“对话技能”、“直接命中问题”、“推荐问题”、“无效问题”、“闲聊”、“兜底”，此处展示了每一类问答的回答次数，并通过饼图的样式展示。 对话技能：机器人对话体验过程中，调用技能进行对话的次数。 直接命中问题：用户提的问题，机器人匹配到知识库中的问题，直接返回答案。 推荐问题：用户提的问题，机器人匹配到知识库中的多个问题，返回推荐的所有相似问题。 无效问题：用户提的问题，机器人匹配到知识库中的无效问题。 闲聊：用户提的问题，机器人匹配到知识库中的闲聊问题，返回闲聊的答案。 兜底：当机器人无法理解用户的问题时，机器人会按照设置的识别失败回复进行回复响应。 问答次数趋势统计 根据指定的时间，使用折线图展示问答次数的趋势。 问答占比趋势统计 根据指定的时间，使用折线图展示问答占比的趋势。 图1 问答统计

访问统计 访问统计提供了用户访问和使用问答机器人的一些统计信息。 如图2所示，访问统计按如下几个维度进行统计展示。 访问数：指定时间段内用户和 智能问答机器人 问答会话的个数，每唤起一次机器人即为一个访问数。 独立用户数：指定时间段内不同用户访问智能问答服务的用户个数。 平均对话轮数：指定时间段内每个用户平均与问答机器人对话的轮数，其计算公式为：用户与问答机器人进行问答的总次数/指定时间段内用户访问智能问答机器人的总次数。 平均访问时长：指定时间段内每个用户平均访问的时长，单位为秒，其计算公式为：访问问答机器人的总时间/指定时间段内访问智能问答机器人的用户数。 访问数趋势统计：以折线图的形式展示了指定时间段内，总访问数和独立用户数的数据趋势。 平均对话轮数趋势统计：以折线图的形式展示了指定时间段内平均对话轮数。 平均访问时长趋势统计：以折线图的形式展示了指定时间段内平均访问时长。 图2 访问统计

新建对话回复节点 在机器人与用户的对话流程中，完成处理节点后，您需要配置回复节点，用来表示机器人回复用户的内容。您可以插入变量或者槽位，编辑回复术语。对话流程的终结节点，必须以回复节点结束。 在左上角节点列表中，拖拽“对话回复”节点到中间空白区域，同时界面右侧展开“对话回复”页签。 图1 对话回复 设置节点名称、回复信息、变量、槽位等信息。 对话回复的内容可以插入变量、插入槽位，并填充变量和槽位之间的文本使其构成一个完整的语句。例如：[S:check_weather-城市][S:check_weather-时间]的天气是[V:weather]，表示机器人回复的术语可以是“北京2020.07.07的天气是多云”。 表1 参数说明 参数名称 参数说明 取值范围 插入变量 选择变量，并关联对应的变量信息。 只支持由大小写字母、数字、汉字以及部分符号（“_”、“-”、“#”）组成，输入长度为1~63字符。 插入槽位 选择意图，并关联对应的槽位信息。 意图下的所有槽位。 父主题： 配置对话流程（可选）

创建意图 在“技能管理”页面，单击技能名称进入“配置意图”页面。 在“配置意图”页面，单击“创建”，弹出“创建意图”对话框。 图1 创建意图 根据实际需要，输入“意图标识”、“意图名称”和“描述”信息。 意图标识：只支持由大小写字母、数字、及部分符号（“_”）组成，输入长度为1~63字符。必须以字母开头，创建后不支持修改。 意图名称：只支持由大小写字母、数字、汉字以及部分符号（“_”、“-”、“#”）组成，输入长度为1~63字符，名称创建后可修改。 描述：最多不能超过255个字符。 单击“确认并继续设置”，进入“编辑意图”页面，具体操作请参见编辑意图。

编辑意图 当您创建好一个意图，您需要设置用户问法、槽位信息、机器人回复等，使机器人可以理解用户的这个意图，并做出回复。 在“配置意图”页面，单击意图名称，进入“编辑意图”页面。 设置意图基本信息。 可以修改“意图名称”、“描述”信息，“意图标识”不支持修改。 设置用户问法。 用户问法即用户在让机器人执行该意图时，经常使用的问法。可以添加语料，也可以添加一些规则来增强机器人识别能力。 用户问法语料 通过添加用户常用问法，训练模型泛化语料，从而让机器人理解用户的意图。 在输入框中输入常用问法，单击“添加”，下方显示添加的问法信息。也可以单击“批量添加用户问法语料”，根据示例批量添加语料，然后单击“确定”。 图2 添加用户问法 您可以选择在配置意图时添加问法语料，也可以在创建训练集时添加训练语料，请参见创建训练集章节操作。 用户问法模板 通过添加关键字词，匹配用户问法，从而让机器人理解用户的意图。 单击“添加模板”，弹出“添加模板”对话框。 图3 添加模板 在输入框中输入模板内容。 其中“[]”用于分隔不同词语；“|”用于分隔多个同义词；“[W:1-10]”用于通配占位，数字代表字符个数区间，支持0-99之间的数字。规则中可添加已创建的槽位，或预置的常用词组。从而可以更多的匹配到用户问中相关的信息。 例如：“[W:1-10][查][北京|南京]的天气”表示查询北京或者南京的天气，可匹配“帮我查北京的天气”。 选择模板的匹配规则。 包含：表示用户问法要包含符合模板格式的内容。 完全匹配：表示用户问必须和用户问法模板一模一样。 添加槽位。 触发意图的关键信息即为槽位。比如“查询北京的天气”语料，为“北京”关联名为“城市”的槽位。每个槽位都需要对应词典才可以使用。每个槽位必须对应1个或多个词典，这样机器人才能从用户问中提取槽位信息。 单击“添加槽位”，弹出“添加槽位”对话框。 图4 添加槽位 根据如下参数添加槽位信息。 表1 添加槽位页面参数说明 名称 说明 关联槽位 不同意图间可复用同一槽位，可达到槽位值传递的效果。如不需要，可选择不关联。 例如，查温度意图中添加了地点槽位A，查气象意图中同样添加了地点槽位B并关联了查温度中的地点槽位A。这样当用户查完温度后，再查气象时，无需再说明地点信息。机器人会默认查气象的地点为查温度时所使用的地点。 槽位标识 表示槽位的唯一ID，用于关联槽位。 当“关联槽位”参数设置为“不关联”，则需要用户自定义槽位标识，用于区分槽位。 槽位名称 槽位的名称。 是否必须 是：表示机器人如果要完成当前意图任务，则必须获得该信息，如果用户未能提供，机器人会通过添加的追问话术进行追问。可以选择不同追问轮数，配置不同话术进行追问。 否：表示机器人即便无法获得该信息，也可以完成当前意图任务。可以设置默认值，如果用户未填充该槽位，会默认使用该默认值。 词典选择 选择现有词典 在可选择词典中，单击需要的词典，添加至右侧已选择词典。 对已选择的自定义词典可勾选答案候选，勾选后，机器人在追问用户时，会将所选词典中的词条取10个作为候选答案展示给用户，供用户选择。 通过“刷新”按钮，刷新可选词典框。 通过“新建”按钮，跳转到新建词典页面。 在添加的用户问法语料中，添加滑词，标注槽位。 您需要先添加槽位，再标注槽位。添加槽位操作可参考添加槽位。 鼠标左键滑动选中关键词，显示“选择槽位”悬浮框，悬浮窗中会显示槽位管理中配置的所有槽位，单击需要标注的槽位即可。 图5 标注槽位 如果需要取消槽位，鼠标左键单击问法中标记的滑词，显示悬浮框，单击右上角的删除按钮即可。 设置机器人回复。 图6 机器人回复 文本回复 机器人在识别到用户的意图并完成槽位收集后，进行文本类型的回复。 您可以选择在文本回复中插入槽位的取值，机器人则会使用该槽位被填充的值进行回复。 引用知识库回复 机器人在识别到用户的意图并完成槽位收集后，引用添加的问答进行回复。 您需要事先在知识库中创建问答，具体请参见管理问答语料。创建后，可通过搜索框搜索问题关键字，并选择需要引用的问题。如果该问题有多个答案，可选择默认答案即配置的第一个答案或随机答案进行回复，也可指定某个答案进行回复。 调用函数回复 机器人在识别到用户的意图并完成槽位收集后，调用函数进行回复。 您需要事先在 函数工作流 中创建函数。创建后，可下拉进行选择。调用函数时会将槽位收集的结果作为参数引入，用户可以在函数中使用槽位信息。通过函数回复可以调用其他已有的内容或让机器人做复杂的逻辑处理。 设置意图跳转。 如果需要机器人在执行当前意图任务时，主动转移到其他意图可通过配置意图跳转规则实现。比如，在机器人在执行查询空闲会议室意图时，主动跳转到预定会议室意图。 图7 意图跳转 单击“新增意图跳转”，显示跳转规则设置。 选择需要主动跳转的目标意图。 设置跳转的条件，包括槽位检测和函数返回值检测。 槽位检测：可根据槽位取值的具体情况作为跳转条件。 函数返回值检测：如果您选择了调用函数回复，则可以选择该条件，即可以根据函数返回值的具体情况作为跳转条件。多个条件间是“与”关系。多个规则组间是“或”关系。 单击“保存”，保存设置信息。

新建知识库回复节点 在机器人与用户的对话流程中，完成处理节点后，您可以引用知识库中已有的问题的答案作为机器人的回复内容。对话流程的终结节点，必须以回复节点结束。 在左上角节点列表中，拖拽“知识库回复”节点到中间空白区域，同时界面右侧展开“知识库回复”页签。 图1 知识库回复 设置节点名称、问题信息。 展开问题下拉框，在搜索框中搜索问题，系统会关联出知识库中该问题，选择该问题。 父主题： 配置对话流程（可选）

新建信息收集节点 在机器人与用户的对话过程中，机器人需要收集用户问题中的关键信息，可通过配置信息收集节点，对用户的问题进行追问，并获取需要的内容。 在左上角节点列表中，拖拽“信息收集”节点到中间空白区域，同时界面右侧展开“信息收集”页签。 图1 信息收集 设置节点名称、在槽位管理下拉框中选择对应的意图。 选择意图后，会将意图中创建的槽位及追问话术等信息同步至此处。可对这些信息进行修改，修改后只在当前节点生效，不会影响原意图的槽位设置。 如果意图中设置了槽位信息，系统会展示该意图下所有的槽位，请根据表表1配置收集该意图相关的槽位信息。 表1 参数说明 参数名称 参数说明 取值 取值保留时间 槽位信息在被收集后，系统保留该信息的时间。 取值保留时间的取值如下： 关闭对话后清空：当用户关闭对话弹窗或重置对话后，清空槽位的取值信息。其他情况，不清空。 流程结束后清空：当用户结束当前对话流程后，清空槽位的取值信息。 流程中断跳出后清空：当用户中断流程后跳出，清空槽位的取值信息。 是否必须 用户问题中槽位信息是否必须出现。 取值如下： 是：必须槽位，当用户在对话中未提供槽位信息时，机器人会根据设置的话术进行追问 否：非必须槽位，当用户在对话中未提供槽位信息时，机器人不会追问。 追问轮数 与用户对话中可以追问的轮数。 取值如下： 1 2 3 追问话术 追问用户的问题。 有效字符串。 父主题： 配置对话流程（可选）

标签应用 例如：西安地区和杭州地区班车时间不同，分别创建标签“西安”和“杭州”。西安用户在查询班车时，系统自动返回带有西安标签的班车时间；杭州用户在查询班车时，系统自动返回带有杭州标签的班车时间。 图5 创建标签 创建班车查询语料，答案区分西安和杭州标签： 图6 创建问答语料 进入 API Explorer 接口调试页面，调试问答效果。调用操作可参考使用API Explorer调用API。 以调用杭州标签为例说明： 在“extends”参数中输入杭州的标签ID，如图7红框所示，响应结果中仅包含杭州班车时间表。 图7 调试结果

智能问答机器人简介 问答机器人可提供智能对话引擎，通过对机器人知识的配置，可以让机器人回答不同的问题。配置后，您可以通过API接口的方式接入已有的对话应用，比如智能客服、通讯软件、公众号等，以实现智能对话的功能。 在使用智能问答机器人之前，需要您先购买智能问答机器人，目前提供的智能问答机器人的版本有专业版和旗舰版，您可根据自己业务的需求选择对应的版本。 图1 智能问答机器人使用流程图 表1 智能问答机器人使用流程说明 流程 说明 操作指导 创建问答机器人 选择购买专业版或旗舰版智能问答机器人。 问答接口调用默认按调用次数计费，也可以购买接口调用优惠套餐包。 购买问答机器人 购买问答接口调用套餐（可选） 管理问答语料 当您创建好智能问答机器人后，需要在知识库中创建问答数据。 创建问题类别 新建问答语料 实体管理（可选） 创建好问答数据后，您需要设置实体信息，方便管理标准词和同义词。 实体管理（可选） 问答模型训练（可选） 为了让问答机器人更加智能，回答更加准确，您可以通过训练模型来提升问答机器人的效果。 新建模型 上线模型 调整阈值 调用问答机器人 在配置完问答数据后，您可以通过对话体验的方式直接调用 对话机器人 ，为客户提供问答服务。 您可以通过调用API接口进行二次开发，为您提供使用Postman和API Explorer调用API接口的方法。 对话体验 调用API 问答诊断 当问答机器人上线运营期间，您可以通过“问答诊断”功能，查看机器人对用户问题的分词、排序、答复过程，基于调试结果，对已有的知识库、词典、数据标注或模型进行优化。 问答诊断 运营面板 您可以通过问答数据总览功能定期查看机器人的统计数据：问答统计、访问统计、热点问题、关键词统计。 还可以定期查看机器人的对话日志和未解决问题，并根据数据情况提出解决方案。如补充知识库、管理词典等措施，来提升对话机器人的体验效果。 数据总览 对话分析 父主题： 智能问答机器人

使用流程介绍 图1 使用流程图 表1 使用流程说明 流程 说明 操作指导 创建简单对话 技能是指完成某个特定功能的能力。如构建一个订机票、查询天气的机器人。 通过配置不同技能，可以让您的机器人进行多轮对话，或完成指定任务，如订票、查天气等。您还可以自定义技能，也可以将系统预置或其他用户共享的技能加到自己的机器人中，直接使用。 创建技能 配置意图 配置对话流程（可选） 在智能问答机器人中，配置一个灵活好用的多轮对话流程，需要投入大量的时间和人力。但是一个图形化对话流程图可以大大提高智能对话系统配置的效率，提升多轮对话的效果，降低开发者的配置成本。因此， 对话机器人服务 提供对话流程功能，用流程图的方式，模拟真实的对话场景，来完成灵活的多轮对话功能。 新建条件判断节点 新建信息收集节点 新建接口调用节点 新建对话回复节点 新建知识库回复节点 异常回复 检测对话流程 训练发布 进行数据标注前，需要先创建训练集。 训练集是对话语料的集合，类似文件夹的作用，可以将不同来源或者不同时段获取的对话语料放在不同的对话训练集中。 当您有大量的语料信息时，可通过创建训练集、导入语料并标注语料的方式配置训练集。 选择用户常用问法或训练集训练版本，配置合适的阈值，版本训练发布成功，技能变为“运行中”状态后，才可以进行对话体验。 数据标注（可选） 发布测试 对话体验 完成配置后，通过对话体验，检测配置是否可以让机器人准确的回答用户问题。 对话体验

调整阈值效果示例 阈值调整前，推荐问阈值为0.6，直接回答阈值为0.8，输入用户问“我可以去哪办理”，机器人返回相似度得分大于0.8的标准问给用户，并推荐相似度得分大于0.6的标准问： 图8 阈值调整前 单击“查看JSON”，查看具体的相似度得分。 图9 查看相似度得分 阈值调整后，推荐问阈值为0.7，直接回答阈值为0.9，输入用户问“我可以去哪办理”，语料库中没有与用户问相似度得分高于0.9的标准问，机器人返回相似度得分高于0.7的标准问： 图10 阈值调整后 单击“查看JSON”，查看具体的相似度得分。 图11 查看相似度得分

调整阈值 训练好的模型可以通过调整阈值，影响机器人直接回答的准确率。阈值越高，机器人越严谨，对用户问的泛化能力越弱，识别准确率越高；阈值越低，机器人越开放，对用户问的泛化能力越强，识别准确率越低。 针对历史版本的模型，可以根据当前模型调节直接返回答案的阈值。 在“模型管理”页面，在模型列表的操作列单击“调整阈值”。 图6 调整阈值 如下图所示，您可以根据实际需求，选择合适的阈值，然后单击“确定”。 用户问法与标准问的相似度大于直接回答阈值时，直接返回相应答案。 用户问法与标准问的相似度大于推荐问阈值时（小于直接回答阈值），返回相似度较高的标准问给用户再次确定用户意图。 用户问法与标准问的相似度小于推荐问阈值时，返回识别失败回复话术。 图7 设置阈值

新建条件判断节点 在多轮对话中，机器人需要根据用户的不同输入，进行相应的回复和逻辑处理。因此，对话流程中提供条件判断节点，该节点可自定义用户的不同输入作为条件分支，引导后续的对话流程。条件判断节点中同一个分支内可增加多种条件，包括“或”、“且”条件。 在左上角节点列表中，拖拽“条件判断”节点到中间空白区域，同时界面右侧展开“条件判断”页签。 图1 条件判断 单击“添加条件分支”，根据表1配置条件分支的相关信息。 表1 参数说明 判断范围 说明 取值 意图识别 在对话流程中，机器人识别到的用户意图为判断类型。意图识别的取值可选择命中或未命中某个意图，也可选择机器人是否理解用户的意图。 当您以意图识别为判断类型时，需要选择指定意图，判断意图的逻辑取值如下： 等于：表示在用户的问题中识别出指定意图名称。 不等于：表示在用户的问题中识别不到指定意图名称。 为空：表示在用户的问题中识别不到任何意图，该参数不需要指定意图。 不为空：表示在用户的问题中识别到系统中任意一个意图，该参数不需要指定意图。 信息收集 机器人收集到的槽位信息为判断类型。信息收集的取值可选择指定槽位的填充状态，或对填充值进行数值比较。 当您以信息收集为判断类型时，需要选择指定意图及槽位，并输入槽位的取值信息，判断槽位的逻辑取值如下： 等于：表示在用户的问题中识别出指定槽位的取值信息。 不等于：表示在用户的问题中识别不到指定槽位的取值信息。 已填充：表示在用户的问题中已填充指定槽位的取值信息。 未填充：表示在用户的问题中未填充指定槽位的取值信息。 包含：表示在用户的问题中包含指定槽位的取值信息。 不包含：表示在用户的问题中不包含指定槽位的取值信息。 大于：表示在用户的问题中大于指定槽位的取值信息。 小于：表示在用户的问题中小于指定槽位的取值信息。 接口返回 以接口调用节点，调用后，接口返回的信息为判断类型。接口返回的参数值与填写的数值进行比较。 当您以接口返回为判断类型时，需要输入参数名称，并填写参数取值信息，判断参数的逻辑取值如下： 等于：表示在接口返回时，参数名称必须为指定的参数取值信息。 不等于：表示在接口返回时，参数名称不能为指定的参数取值信息。 包含：表示在接口返回时，参数名称包含指定的参数取值信息。 不包含：表示在接口返回时，参数名称不包含指定的参数取值信息。 机器人回复 以上一轮对话中，机器人回复用户的内容为判断类型。机器人回复的取值可对上轮机器人回复的内容做判断。 当您以机器人回复为判断类型时，需要输入机器人回复信息，判断回复的逻辑取值如下： 等于：表示机器人回复时是输入的回复信息。 不等于：表示机器人回复时不是输入的回复信息。 包含：表示机器人回复的语句中包含输入的回复信息。 不包含：表示机器人回复的语句中不包含输入的回复信息。 用户回复 以上一轮对话中，用户回复的内容为判断类型。用户回复的取值可对上轮用户回复的内容做判断。 当您以用户回复为判断类型时，需要填写用户回复信息，判断回复的逻辑取值如下： 等于：表示用户回复时是输入的回复信息。 不等于：表示用户回复时不是输入的回复信息。 包含：表示用户回复的语句中包含输入的回复信息。 不包含：表示用户回复的语句中不包含输入的回复信息。 肯否表达：表示用户回复的语句中有肯定或者否定的信息 可以删除单个条件，也可删除整个分支。删除分支后，对应的连线也将被删除。 父主题： 配置对话流程（可选）

标注意图及槽位 添加训练语料之后，您需要为语料标注意图及槽位，并确认标注。 在“数据标注”页面，单击左侧训练集名称，进入对应的训练集管理页面。 图5 训练集管理 在“标注意图”列，单击下拉框，设置训练语料的意图。设置意图完成后，标注状态会变更为待确认。 下拉框中sys.other为负例，用来标注需要过滤掉的语料。 在“训练语料”列，选中关键词，出现“选择槽位”悬浮框，设置相应槽位。 槽位设置具体操作请参见配置意图章节。 图6 选择槽位 单击操作列“确认标注”，状态变更为已标注，即表示标注完成。在技能训练时，只会使用状态为已标注的训练语料进行训练。

新建接口调用节点 在对话流程中，如果需要对接外部内容，或其他业务系统可使用接口调用节点，通过接口调用节点，使机器人能够准确回答用户的问题。 在左上角节点列表中，拖拽“接口调用”节点到中间空白区域，同时界面右侧展开“接口调用”页签。 图1 接口调用 根据表1设置节点名称、模式（配置模式或者函数模式）、请求方式、调用地址及入参和出参信息。 表1 参数说明 参数名称 参数说明 取值 模式 包含配置模式和函数模式。 配置模式 通过可视化的配置，完成调用地址，请求方式，出入参的设置。 函数模式 通过填写完整函数的方式，调用其他资源。 入参设置 入参设置非必填。 如果需要向接口地址传递参数时，可通过以下取值方式设置入参信息。 自定义取值 根据槽位取值 根据变量取值 出参设置 出参设置非必填。 如果需要获取接口返回的内容，可通过以下赋值设置出参信息。出参的字段支持JSON体，可用datetime.date、datetime.time的方式来配置指定字段。 赋值给槽位 赋值给变量 父主题： 配置对话流程（可选）

其他操作 批量操作 在“数据标注”页面，单击左侧训练集名称，进入对应的训练集管理页面。 勾选训练语料，单击“批量操作”，可以执行批量标注意图、批量确认标注、批量删除操作。 图7 批量操作 编辑 在“数据标注”页面，单击左侧训练集名称，进入对应的训练集管理页面，可以编辑训练集名称和训练语料。 图8 编辑训练集 删除 当某一训练集不再匹配业务诉求，您可以删除该训练集以释放资源。 在“数据标注”页面，鼠标悬浮在训练集名称上，单击删除图标。 图9 删除训练集 在删除训练集对话框中，单击“确认”。

查看问答机器人 购买的机器人，会显示在您对话机器人服务控制台中，智能问答机器人的列表里。在问答机器人列表右上角，您可以选择机器人状态筛选您购买的机器人，或者输入名称关键字，单击进行查找。对于包年包月的机器人，可以进行机器人管理、续费、规格修改。 机器人管理：进入机器人配置界面，给机器人创建问答语料、问答训练、创建技能、创建词典、高级设置、查看机器人运营数据等。 续费：可以在现有规格上，继续购买使用时长。 规格修改：可以修改当前使用规格，只支持升级规格，不支持规格降级。升级规格会根据剩余可用时长折算费用。 图4 查看问答机器人

购买问答机器人 进入CBS服务管理控制台，在左侧导航栏中选择“智能问答机器人”，然后单击右上角的“购买问答机器人”。 进入购买问答机器人页面，填写机器人相关信息。界面下方将显示购买机器人的费用参考。 图1 购买问答机器人 问答机器人名称：可以作为机器人的唯一标识。由大小写字母、数字、汉字及部分特殊(“_”、“-”、“#”)字符组成，长度为1~63位，如“对话机器人demo1”。 计费模式：当前提供包年包月模式。 包年包月：按时间维度购买机器人。支持自动续费，续费周期与原订单一致。 自动续费：勾选后，机器人到期后自动续费，自动续费周期与原订单周期一致。 规格：当前提供专业版、旗舰版两种规格。 专业版：适合企业复杂对话流程，需要多轮对话的场景。包括以下功能模块： 包含高级版所有功能，以及多轮技能管理、知识共享、应用授权。 旗舰版：适用于对机器人答准率有高要求，数据样本大的场景。包括以下功能模块：包含专业版所有功能，以及重量级深度学习模型训练。 路数：表示这个机器人可以同时进行n路对话，即能够同时和n个用户对话。您可以根据自己业务量大小决定路数多少。 机器人有效期：可以设置机器人的使用时长。 单击右下角“立即购买”，进入“订单确定”页面。 在“订单确定”页面，确认订单详情无误之后，单击“去支付”完成问答机器人购买。 在问答机器人列表中，刚购买的问答机器人显示状态为“创建中”，待机器人创建完成，状态将自动变更为“可用”状态。如下图所示。 图2 问答机器人列表

添加训练语料 训练集创建完成后，您需要给训练集中添加训练语料，提供手工添加和批量导入两种训练语料添加方式，根据您的需要选择。 方式一：手工添加训练语料 在“数据标注”页面，单击左侧训练集名称，进入对应的训练集管理页面。 在页面上方输入框中输入训练语料并按回车，或者输入训练语料后单击“添加”，自动添加至训练语料列表。 图2 输入训练语料 方式二：批量导入训练语料 在“数据标注”页面，单击左侧训练集名称，进入对应的训练集管理页面。 单击左上方“导入训练语料”按钮。 图3 单击“导入训练语料” 单击“添加文件”添加需要导入的文件。 您可以通过“下载模板”，下载文件模板填写数据。 图4 导入训练语料 设置导入模式。 导入模式有两种：追加和覆盖。 选择追加模式不会对原语料造成影响。 选择覆盖模式将删除原语料。 单击“确定”。 导入成功后，在训练语料列表中显示导入的语料信息。

购买问答接口调用套餐（可选） 购买问答机器人后，调用机器人接口默认按调用次数计费。当前开放接口调用套餐，其费用比单次调用计费优惠，推荐您在购买机器人之后，同时购买问答接口调用套餐。 在CBS服务管理控制台中，在左侧导航栏中选择“智能问答机器人”，然后单击右上角的“购买问答接口调用套餐”。 进入购买问答接口调用套餐页面，填写机器人相关信息。界面下方将显示费用参考。 调用次数：当前支持“10万次”、“100万次”、“1000万次”、“6000万次”、“1亿次”、“3亿次”的规格，建议您根据自身业务需求进行购买。 套餐包有效期：1年。 图3 购买问答接口调用套餐 单击右下角“立即购买”，进入“订单确定”页面。 在“订单确定”页面，确认订单详情无误之后，单击“去支付”完成购买。

对话日志 展示机器人在对话体验、接口调用等场景下产生的所有日志。您可以根据日期、问答类型、用户问关键词、对话ID来筛选搜索对话日志。通过右上角按钮，导出筛选的结果，导出的文件需保存在OBS桶内，可跳转至OBS管理页面进行下载查看。可以通过查看解析日志，来查看机器人对指定问题解析的JSON体。问答类型包括以下几种： 知识-直接命中：机器人直接返回答案。 知识-推荐知识：机器人无法直接返回答案，返回推荐的相似问。 知识-无效问题：机器人匹配到无效问题。 兜底：机器人返回识别失败回复。 闲聊：机器人返回闲聊匹配的答案。 技能：机器人调用技能返回答案。 文档问答：机器人返回匹配的文档答案。 表格问答：机器人返回匹配的表格答案。 图谱问答：机器人返回匹配的图谱答案。 问答机器人在运营一段时间后，CBS服务将记录用户提问和机器人返回的详细日志，方便管理员查看机器人实时的问答效果。 系统记录的问答日志如图1所示。 图1 问答日志 “对话日志”只保存最近三个月数据，如果您需要永久保存，请使用上角按钮，导出筛选的结果，并在本地存储。

未解决问题 机器人在使用过程中，会自动整理未解决的用户问，并会自动把意思相近的用户问做聚类处理，同时展示重复次数，您可以根据重复次数进行排序。另外您也可以根据时间、操作状态、问题类型、问题关键字来筛选搜索这些问题，然后对这些问题闭环处理。建议您定期处理未解决问题，以提升问答效果。 未解决问题类型 兜底：机器人返回识别失败回复。 不满意：机器人为用户找到对应答案后，用户选择对答案不满意的问题。 转人工：需要通过人工方式解决的问题。 推荐问：机器人无法直接返回答案，返回推荐的相似问。 闭环处理操作 添加语料：可以把指定问题添加进知识库。 在操作列单击“添加语料”。 在“添加语料”页面，您可以根据业务情况选择问题类别并填写相关配置。 单击“确认”保存语料，新增的语料将呈现在知识库的列表中。 关联语料：可以把指定问题关联成某个问题的扩展问。 在操作列单击“关联语料”。 在“关联语料”页面的搜索框中，输入问题关键词查找对应的语料，然后勾选此语料。 单击“确认”保存。 忽略：对该问题不做处理，忽略该问题。