一、案例介绍

借助华为云对话机器人服务 CBS您可以零代码创建一个大模型 RAG (Retrieval-Augmented Generation，即检索增强生成)应用，来实现 AI 助手的智能问答能力。

本实验借助华为云CBS提供的可访问API，在项目代码中通过几行代码引入 AI 助手，用户就可以在网站上看到一个 AI 助手，实现与之对话。

二、免费领取云主机

如您还没有云主机，可点击链接 ，根据领取指南进行操作。

如您已领取云主机，可直接开始实验。

三、实验流程

说明：

1、用户创建智能机器人，增加私有知识；

2、准备SDK接入信息；

3、在CodeArts IDE 上开发Web项目；

4、在Web项目添加调用智能问答机器人服务的SDK；

5、为了便于分享给其他人访问使用，可以将Web项目部署在弹性云服务器上。

实验资源

本次实验花费总计为1.1元，资源采取按需计费，体验结束后，请及时释放资源，避免产生多余费用，给您带来不便。

四、为Web项目添加AI助手

4.1 创建智能问答机器人

1、在浏览器中输入华为云网址：https://www.huaweicloud.com/ 进入华为云首页。

2、在华为云的首页右上方，点击“登录”，在弹出的对话框中输入自己的用户名和密码。

3、在华为云首页，依次选择“产品”>“人工智能”>“智能问答机器人”，进入智能问答机器人 QABot页面。

4、点击“立即使用”按钮进入管理页面。

5、点击“购买问答机器人”按钮进入购买页面。

6、选择“试用”购买即可。

4.2 增加私有知识

登录对话机器人服务管理控制台 ，在左侧菜单栏中选择“智能问答机器人”。在机器人列表，点击“机器人管理”进入管理页面，页面如下图所示。

对问答机器人添加私有知识可以从知识库和技能平台两个方面入手：

知识库

在“问答机器人”页面左侧导航栏中选择“知识库 > 问答管理”，在问答管理页面执行如下操作：

1、在问答管理中单击按钮新建问题分类，例如“IT问题”。

2、在问答管理中单击“新建”创建问答语料，详细创建过程请参见管理问答语料 。

这里我们输入几个问答语料，在后面测试的时候使用。

Q：忘记密码怎么办

A：‌通过安全模式重置密码‌（无需密码重置磁盘）

Q: 蓝屏了怎么办

A：蓝屏后请重启PC，重启无效后，建议联系技术支持人员

技能平台

在“问答机器人”页面左侧导航栏中选择“技能平台 > 技能管理”，在技能管理页面执行如下操作：

1.点击“添加技能”按钮选择感兴趣的类型，建议从“预置技能”入手，点击下一步，选择感兴趣的技能，点击确定完成配置。

4.3 部署Web项目

本小节需要部署一个Python Web项目，可以是自己的项目，如果没有项目可以使用示例项目，代码地址如下：

git clone https：//github.com/nishaotang/huawei_cbs_demo.git

1、进入云主机 ，打开终端。

2、执行命令安装python：

sudo apt-get install python-is-python3

3、验证python是否安装完成，出现图片所示表示我们python的环境变量已经配置完成：

python

4、打开CodeArts IDE，点击“打开项目”选择事先准备好的python Web项目文件夹点击“打开“按钮，等待加载完毕。

5、本样例以Python Flask框架为例。在下方 bash面板中输入如下命令，完成flask安装：

pip install flask

6.使用如下命令启动项目，出现下图所示表示启动成功（app.py为入口文件）：

python app.py

6、打开浏览器访问地址http://127.0.0.1:5000/ 展示效果如下：

4.4 调用AI助手实现智能问答

1、登录“我的凭证 > 访问秘钥”页面，获取Access Key（AK）和Secret Access Key（SK）。

2、登录“我的凭证 > 项目”页面，获取待使用区域的“项目ID”。调用服务时会用到这些信息，请提前保存。

本样例以“华北-北京四”区域为例，获取对应的项目ID（project_id）。

3、登录对话机器人服务管理控制台 ，在左侧菜单栏中选择“智能问答机器人”。在机器人列表，获取机器人ID（qabot_id）。

4、安装SDK

使用SDK前，需要安装“huaweicloudsdkcore”和“huaweicloudsdkcbs”。代码如下：

# 安装核心库
pip install huaweicloudsdkcore
# 安装CBS服务库
pip install huaweicloudsdkcbs

5、认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。本示例中的ak和sk保存在环境变量中，运行本示例前请先在本地环境中配置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK，以及项目id和机器人ID，打开终端，输入以下命令打开环境变量配置文件：

vi ~/.bashrc

