华为云对话机器人服务CBS对接使用完全指南：从零搭建到API集成

apphuang2026年06月25日 13:30:464

引言：为什么需要对话机器人服务

在当今数字化时代，企业与用户的交互方式正在发生深刻变革。传统的客服模式依赖人工坐席，存在响应速度慢、运营成本高、无法7x24小时服务等痛点。华为云对话机器人服务（Conversational Bot Service，简称CBS）正是为解决这些问题而生的云端AI服务。它基于自然语言处理与机器学习技术，帮助企业快速构建、部署和管理智能问答机器人，实现自动化的用户交互。

CBS的核心价值在于：一方面通过机器自动应答拦截高频、易理解的问题，大幅降低人工客服的负荷；另一方面通过持续的知识库构建和模型训练，不断提升问答准确率，优化用户体验。无论是产品售后支持、使用方法咨询还是疑难解答，CBS都能提供高效的智能化解决方案。

一、CBS服务概述与核心功能

1.1 什么是对话机器人服务CBS

华为云对话机器人服务CBS是一款基于人工智能技术、针对企业应用场景开发的云服务。其核心产品是智能问答机器人（QABot），提供智能对话引擎，通过对机器人知识的配置，可以让机器人回答不同的问题。配置完成后，开发者可以通过API接口的方式将机器人接入已有的对话应用，比如智能客服系统、通讯软件、公众号等，实现智能对话功能。

1.2 核心功能模块

CBS服务包含以下几个核心功能模块：

问答机器人创建：用户可根据业务需求选择基础版、高级版、专业版和旗舰版等不同版本。购买完成后即可开始配置知识库。
知识库与问答语料管理：创建问答机器人语料库，为机器人赋予单轮、FAQ问答能力。机器人预置了闲聊语料库，用户可以在对话体验中输入“你好”、“你叫什么名字”等测试语句。用户可根据不同场景创建不同的语料分类，例如“问候类”、“咨询类”、“故障处理类”。
词典管理：对于词语的不同说法可用词典进行管理。创建完问答语料后，用户可以基于业务配置标准词及同义词，并发布词典。在技能管理中创建意图时，为槽位关联对应词典，将同类同义词统一管理，可以增强用户问泛化和技能理解能力。
模型训练：为了让问答机器人更加智能、回答更加准确，用户可以通过训练模型来提升问答机器人的效果。问答模型训练通过用户问法对机器人进行测试，在匹配问题的返回结果中按相似度得分进行倒序排序。
技能管理：技能是指机器人在某个场景下通过对话可完成的任务，比如订机票、查天气等。通过技能的形式可让机器人完成关键信息的收集，并最终完成用户发出的任务。
对话流程配置：CBS提供图形化的对话流程图功能，用流程图的方式模拟真实的对话场景，完成灵活的多轮对话功能。这大大提高了智能对话系统配置的效率，降低开发者的配置成本。
运营面板：用户可以定期查看机器人的统计数据和运营数据，并根据数据情况提出解决方案，如补充知识库、管理词典等措施来提升对话机器人的体验效果。当前CBS提供了数据总览功能方便用户查看问答数据，提供了对话分析的功能帮助解决现有的对话问题。

需要先登录华为云控制台，点击：华为云控制台，还没有账号，点击：注册并关联，已有账号点击：登录后关联

二、快速入门：从零创建问答机器人

2.1 准备工作

在使用CBS服务之前，需要完成以下准备工作：

已注册华为云账号并完成实名认证，账号不能处于欠费或冻结状态
登录华为云控制台，在人工智能分类下找到“智能问答机器人”服务

2.2 购买问答机器人

创建问答机器人的第一步是购买服务实例。具体操作步骤如下：

登录华为云控制台，在左侧菜单栏中选择“智能问答机器人”
点击“购买问答机器人”按钮进入购买页面
根据实际情况输入问答机器人名称，选择计费模式、规格、路数和机器人有效期
点击“立即购买”，进入订单确认页面，然后点击“去支付”完成购买

华为云提供了试用版本供开发者体验，选择“试用”购买即可快速开始。目前提供的智能问答机器人的版本有基础版、高级版、专业版和旗舰版，用户可根据自己业务的需求选择对应的版本。

2.3 配置知识库与问答语料

购买完成后，需要在知识库中创建问答数据。知识库用于管理问题的类别和所有的问答对。具体配置流程如下：

