【案例共创】基于华为云开发者空间-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元。

资源名称	规格	单价（元）	时长（分钟）
华为开发者空间 - Versatile Agent平台	系统标配	免费	60

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

1. Versatile Agent平台

华为开发者空间 - Versatile Agent平台 是企业级一站式智能体构建平台。该平台支持单智能体、工作流和多智能体三种开发方式，集成了盘古、MaaS、DeepSeek等第三方大模型。

注：若服务区域非“华北-北京四”，需根据系统提示切换。

2. 领取百万免费token福利，配置模型

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

参考案例《Versatile Agent中自定义接入大模型配置华为云Maas指导》 中的“一、 领取”和“二、 在Versatile Agent中配置模型”章节内容，领取百万免费token福利，配置模型。

配置成功后，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开发平台构建昇腾C算子开发知识库案例结束。小伙伴快来华为开发者空间 - Versatile Agent平台 配置属于你的AI应用吧！