简单几步,基于云主机快速为Web项目添加AI助手

在华为开发者空间,借助华为云对话机器人服务 CBS您可以零代码创建一个大模型 RAG (Retrieval-Augmented Generation,即检索增强生成)应用,来实现 AI 助手的智能问答能力。本实验借助华为云CBS提供的可访问API,在项目代码中通过几行代码引入 AI 助手,用户就可以在网站上看到一个 AI 助手,实现与之对话。

 

华为开发者空间,汇聚鸿蒙、昇腾、鲲鹏、GaussDB、欧拉等各项根技术的开发资源及工具,致力于为每位开发者提供一台云主机、一套开发工具及云上存储空间,让开发者基于华为根生态创新。点击链接,免费领取您的专属云主机

实验流程

说明:

  1. 用户创建智能机器人,增加私有知识;

  2. 准备SDK接入信息;

  3. 在CodeArts IDE 上开发Web项目;

  4. 在Web项目添加调用智能问答机器人服务的SDK并体验;

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

实验资源

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

创建智能问答机器人

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

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

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

  

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

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

    选择“试用”购买即可。

增加私有知识

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

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

知识库

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

  1. 在问答管理中单击添加按钮新建问题分类,例如“IT问题”。

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

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

Q:忘记密码怎么办

A:‌通过安全模式重置密码‌(无需密码重置磁盘)

Q: 蓝屏了怎么办

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

技能平台

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

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

部署Web项目

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

git clone https://github.com/nishaotang/huawei_cbs_demo.git
  1. 进入云主机,打开终端。

  2. 执行命令安装python:

sudo apt-get install python-is-python3
  1. 验证python是否安装完成,出现图片所示表示我们python的环境变量已经配置完成:

python

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

  2. 本样例以Python Flask框架为例。在下方 bash面板中输入如下命令,完成flask安装:

pip install flask
  1. 使用如下命令启动项目,出现下图所示表示启动成功(app.py为入口文件):

python app.py

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

调用AI助手实现智能问答

  1. 登录“我的凭证 > 访问秘钥”页面,获取Access Key(AK)和Secret Access Key(SK)。

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

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

  1. 登录对话机器人服务管理控制台,在左侧菜单栏中选择“智能问答机器人”。在机器人列表,获取机器人ID(qabot_id)。

  1. 安装SDK

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

# 安装核心库
pip install huaweicloudsdkcore
# 安装CBS服务库
pip install huaweicloudsdkcbs
  1. 认证用的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

  1. 在CodeArts IDE项目中新建文件huawei_cbs.py,完整代码如下(复制文档中python代码时,可能会导致格式错误,可以从下载的项目资料中获取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
  1. 修改app.py文件用于请求接口函数,添加如下代码(复制文档中python代码时,可能会导致格式错误,可以从下载的项目资料中获取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})
  1. 修改前端js用于调用后端接口,代码如下(复制文档中js代码时,可能会导致格式错误,可以从下载的项目资料中获取web.js文件内容!):

// 发送信息到后台
      ajaxRequest = $.ajax({
        url: '/aiApi',
        type: 'POST',
        data: data,
        success:function(response){
          
            // 处理后端返回的响应
            if (response.success) {
                //自定义回复显示代码 使用response.message
            } else {
                //自定义失败显示
            }
        },
        error: function(jqXHR, textStatus, errorThrown) {
          //自定义异常处理
        }
});
  1. 调整完成后可以出现如下图所示效果。

输入问题1:忘记密码怎么办?

AI助手回答如下图所示:

输入问题2:蓝屏了怎么办?

AI助手回答如下图所示:

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

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

创建虚拟私有云和安全组

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

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

购买弹性云服务器

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

  1. 点击“购买”按钮进入购买页面。

  2. 按照如下规格购买:

  1. 点击“立即购买”完成购买。

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

 

点击关注,第一时间了解华为云新鲜技术~

posted @ 2024-11-21 17:25  华为云开发者联盟  阅读(0)  评论(0编辑  收藏  举报