本案例由开发者:黄生提供,华为开发者空间案例中心优化并收录。

一、概述

1. 案例介绍

昇腾C算子开发是华为昇腾AI生态中的核心技术环节,涉及CANN软件栈、算子编程模型、开发工具链等专业领域知识。然而,相关技术文档分散在昇腾社区的多份手册中,内容晦涩、体系庞大,开发者在学习过程中往往需要反复翻阅文档、跨章节查找信息,学习效率低下。传统文档检索方式难以快速定位精准答案,知识获取的效率严重制约了开发者的学习进度。如何将零散的技术文档转化为脉络清晰的知识网络,让专业知识触手可及,成为昇腾C算子开发者普遍面临的挑战。

本案例基于华为云智果(AgentArts)智能体平台,构建昇腾C算子开发专属知识助手。通过AgentArts知识库功能,将昇腾社区的算子开发文档系统性导入并构建向量索引,结合MaaS平台大模型的语义理解能力,实现基于知识库的精准问答。案例完整演示了从知识库创建与文档导入、命中测试验证、智能体应用创建与提示词编排、模型与知识库配置、调试预览到应用发布API调用的全流程操作,帮助开发者快速掌握AgentArts知识库驱动的智能体构建能力。

案例技术选型:

  • 华为云 智果(AgentArts)智能体平台:面向企业级核心业务场景打造的智能体平台,基于Harness最佳实践构建标准化的开发与治理框架,专注于解决智能体在企业复杂环境下落地难、运行不可靠、运维无抓手等痛点,致力于降低应用门槛,助力企业将AI能力与实际业务深度融合,实现规模化落地。本案例中作为核心开发平台,结合MaaS平台大模型与知识库能力,构建昇腾C算子开发专业领域知识助手。
  • 华为云MaaS平台:华为云ModelArts大模型服务平台。提供DeepSeek-V3.2等丰富预训练模型,支持OpenAI兼容接口快速接入。本案例中为华为云 智果(AgentArts)智能体平台智能体应用提供基础模型服务。

2. 适用对象

  • 企业开发者
  • 个人开发者
  • 高校学生

3. 案例时间

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

4. 案例流程

说明:

  1. 领取MaaS平台Tokens福利,配置AgentArts平台模型鉴权,开通授权云服务;
  2. 配置AgentArts知识库,创建配置AgentArts应用;
  3. AgentArts应用预览调试与应用发布。

5. 资源总览

本案例预计花费0或1元。

说明:以下代金券价格不一但均可使用,每个账号在活动期间只可领取使用1次。

资源名称 规格 单价(元)
华为云智果(AgentArts)智能体平台 系统标配 免费
DeepSeek-V3.2/V3.1千万Tokens代金券 DeepSeek-V3.2 1.00
ModelArts Studio大模型(DS/K2/Q3等)通用代金券 DeepSeek-V3.2 0

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

2.1 领取华为云MaaS平台大模型Tokens福利

方式一: 登录华为开发者空间,参考案例《华为开发者空间 - ModelArts Studio大模型通用代金券领取使用指导》中的“二、 开通MaaS平台大模型”章节内容领取代金券,获取到模型的API Key

方式二: 登录华为开发者空间,参考案例《华为云MaaS平台大模型Tokens领取使用指导》中的“二、 领取MaaS平台大模型Tokens”章节内容,领取MaaS平台DeepSeek V3系列大模型Tokens代金券,购买ModelArts Studio DeepSeek Tokens套餐包,开通模型服务,最后获取到模型的API Key

注意:记录API Key留作后面步骤使用。

2.2 配置模型鉴权管理

登录华为云智果(AgentArts)智能体平台,点左侧“资产广场”,进入资产广场页面。

在资产广场页面,左侧选择“模型”,右侧点“模型鉴权管理”。将“2.1 领取华为云MaaS平台大模型Tokens福利”中获取到的API Key复制到“模型鉴权管理”弹窗的API Key框中,然后点确定

2.3 云服务开通及授权

在 AgentArts 平台左下角,点“授权管理”,然后点右上角“一键开通及授权”。在弹窗界面点确定,依赖云服务开通及授权。

2.4 配置AgentArts知识库

在 AgentArts 平台左侧菜单栏点组件库,顶部页签选择知识库。点其右上角的“创建知识库”按钮,选择创建方式 - 平台知识库,然后点确定。参考如下内容在右侧弹出的“抽屉”中配置知识库:

txt复制代码

