最新案例动态，请查阅《【案例共创】基于华为开发者空间-Versatile Agent开发平台构建昇腾C算子开发知识库》。小伙伴快来领取华为开发者空间进行实操吧

本案例由开发者：黄生提供

一、概述

1. 案例介绍

华为开发者空间 - Versatile Agent平台(AI 原生应用引擎)提供了数据准备、模型选择/调优、知识工程、模型编排、应用部署、应用集成等能力。

在本案例的专业领域知识库构建中，以昇腾 C 算子开发专业领域知识库为例，借助华为云开发者空间的 Versatile Agent，系统性地组织、存储和管理海量技术知识，开发者可以突破传统知识管理的局限，将零散的技术文档转化为脉络清晰的知识网络。这种智能化的知识处理方式，不仅提升了信息检索效率，更重塑了开发者与专业知识的互动模式。

本案例通过实际操作，让大家深入了解如何使用华为云开发者空间-Versatile Agent 开发平台，基于 Versatile Agent 开发平台的服务模型-平台预置功能配置 MaaS，构建昇腾 C 算子开发专业领域知识库，实现开发者与专业知识的高效互动。

2. 适用对象

• 企业

• 个人开发者

• 高校学生

3. 案例时间

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

4. 案例流程

说明：

1. 领取登录华为开发者空间，开通Versatile Agent；2. 创建Versatile Agent应用；3. 使用Versatile Agent开发平台的服务模型-平台预置功能配置MaaS；4. 使用Versatile Agent的知识库创建昇腾C算子知识库；5. 配置昇腾算子开发学习帮手应用模型、提示词、知识库、开场白等，完成预览调试；7. 发布Versatile Agent应用。

5. 资源总览

本案例预计花费 0 元。

二、资源准备与基础环境配置

1. 开发者空间 - 开发平台

首次登录华为开发者空间 - 开发平台，需要签署开发者空间开发平台服务协议。勾选“我已阅读并同意上述《开发者空间开发平台服务协议》”，然后点同意。

1.1 开发者空间 - Versatile Agent 平台

签署协议后，开发平台左侧点 Versatile Agent，进入华为开发者空间 - Versatile Agent平台。点开通服务，根据系统要求完成开通。

华为开发者空间 - Versatile Agent平台提供了 Agent、大模型、MCP、Versatile 空间等能力。

1.2 体验新版 Versatile Agent 平台

25 年 9 月份迎来 Versatile Agent 平台全新升级。平台新增了 27 个特性，优化增强 8 个功能，新增多模态交互（图像、语音），新增敏感内容审查和风控，新增提示词管理，支持查看 Trace 调用链，查看使用量等统计指标，在运营运维、安全审查等企业级特性上有大幅提升。

根据系统提示，在“Versatile Agent 升级公告”弹窗中点确定，然后点右上角的体验新版 Versatile Agent。

根据提示点“华北-北京四”，切换服务区域。

完成新版本切换后的界面如下。

2. 配置模型

Versatile Agent 平台 - 模型服务，提供标准化 API 接口，支持盘古大模型与业界主流模型的接入与管理，提供多种路由策略，实现模型无感切换和灵活调度，支持 NLP 与多模态理解模型的在线调测及参数配置。

本案例中选用 ModelArts Studio（MaaS)模型服务，在 Versatile Agent 平台选择服务模型 > 平台预置，找到 ModelArts Studio（MaaS)，点击鉴权配置。

根据提示输入 API Key，然后点击确定。

注：请参考案例《基于DeepSeek和Dify构建心理咨询师应用》中的“2.1 免费领取 DeepSeek R1 满血版”步骤，领取 DeepSeek-V3 模型 200 万免费 token，并获取 API Key 的值。

配置成功后，ModelArts Studio（MaaS)模型服务状态由“未接入”，变为“已接入”。

3. 创建知识库

Versatile Agent 平台 - 知识库，不仅自有知识库创建管理，同时还支持接入外部（第三方）知识库，实现各个系统中的数据贯通。在 Agent 问答支持知识切片溯源，支持配置多个知识库（最多 3 个）。

本案例中需要使用自有知识库功能，构建昇腾 C 算子开发知识库。在 Versatile Agent 平台选择知识库 > 知识库，点新建知识库，选择默认，然后点确定。

在右侧弹出的“抽屉”中配置知识库基本信息：

• 知识库名称：AscendC 算子开发

• 描述：CANN 社区版 8_2_RC1_AscendC 算子开发

模型配置：

• 向量模型：pangu_embedding

• 精排模型：pangu_rerank

拆分配置选择默认的自动分段。

点确定，知识库完成创建，可在知识库列表中进行查看。点知识库的名称，进入知识库详情页。

在详情页，点击上传。

注：

