基于华为开发者空间-云开发环境（容器）+MaaS实现智语灵犀-AI对话助手-优快云博客

一、概述

1. 案例介绍

华为开发者空间，是为全球开发者打造的专属开发者空间，致力于为每位开发者提供一台云主机、一套开发工具和云上存储空间，汇聚昇腾、鸿蒙、鲲鹏、GaussDB、欧拉等华为各项根技术的开发工具资源，并提供配套案例指导开发者从开发编码到应用调测，基于华为根技术生态高效便捷的知识学习、技术体验、应用创新。

本项目是华为开发者空间开发平台 - 云开发环境（容器）部署的AI智能对话助手技术实践案例。该应用深度集成华为云MaaS（ModelArts as a Service）平台提供的DeepSeek-V3大语言模型，充分利用平台提供的百万级商用token处理能力，构建了一个能够处理长文本、多轮深度对话的智能对话系统。

AI智能对话助手技术架构上，项目采用Python+Gradio技术栈，基于华为MaaS平台的强大算力支持，实现了高性能的智能对话服务。

华为MaaS平台不仅提供高质量的DeepSeek-V3模型，更具备百万token的超长上下文处理能力，使得本应用能够支持复杂的多轮对话场景和长文档分析任务。前端采用Gradio框架构建响应式聊天界面，后端通过封装MaaS平台API，为用户提供流畅的智能对话体验。

2. 适用对象

企业
个人开发者
高校学生

3. 案例时间

本案例总时长预计60分钟。

4. 案例流程

说明：

登录华为开发者空间，VS Code安装Huawei Developer Space插件，远程连接操作云开发环境；
远程创建、开机、连接云开发环境（虚拟机）；
领取百万token代金券福利，开通商用模型服务，获取模型API 地址、API Key等参数；
GitCode拉取智语灵犀 - AI对话助手代码，安装依赖，修改参数；
启动程序，在浏览器端测试验证智语灵犀 - AI对话助手。

5. 资源总览

本案例预计花费0元。

资源名称	规格	单价（元）	时长（分钟）
华为开发者空间开发平台 - 云开发环境（容器）	鲲鹏通用计算增强型 kc1 \| 2vCPUs \| 4G \| HCE	免费	60

二、基础环境与资源准备

1. VS Code远程连接云开发环境（容器）

参考案例《华为开发者空间 - 云开发环境（容器）IDE插件远程连接操作指导》中的“二、云开发环境IDE插件远程连接操作指导”的内容，完成“1. 安装插件” ~ “4. 连接”章节步骤。

完成连接之后的状态：

2. 领取百万免费token福利

参考案例《Versatile Agent中自定义接入大模型配置华为云Maas指导》中的“一、领取”章节内容，领取华为开发者空间百万token代金券福利，购买ModelArts Studio DeepSeek-V3 轻量体验包（¥3.50）。开通商用模型服务，最后获取API地址、API Key的参数值。

三、智语灵犀 - AI对话助手

1.智语灵犀 - AI对话助手功能介绍

AI智能对话助手是一个基于DeepSeek大模型的智能聊天应用，提供美观的Web界面和流畅的对话体验。项目采用Python + Gradio，结合华为云MaaS平台百万免费商用token，配置DeepSeek-V3大模型。项目结构如下：

ai_chat_assistant/
├── main.py              # 主程序入口
├── config.py            # 配置文件
├── chat_assistant.py    # 聊天助手核心类
├── styles.css           # 样式文件
├── requirements.txt     # Python依赖
└── README.md           # 项目文档

1.1 `main.py`主程序入口

核心功能：

应用程序的启动入口
创建和管理Gradio Web界面
处理用户界面交互逻辑
协调各个模块之间的调用

主要职责：

加载CSS样式文件
创建聊天界面布局
绑定用户交互事件
启动Web服务器
调用聊天助手处理用户输入

1.2 `config.py`配置文件

核心功能：

集中管理所有配置参数
提供统一的配置访问接口
分离配置与代码逻辑

包含的配置类别：

API配置：API密钥、请求地址、模型名称
应用配置：应用名称、标题、副标题
界面配置：服务器设置、界面参数
头像配置：用户和AI的头像URL
系统提示：AI助手的系统角色设定

1.3 `chat_assistant.py`核心业务逻辑

核心功能：

封装与DeepSeek API的通信
处理对话逻辑和消息历史
管理API请求和响应

主要类和方法：

SimpleChatAssistant 类
- __init__(): 初始化API配置
- chat(): 处理对话请求，构建消息历史
错误处理和异常管理
HTTP请求发送和响应解析

1.4 `styles.css`样式文件

核心功能：

定义应用程序的视觉样式
提供一致的用户界面体验
响应式设计和主题适配

样式范围：

布局样式：容器、间距、对齐
组件样式：聊天框、输入框、按钮
消息样式：用户消息、AI消息气泡
交互样式：悬停效果、焦点状态
主题适配：系统颜色变量使用

1.5 `requirements.txt`依赖管理

核心功能：

列出项目运行所需的所有Python包
确保环境一致性
简化部署和安装过程

包含的依赖：

gradio: Web界面框架
requests: HTTP请求库
urllib3: URL处理库

2. 获取智语灵犀 - AI对话助手代码

新建项目文件

在/workspace/python目录下创建ai_chat_assistant文件夹。

cd /workspace/python/
mkdir ai_chat_assistant
cd ai_chat_assistant

下载代码

点击Source Control图标，然后点Initialize Repository。

点CHANGES右侧的 ··· 图标，在下拉菜单中选择Clone。

输入代码仓地址，Clone from URL：https://gitcode.com/sinat_41661654/chat_assistant.git

选择代码仓目录：/workspace/python/ai_chat_assistant/，点Select as Repository Destination。

然后点Open，将此目录设置为本地代码仓。

加载结束后的状态如下：

3. 安装项目依赖

创建并激活虚拟环境

python -m venv venv
source venv/bin/activate

安装项目依赖

pip3 install -r requirements.txt

4. 修改配置文件，配置API Key

打开配置文件config.py，修改配置参数。将配置文件中的your_API_Key替换为“二、基础环境与资源准备”章中的“4. 领取百万免费福利”节最后获取到的API Key。

# API配置
API_CONFIG = {
    "api_key": "your_API_Key",  # 替换为你的实际API密钥
    "base_url": "https://api.modelarts-maas.com/v1/chat/completions",
    "model": "DeepSeek-V3"
}