基本信息:
- 知识库名称:AscendC算子开发
- 描述:CANN社区版8_2_RC1_AscendC算子开发

模型配置:
- 向量模型:pangu_embedding
- 精排模型:pangu_rerank

分段策略:自动分段

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

点击上传,然后在右侧的点上传文档,下载昇腾社区-文档解压并上传。

  • 知识库上传文档支持格式为.psd, .tiff, .bmp, .gif, .csv, .tif, .ico, .md, .jpeg, .jpg, .xlsx, .pcx, .dps, .png, .webp, .ofd, .docx, .et, .pptx, .txt, .pdf, .ppt, .doc, .wps, .xls的多个文档,单个文档不能超过20MB;
  • 本案例中使用的文档下载自昇腾社区,为方便上传,对原文档进行了分割处理。

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

点右上角的命中测试,进入命中测试页面。

输入如下测试问题,点击命中测试,在右侧选择混合检索页签,查看检索结果:混合检索返回正常。

复制代码

msopgen是什么?

三、项目构建

3.1 创建AgentArts应用

在 AgentArts 平台左侧,点“*+ 创建智能体*”。

注:AgentArts 开发平台默认区域为“西南-贵阳一”。

进入智能体创建界面,参考如下参数信息配置智能体基本信息:

复制代码

选择创建类型:单智能体
名称:昇腾算子开发学习帮手
描述:依托AscendC算子开发指南和开发最佳实践,为开发者提供学习帮助,提高学习效率。

立即创建,进入应用配置界面。

3.2 配置AgentArts应用

  1. 配置提示词,参考如下样例配置AgentArts应用提示词:

复制代码

## 角色定义
作为昇腾算子开发学习帮手,你的任务是依托昇腾算子文档,为开发者提供专业的学习支持和指导,帮助他们高效理解和掌握昇腾算子的开发技巧。你需要能够解析开发者的学习需求和疑问,从昇腾算子文档中提取关键信息,并以易于理解的方式呈现。

## 组件能力
文档解析能力:你能够深入解析昇腾算子文档,提取核心概念、操作步骤和示例代码。
学习需求分析:你需要能够准确识别和理解开发者的学习需求和遇到的问题。
信息整合与呈现:你能够将复杂的技术信息整合成简洁明了的学习资料,便于开发者理解和掌握。

## 要求与限制:
准确性:提供的信息必须准确无误,确保开发者获取正确的学习内容。
易理解性:内容呈现需简洁明了,避免使用过于专业或晦涩难懂的术语。
实用性:提供的建议和案例需具有实际应用价值,能够切实帮助开发者提升开发能力。
  1. 模型配置,选择DeepSeek V3.2,参数保持默认配置即可。
  2. 配置知识库,点右侧的+按钮,勾选“2.4 配置AgentArts知识库”中配置的“AscendC算子开发”知识库。
  3. 配置开场白,参考如下样例配置AgentArts应用开场白:

txt复制代码

欢迎使用昇腾算子开发学习帮手!我是你的学习助手,将依托昇腾算子文档为你提供高效的学习支持。让我们一起探索算子开发的奥秘,提升你的开发技能吧!
  1. 调试预览,在右侧预览调试中对话框中输入如下问题,测试AgentArts应用。

txt复制代码

你好,请解释msopgen是做什么的?

如上图,昇腾算子开发学习帮手应用正常调用知识库,并返回正确答案。

3.3 发布AgentArts应用

点右上角“提交版本”,然后点“确定”,页面弹窗提示提交版本。勾选“将该版本同步部署至实例”,点确定

弹窗部署智能体,选择入站身份认证选择默认的“IAM认证”,然后点确定,弹窗提示部署成功。

点页面上方的“渠道管理”页签,在API调用方式后面操作栏点“查看API”,可获取API调用url等关键信息。

至此,昇腾智学 - AgentArts知识库赋能算子开发学习案例结束,各位小伙伴快来华为云智果(AgentArts)智能体平台体验吧!

四、反馈改进建议

如您在案例实操过程中遇到问题或有改进建议,可以到论坛帖评论区反馈即可,我们会及时响应处理,谢谢!

Logo

鲲鹏昇腾开发者社区是面向全社会开放的“联接全球计算开发者,聚合华为+生态”的社区,内容涵盖鲲鹏、昇腾资源,帮助开发者快速获取所需的知识、经验、软件、工具、算力,支撑开发者易学、好用、成功,成为核心开发者。

更多推荐