在“智能问答机器人”页面，点击机器人所在行的“机器人管理”，进入“数据总览”页面
在左侧导航栏中选择“知识库 > 问答管理”
用户可以选择以下两种方式之一添加知识：
- 方式一：逐个新建——点击图标弹出“新建问题类别”对话框，输入问题类别名称（如“闲聊语料”），点击确定。然后点击新建的问题类别，在右侧界面点击“新建”弹出“新建知识”对话框，输入问答内容后点击确定。其中答案必须选择“纯文本”。
- 方式二：批量导入——在问答管理页面单击右侧的“导入”，弹出“导入训练语料”对话框。点击“下载模板”将语料模板下载至本地，按模板格式填写问答对后，点击“添加文件”从本地选择文件，点击“确定”完成导入。
全量导入完成后，单击界面右上方的“对话体验”，输入前面导入的语料对问题，验证语料对导入是否成功

2.4 词典配置

词典管理是提升机器人理解能力的重要环节。对于词语的不同说法，可用词典进行管理。例如，“北京”和“首都”可以被配置为同义词。创建完问答语料后，用户可以基于业务配置标准词及同义词，并发布词典。词典需要发布后才能生效。在技能管理中创建意图时，为槽位关联对应词典，将同类同义词统一管理，可以增强用户问泛化和技能理解能力。

2.5 模型训练与发布

为了让问答机器人更加智能，回答更加准确，用户需要通过训练模型来提升问答机器人的效果。模型训练的具体机制是：通过用户问法对机器人进行测试，在匹配问题的返回结果中按相似度得分进行倒序排序，正确匹配的问题出现在前一、三、五位中的占比将作为衡量模型效果的指标。数值越高代表模型效果越好。

当用户配置好意图后，即可进行模型的训练。训练并发布模型后，该技能才能在机器人的对话中生效。在训练发布前，一定要经过检测。如果检测结果为黄色或红色，鼠标悬浮在检测按钮右侧的检测结果图标上，配置有问题的节点会高亮显示。

三、对接使用方式详解

CBS提供了多种对接使用方式，以满足不同开发场景的需求：通过控制台对话体验直接测试、通过Postman调用API接口、以及通过SDK进行代码集成。

3.1 方式一：控制台对话体验

这是最直观的测试方式，无需编写任何代码。在配置完问答语料后，用户可以通过对话体验的方式直接调用对话机器人。操作步骤如下：

登录对话机器人服务管理控制台
在左侧菜单栏中选择“智能问答机器人”
在机器人列表中找到目标机器人，点击“机器人管理”进入管理页面
点击界面右上方的“对话体验”按钮
在对话框中输入测试问题，验证机器人的回答是否正确

这种方式适合业务人员在配置知识库后快速验证效果，也适合开发者在集成前确认机器人的问答能力是否符合预期。

3.2 方式二：使用Postman调用API

Postman调用方式是零编码快速体验CBS服务API的推荐途径。使用CBS服务API的详细步骤如下：

步骤1：配置环境

下载并安装Postman
下载问答机器人的Postman配置文件
打开Postman，单击左上角“File > Import > Import File > Choose Files”导入配置文件
配置文件导入成功后，将显示在Postman左侧导航栏中

需要注意的是，本配置文件中服务所属区域为“华北-北京四”。如果用户在开通服务时选择了其他区域，需要将配置文件中的所有“cn-north-4”字段替换为实际区域。

步骤2：Token认证鉴权

Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时需要使用Token进行鉴权。具体操作如下：

在Postman左侧导航栏中单击“get-token”配置文件
单击“Body”配置项，填写用户名、密码、账号名
登录“我的凭证”页面，复制IAM用户名、账号名至username、domainname参数处，并填写密码
单击“Send”发送请求，获取并复制Token
获取返回结果“Headers”中的“X-Subject-Token”即为Token，Token有效期为24小时

步骤3：调用服务

在Postman左侧导航栏中单击“ExecuteQaChat”配置文件
登录“我的凭证”，获取“华北-北京四”区域的项目ID，替换配置文件URL中的{project_id}
登录对话机器人服务管理控制台，在左侧菜单栏中选择“智能问答机器人”，在机器人列表复制机器人ID，替换配置文件URL中的{qabot_id}
单击“Headers”配置项，将获取的Token复制到“X-Auth-Token”的参数值中
单击“Body”配置项修改配置文件内容，其中question参数为必填项
单击“Send”发送请求，获取调用结果

3.3 方式三：使用Python SDK集成

对于需要将CBS能力集成到自有应用中的开发者，SDK方式是最佳选择。华为云提供了Python SDK，支持Python3及以上版本。

准备工作

在开始使用SDK之前，需要准备以下信息：

已注册华为云账号并完成实名认证，账号不能处于欠费或冻结状态
已具备开发环境，支持Python3及以上版本
登录“我的凭证 > 访问秘钥”页面，获取Access Key（AK）和Secret Access Key（SK）
登录“我的凭证”页面，获取“IAM用户名”、“账号名”以及待使用区域的“项目ID”
登录对话机器人服务管理控制台，在左侧菜单栏中选择“智能问答机器人”，在机器人列表获取机器人ID（qabot_id）