• 支持格式为 doc，docx，pdf，pptx，ppt，xlsx，xls，csv，wps，png，jpg，jpeg，bmp，gif，tiff，tif，webp，pcx，ico，psd，dps，et，txt，ofd 的多个文档，单个文档不能超过 128MB（超过 60MB 建议通过 API 上传）；

• 本案例使用的 PDF 文件，可以从昇腾社区-文档(https://www.hiascend.com/document/detail/zh/CANNCommunityEdition/82RC1/opdevg/Ascendcopdevg/atlas_ascendc_10_0001.html) 进行下载，在文档页面点击“查看 PDF 文件”可以下载 PDF 格式的文档。文件大小超过 10M 的需要自行拆分为多个小于 10M 的文件。

• CANN 社区版 8_2_RC1_AscendC 算子开发指南.pdf 文件较大，进行 PDF 分割时需要用到专业软件，开发者可以从这里下载已经分割好的文件：CANN社区版8_2_RC1_AscendC算子开发知识库.rar
  

在右侧弹出的上传文档抽屉中点点此上传，选中准备好的 PDF 文件，点打开。

等待文件状态变为“成功”时，则文档上传成功。

点右上角的命中测试。输入msopgen是什么？点上方的命中测试，在右侧选择混合检索页签，查看检索结果。

三、项目构建

1. 创建配置 Agent

1.1 创建 Agent

在 Versatile Agent 平台页签选择智能体 > 单智能体应用，点击创建应用。

在应用配置界面，创建类型选择默认的单智能体应用，页签选择常规创建，然后配置应用名称及其描述。

样例：

• 应用名称：昇腾算子开发学习帮手
  

• 描述：依托昇腾算子文档，为开发者提供学习帮助，提高学习效率。
  

配置完成后，点右下角立即创建。

创建完成后进入应用配置界面。

1.2 模型配置

模型选择可以选择平台预置的 DeepSeek，也可以选择前面“二、资源准备与基础环境配置”章中的“2. 配置模型”节配置的 MaaS 模型资源。为了保证应用的运行不受资源限制影响，这里选择 ModelArts Studio（MaaS)模型服务中的 DeepSeek-V3-64K。

• DeepSeek-V3：适合做聊天、创作、翻译，优点是快又省；

• DeepSeek-R1：更擅长解数学、写代码、搞推理，优点是强又稳。

智能体调度模式，选择默认的模型优先。

1.3 提示词

点右上角的角色指令模板，为了保证应用回复的准确性，提示词应具备三个主要信息：角色设定、组织能力、要求与限制。

## 角色设定作为一个________，你的任务是________。
## 组件能力你具备________能力。
## 要求与限制1.输出内容的风格要求________。2.输出结果的格式为________。3.输出内容的字数限制不超过________。

样例：

## 角色定义作为昇腾算子开发学习帮手，你的任务是依托昇腾算子文档，为开发者提供专业的学习支持和指导，帮助他们高效理解和掌握昇腾算子的开发技巧。你需要能够解析开发者的学习需求和疑问，从昇腾算子文档中提取关键信息，并以易于理解的方式呈现。
## 组件能力文档解析能力：你能够深入解析昇腾算子文档，提取核心概念、操作步骤和示例代码。学习需求分析：你需要能够准确识别和理解开发者的学习需求和遇到的问题。信息整合与呈现：你能够将复杂的技术信息整合成简洁明了的学习资料，便于开发者理解和掌握。
## 要求与限制:准确性：提供的信息必须准确无误，确保开发者获取正确的学习内容。易理解性：内容呈现需简洁明了，避免使用过于专业或晦涩难懂的术语。实用性：提供的建议和案例需具有实际应用价值，能够切实帮助开发者提升开发能力。

也可以在编辑基础信息后，使用提示词右上角的智能优化提示词功能。

1.4 配置知识库

点知识库右上角的高级配置，在检索策略红选择混合检索。

点高级配置右侧的“**+**”，在右侧弹出的抽屉中选中“二、资源准备与基础环境配置”中的“3. 创建知识库”创建的“AscendC 算子开发”知识库，然后点确定。

配置完后的状态如下

1.5 配置开场白

在开场白中配置如下内容：

欢迎使用昇腾算子开发学习帮手！我是你的学习助手，将依托昇腾算子文档为你提供高效的学习支持。让我们一起探索算子开发的奥秘，提升你的开发技能吧！

1.6 调试预览

在右侧预览调试中对话框中输入：你好。请解释msopgen是做什么的？我要创建一个简单向量加的算子工程，请给出json原型文件和命令。注意数据类型是数组、命令的语言参数是cpp。，应用正常调用知识库，并返回正确答案。

2. 发布

点右上角的发布，在发布弹窗中输入版本名称：AscendC_Ass v1.0，描述：昇腾算子开发学习帮手1.0

在发布管理界面，可以查看技术文档和示例代码。开发者可进行参考指导将该应用在自己开发的程序中进行调用。

本案例到此结束。快使用开发者空间 - Versatile Agent 平台来加速你的学习吧！