设置环境变量，保存文件并退出编辑器:

export HUAWEICLOUD_SDK_AK="已获取AK值" 
export HUAWEICLOUD_SDK_SK="已获取SK值" 
export HUAWEICLOUD_PROJECT_ID="已获取项目id"
export HUAWEICLOUD_QABOT_ID="已获取机器id"

输入以下命令使配置文件生效。

source ~/.bashrc

6、在CodeArts IDE项目中新建文件huawei_cbs.py，完整代码如下：

# coding=utf-8
import os,json
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcore.http.http_config import HttpConfig
# 导入CBS服务库huaweicloudsdkcbs
from huaweicloudsdkcbs.v1.region.cbs_region import CbsRegion
from huaweicloudsdkcbs.v1 import *

def cbsUtil(question):
    # 使用默认配置，如出现'HttpConfig' is not defined报错，请检查是否已正确安装sdk
    config = HttpConfig.get_default_config()
    # 根据需要配置是否跳过SSL证书校验
    config.ignore_ssl_verification = False

    # 默认连接超时时间为60秒，读取超时时间为120秒，支持统一指定超时时长timeout=timeout，或分别指定超时时长timeout=(connect timeout, read timeout)
    config.timeout = 10

    # 配置AK、SK、project_id信息。华为云通过AK识别用户的身份，通过SK对请求数据进行签名验证，用于确保请求的机密性、完整性和请求者身份的正确性。
    # 请勿将认证信息硬编码到代码中，有安全风险。
    ak = os.getenv('HUAWEICLOUD_SDK_AK')
    sk = os.getenv('HUAWEICLOUD_SDK_SK')
    project_id = os.getenv('HUAWEICLOUD_PROJECT_ID')
    qabot_id = os.getenv('HUAWEICLOUD_QABOT_ID')
    basic_credentials = BasicCredentials(ak, sk, project_id)
    # 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务CBS的 CbsClient 为例
    client = CbsClient.new_builder() \
        .with_http_config(config) \
        .with_credentials(basic_credentials) \
        .with_region(CbsRegion.value_of("cn-north-4")) \
        .build()
    try:
        request = ExecuteQaChatRequest()
        request.qabot_id = qabot_id
        request.body = PostRequestsReq(
            question = question
        )

        response = client.execute_qa_chat(request)
        
        #问答型机器人回复
        if response.reply_type == 0:
            return response.qabot_answers.answers[0].answer
        #任务型机器人回复
        elif response.reply_type == 1 :
            return response.taskbot_answers.answer
        #闲聊回复
        elif response.reply_type == 2:
            return response.chat_answers.answer
        else:
            return '请求失败'
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
        return e.error_msg

7、修改app.py文件用于请求接口函数，添加如下代码：

@app.route('/aiApi',methods=['POST'])
def aiApi():
    prompts = request.form.get('prompts')
    message = huawei_cbs.cbsUtil(prompts)
    print(message)
    return jsonify({'success': True,'message':message})

8、修改前端js用于调用后端接口，代码如下：

// 发送信息到后台
      ajaxRequest = $.ajax({
        url: '/aiApi',
        type: 'POST',
        data: data,
        success:function(response){
          
            // 处理后端返回的响应
            if (response.success) {
                //自定义回复显示代码 使用response.message
            } else {
                //自定义失败显示
            }
        },
        error: function(jqXHR, textStatus, errorThrown) {
          //自定义异常处理
        }
});

9、调整完成后可以出现如下图所示效果。

输入问题1：忘记密码怎么办？

AI助手回答如下图所示：

输入问题2：蓝屏了怎么办？

AI助手回答如下图所示：

至此，基于云主机的Web项目增加AI助手就体验完成。

如果想让更多的人体验项目AI助手，可以将Web项目部署到弹性云服务器上，如没有弹性云服务器请参照 附录 操作，部署后就可以分享给其他人访问。

五、附录

5.1 创建虚拟私有云和安全组

1、在华为云首页，依次选择“产品”>“网络”>“虚拟私有云VPC”，进入服务页面，然后点击“开始使用”进入创建虚拟私有云页面。

2、在创建页面，“名称”“子网名称”填入默认名称，企业项目选择“default”，点击“立即创建”完成虚拟私有云的创建。

5.2 购买弹性云服务器

1、在华为云首页，依次选择“产品”>“计算”>“弹性云服务器 ECS”，进入弹性云服务器 ECS页面。

2、点击“购买”按钮进入购买页面。

3、按照如下规格购买：

4、点击“立即购买”完成购买。

项目发布流程该手册不多赘述，详细部署过程请参考弹性云服务器ECS部署 ，项目部署后就可以分享给其他人体验。