安装SDK

使用SDK前，需要安装“huaweicloudsdkcore”和“huaweicloudsdkcbs”两个库。支持两种安装方式：

# 使用pip安装
pip install huaweicloudsdkcore
pip install huaweicloudsdkcbs

# 或使用源码安装
cd huaweicloudsdkcore-3.0.89
python setup.py install
cd huaweicloudsdkcbs-3.0.89
python setup.py install

完整代码示例

以下是一个完整的Python SDK调用示例，展示了如何配置客户端、进行认证并发送问答请求：

# 导入依赖模块
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcore.http.http_config import HttpConfig
from huaweicloudsdkcbs.v1.region.cbs_region import CbsRegion
from huaweicloudsdkcbs.v1 import *

# 配置认证信息
# 请替换以下参数为实际值
ak = "your_ak_here"
sk = "your_sk_here"
project_id = "your_project_id_here"
qabot_id = "your_qabot_id_here"

credentials = BasicCredentials(ak, sk, project_id)

# 配置客户端连接参数
config = HttpConfig.get_default_config()

# 可选：配置超时时间（默认连接超时60秒，读取超时120秒）
config.timeout = 120

# 可选：配置网络代理
# config.proxy_protocol = 'http'
# config.proxy_host = 'proxy.huaweicloud.com'
# config.proxy_port = 80

# 创建客户端
client = CbsClient.new_builder() \
    .with_credentials(credentials) \
    .with_region(CbsRegion.CN_NORTH_4) \
    .with_http_config(config) \
    .build()

# 构造请求
try:
    request = ExecuteQaChatRequest()
    request.qabot_id = qabot_id
    
    # 构造请求体
    request.body = QaChatReq(
        question="你好，请问你们有什么产品？",
        # 可选参数
        # domain="",
        # top=10
    )
    
    # 发送请求
    response = client.execute_qa_chat(request)
    
    # 处理响应
    print("答案：", response.answer)
    if response.qa_pairs:
        for qa in response.qa_pairs:
            print("相关问题：", qa.question)
            print("相关答案：", qa.answer)
            
except exceptions.ClientRequestException as e:
    print("请求异常：", e.status_code)
    print("错误码：", e.error_code)
    print("错误信息：", e.error_msg)

代码说明

认证信息：使用AK/SK方式进行认证，需要从“我的凭证”页面获取
区域配置：本示例使用“华北-北京四”区域（CbsRegion.CN_NORTH_4），用户需根据实际部署区域进行修改
请求参数：question为必填参数，其他参数如domain、top等为可选参数
响应处理：返回结果中包含answer（答案）和qa_pairs（相关问答对列表）

四、高级功能：技能配置与多轮对话

4.1 技能概述

技能是指机器人在某个场景下通过对话可完成的任务。通过配置不同技能，可以让机器人进行多轮对话，或完成指定任务，如订票、查天气等。用户还可以自定义技能，也可以将系统预置或其他用户共享的技能加到自己的机器人中直接使用。

4.2 创建技能

在“技能管理”页面，单击“添加技能”即可开始创建。CBS支持以下几种技能类型：

多轮对话技能：根据业务需要，通过自己配置意图、槽位、回复来实现多轮问答
表格问答技能：仅需上传Excel表格，便能获取基于该表格知识的问答技能
预置技能：使用系统已经创建好的技能（如查节日、查天气、成语接龙等），来实现一些通用场景下的多轮问答。系统提供的预置技能可配置在机器人内进行使用，不需要再次训练，但不能对该技能进行修改
共享技能：使用其他用户共享的技能来实现某些特定场景下的多轮问答

多轮对话技能和表格问答技能需要输入技能名称，预置技能或共享技能需要选择技能名称，然后单击“确定”。新创建的技能会显示在“技能管理”页面。

4.3 配置意图与槽位

当创建好一个意图后，需要设置用户问法、槽位信息等，使机器人可以理解用户的这个意图并做出回复。在“意图列表”中单击意图名称进入意图编辑页面。槽位可以关联对应的词典，将同类同义词统一管理，增强用户问泛化和技能理解能力。

4.4 对话流程配置

在智能问答机器人中，配置一个灵活好用的多轮对话流程，需要投入大量的时间和人力。但CBS提供的图形化对话流程图可以大大提高配置效率。对话流程功能用流程图的方式模拟真实的对话场景，来完成灵活的多轮对话功能。对话流程支持以下几种节点类型：

条件判断节点
信息收集节点
接口调用节点
对话回复节点
知识库回复节点
异常回复节点

对话流程配置后，单击按钮可检测当前流程是否有错误。对话流程在训练发布前一定要经过检测。

五、运营监控与优化

5.1 运营面板

用户可以定期查看机器人的统计数据和运营数据，并根据数据情况提出解决方案，如补充知识库、管理词典等措施来提升对话机器人的体验效果。当前CBS提供了数据总览功能方便用户查看问答数据，提供了对话分析的功能帮助解决现有的对话问题。智能问答机器人中的“问答数据”只统计最近三个月的数据。

5.2 常见错误码与排查

在调用CBS服务时，可能会遇到各种错误码。以下是一些常见错误码及其处理措施：

状态码	错误码	错误信息	处理措施
401	CBS.0000	用户无公测权限	请根据界面提示申请公测权限
401	CBS.0011	认证失败	检查Token是否正确，使用正确的Token重新尝试
400	CBS.0021	请求参数异常	检查请求参数字段名，修改正确后重新尝试
400	CBS.1114	服务未开通	根据界面提示开通或购买服务
400	CBS.2114	查询的qabot资源不存在	检查qabot id是否正确，使用正确的id重新尝试
400	CBS.2125	机器人个数超过限制	检查已创建的机器人个数是否已超过3个
400	CBS.3254	RESOURCE_NOT_EXIST_EXCEPTION	调用接口中的区域要与已创建的机器人在同一区域

当遇到“APIGW”开头的错误码时，请参见API网关错误码进行处理。

六、最佳实践与注意事项

6.1 知识库建设建议

建议按照业务场景对问答进行分类管理，例如“问候类”、“咨询类”、“故障处理类”等
定期分析用户的实际提问，将高频问题补充到知识库中
利用词典功能管理同义词，提升机器人的泛化理解能力
批量导入功能适合初始化阶段大量数据的导入，日常维护建议使用逐个新建方式

6.2 模型训练策略

配置好意图后即可进行模型训练
训练并发布模型后，技能才能在机器人的对话中生效
建议定期基于新的问答数据进行模型重新训练，持续优化问答效果

6.3 API调用注意事项

Token有效期为24小时，需要定期刷新
调用接口中的区域要与已创建的机器人在同一区域
项目ID和机器人ID需要从控制台获取并正确配置
建议使用RAM子账号进行API调用，避免主账号密钥泄露风险

6.4 多轮对话设计建议

利用图形化对话流程工具设计复杂的多轮对话场景
对话流程配置后务必进行检测，确保逻辑正确
合理使用条件判断节点、信息收集节点和接口调用节点
预置技能可以直接使用，无需训练即可生效

七、总结

华为云对话机器人服务CBS为企业提供了一套完整的智能问答解决方案。从基础的问答机器人创建、知识库配置，到高级的技能管理与多轮对话设计，CBS覆盖了智能对话系统建设的全生命周期。通过控制台、API和SDK三种对接方式，开发者可以根据自身技术栈和业务需求灵活选择集成方案。配合运营面板的数据分析和持续优化，企业可以构建一个越来越智能的对话系统，有效提升客户服务效率与用户体验。

无论您是初次接触智能问答的新手，还是希望将CBS能力集成到现有系统中的资深开发者，本文提供的从零搭建到API集成的完整指南都能帮助您快速上手。建议从控制台对话体验开始，逐步深入到API调用和SDK集成，最后根据业务需求配置技能和多轮对话，打造属于您自己的智能问答机器人。

常见问题问答

问1：CBS服务是否必须购买OBS才能使用？
答：不一定。CBS服务本身不强制依赖OBS，但知识库的批量导入功能支持从OBS导入文件。如果用户需要通过OBS导入大量语料数据，则需要开通OBS服务。

问2：问答机器人创建后多久可以使用？
答：问答机器人购买完成后即可开始配置知识库。配置完问答语料后，可以通过对话体验功能直接测试。但如果配置了技能，需要训练并发布模型后才能生效。

问3：调用API时出现CBS.3254错误怎么办？
答：该错误表示调用的资源不存在。通常是因为调用接口中的区域与已创建的机器人不在同一区域。请确认调用接口中的项目ID和机器人ID是否与机器人的实际区域匹配。

问4：CBS支持哪些编程语言的SDK？
答：华为云CBS官方提供了Python SDK。此外，用户也可以通过API Explorer自动生成Java、Python、Go等多种语言的SDK代码示例。

问5：Token的有效期是多久？过期了怎么办？
答：Token的有效期为24小时。过期后需要重新调用get-token接口获取新的Token。建议在代码中实现Token的自动刷新机制。

问6：一个账号可以创建多少个问答机器人？
答：默认情况下，一个账号最多可以创建3个问答机器人。如果遇到CBS.2125错误（机器人个数超过限制），需要检查已创建的机器人个数。