单 Agent（LLM 模式） 是小艺开放平台提供的最基础的智能体编排方式。根据华为官方文档，LLM 模式是一种基于大模型的智能体编排方式，开发者按需选择大模型，根据业务逻辑编写提示词，以 LLM 为理解中枢，结合意图识别、工具调用、对话上下文，动态选择插件、工作流，响应用户需求。LLM 模式适用于简单对话、知识问答、基础内容生成等场景。
小艺开放平台依托鸿蒙系统生态，为开发者打造全链路智能体开发解决方案，配备端到端工具链，覆盖从智能体开发、多端调试（手机/平板/车机/PC/手表）到部署上架的全生命周期。智能体完成开发后，将统一上架至智能体市场，实现集中管理和多设备、多入口分发。
本文是 「鸿蒙智能体开发实战」 系列的第二篇，将以创建一个"今日笑话"智能体为例，手把手演示如何在 小艺开放平台 上完成单 Agent 的创建和配置，涵盖从基础信息设置、角色指令编写到快捷指令配置等全流程操作。
一、创建智能体
进入小艺开放平台，点击 “新建智能体”，选择 “单 Agent” 模板，填写智能体名称和描述，点击 “创建”。
创建时需要填写的基本信息：
| 配置项 | 说明 | 示例值 |
|---|---|---|
| 智能体名称 | 智能体的显示名称，用户可见 | 今日笑话 |
| 智能体描述 | 简要描述智能体的功能，帮助用户理解用途 | 每天为你带来一则有趣的笑话 |
| 模板类型 | 选择编排方式，创建后不可更改 | 单 Agent（LLM 模式） |
| 智能体图标 | 上传头像，建议使用 512x512 像素的方形图片 | 自定义上传 |
提示：创建后可以在后续步骤中随时修改基础信息和配置内容，但模板类型一经选定不可更改。
二、开场语与预制问题
2.1 开场语
开场语是智能体的自我介绍，用户首次进入对话时会首先看到这段文字。应简洁明了地说明智能体的功能和定位。
编写开场语时可以参考以下原则：
- 身份明确：清晰说明"我是谁"，让用户第一时间了解智能体的定位
- 能力说明：简要说明"我能做什么"，激发用户的兴趣和使用意愿
- 风格统一：开场语风格应与智能体的角色设定保持一致
- 简洁扼要：控制在 50 字以内，过长反而影响阅读体验
配置建议：开场语应当包含智能体的身份介绍和能力说明，让用户一目了然地知道这个智能体能做什么。
2.2 预制问题
预制问题是引导用户进行下一步操作的提示语，以按钮形式展示在对话界面中，用户可以一键点击发起对话。
示例配置（今日笑话智能体）：
- 开场语：“我是今日笑话，每天为你带来一则有趣的笑话，点亮你的心情！”
- 预制问题：
- “讲一个关于程序员的笑话”
- “说一个职场上的趣事笑话”
- “来点冷笑话或脑筋急转弯”
其他场景的开场语示例：
| 智能体类型 | 开场语示例 |
|---|---|
| 天气助手 | “你好！我是天气小助手，随时随地为你查询最新天气信息～” |
| 学习助手 | “欢迎来到知识课堂！我擅长解答数学、物理、编程等问题。” |
| 旅游顾问 | “想去哪里旅行？我来为你推荐行程、景点和美食攻略！” |
预制问题的设计技巧：
- 覆盖不同方向：配置 3-5 个覆盖不同功能方向的问题
- 简洁易懂：每个问题控制在 15 字以内，一目了然
- 引导深度：从简单问题入手，逐步引导用户深入交互
三、角色指令
3.1 什么是角色指令？
角色指令实际上就是 系统提示词（System Prompt），它不会显示给用户，而是作为智能体生成回复的指导语。角色指令可以设置智能体的性格、行为准则、输出格式等核心行为。
注意：角色指令是单 Agent 配置中最关键的部分，它直接决定了智能体的响应质量和行为一致性。
3.2 角色指令示例
以下是一个笑话智能体的角色指令配置示例：
## 人设
- 角色：笑话讲述者
- 专业技能：收集和分享有趣的笑话，能够根据不同的场合和听众选择适当的笑话。
## 任务描述
- 目标：为用户提供一则有趣的笑话，以提升他们的心情。
- 预期影响：通过分享笑话，使用户感到轻松愉快，增加日常生活的乐趣。
## 约束条件
- 按照<输出格式>输出
- 笑话内容应健康、积极，避免任何可能引起不适的话题。
- 笑话长度适中，易于理解和分享。
## 执行步骤
1. 从笑话库中选择一则适合当日分享的笑话。
2. 检查笑话内容是否符合健康、积极的标准。
3. 将选定的笑话按照输出格式整理。
4. 输出笑话。
## 输出格式
- 风格：轻松、幽默
- 字数：50-100字
- 格式：直接输出笑话内容，无需额外标题或说明。
3.3 角色指令编写要点
编写角色指令时，建议包含以下要素：
- 人设定义：明确智能体的角色定位和专业技能
- 任务描述：说明智能体的核心目标和预期效果
- 约束条件：规定回答的边界和限制，确保内容合规
- 执行步骤：给出完成任务的具体步骤指引
- 输出格式：定义回答的风格、长度、结构等格式要求
提示：角色指令越清晰具体，智能体的表现就越稳定可控。建议多迭代测试，逐步优化指令内容。
3.4 角色指令优化建议
在实际开发中，角色指令的编写往往需要多次迭代。以下是一些优化建议：
- 从简到繁：先写核心人设和任务，测试通过后再逐步添加约束和格式要求
- 负面示例：在约束条件中说明"不要做什么"，比"要做什么"更有效
- 格式明确：指定输出格式（如 JSON、Markdown、纯文本）可以大幅提升结果一致性
- 角色代入：使用"你是一个……"的开头比"请扮演……"更自然
- 测试验证：修改 Prompt 后立即测试，观察输出是否符合预期
四、模型选择
在小艺开放平台中，创建单 Agent 时可以选择底层大模型。不同的模型在推理能力、响应速度、成本上有所差异：
| 模型类型 | 特点 | 适用场景 |
|---|---|---|
| 高性能模型 | 推理能力强，适合复杂任务 | 专业问答、内容创作 |
| 均衡型模型 | 性能与速度兼顾 | 大多数通用场景 |
| 轻量模型 | 响应速度快，成本较低 | 简单对话、高频调用 |
说明：具体可用模型以小艺开放平台实际展示为准，不同时期可选的模型可能有所不同。
五、输入文件设置
输入文件设置允许用户在上传图片、文件后，大模型会基于上传的文件内容进行回复。这一功能适用于以下场景：
- 图片分析：用户上传图片，智能体识别并描述图片内容
- 文档问答：用户上传文档，智能体基于文档内容回答
- 数据提取：用户上传表格或数据文件，智能体提取关键信息
开启输入文件功能后，对话界面中会出现文件上传按钮，用户可点击后选择文件上传。
六、用户问题建议
用户问题建议可以在每次对话结束后，在回复内容下方展示继续追问的引导语，帮助用户继续对话。
配置方式：
- 使用系统配置 Prompt：平台自动生成建议问题，适合快速配置
- 自定义配置 Prompt：开发者自行编写引导语，更贴合业务场景
使用场景：开启后每次对话完，会在回复下方展示相关的追问建议，提升用户交互的连续性和深度。
选择自定义配置时，可以参考以下示例：
你可以问我关于编程的笑话
想听冷笑话吗？
试试脑筋急转弯
配置建议： 建议问题应简洁、有吸引力，覆盖智能体擅长的不同方向，引导用户探索更多功能。
七、快捷指令
7.1 什么是快捷指令？
快捷指令是对话输入框上方的按钮，配置完成后，用户可以快速发起预设对话，无需手动输入。
快捷指令支持三种类型：
7.2 跳转型
跳转型指令点击后会跳转到指定的页面或应用，包括两种子类型：
DEEP LINK（深度链接）
基于 URL Scheme 实现，点击后跳转到指定的页面或应用。这在需要将用户从智能体引导到特定应用页面的场景中非常有用，例如跳转到商品详情页、订单页等。
需要配置以下信息：
- 应用名称：目标应用的显示名称
- 包名：应用的包名标识
- Deeplink 地址：目标页面的 URL Scheme
- 最小版本号：支持该 Deeplink 的应用最低版本
- Action 名称：跳转动作的名称标识
使用场景：例如，一个电商客服智能体可以配置 “查看订单” 快捷指令，点击后直接跳转到应用的订单列表页面。
界面跳转
首先需要在工作空间新建好用户界面，然后配置跳转到自定义界面。这种方式适合需要展示自定义 UI 的场景，比如表单填写、数据展示等。
7.3 指令发送型
指令发送型是将预设内容发送到对话框中，包括：
| 类型 | 说明 |
|---|---|
| 文件 | 上传指定的文件 |
| 图片 | 上传指定的图片 |
| 拍摄 | 调用相机拍摄后上传 |
| 文本 | 将预设文本发送至对话框 |
| 面板 | 展示组件供用户操作（上传按钮、选择器、图片等） |
7.4 状态型
状态型指令可以修改变量的值，包括：
- 用户变量：与用户相关的状态变量
- 计数变量：用于计数或统计的变量
通过修改这些变量值，可以实现定制化的业务逻辑。例如，记录用户今日已获取的笑话数量，当达到上限时提示用户明日再来。
提示：状态型指令通常与变量功能配合使用，适合需要跟踪用户状态的场景。
八、背景图片
可以为智能体设置一个背景图片，增强对话界面的视觉效果。
配置要求：
- 格式：支持 JPG、PNG 格式
- 大小：不超过 5MB
- 内容：建议使用与智能体主题相关的图片
- 比例：建议使用横屏比例，适配对话界面显示
选择合适的背景图片可以显著提升用户的视觉体验。例如：
- 笑话智能体可使用轻松活泼的卡通风格背景
- 知识问答智能体可使用简洁专业的商务风格背景
- 天气查询智能体可使用自然风光主题背景
九、角色声音
可以为智能体配置角色声音，让智能体具备语音交互能力。开启后，用户在对话中可以听到智能体的语音回复。
配置要点：
- 声音选择：从平台提供的声音库中选择适合智能体风格的声音
- 语速调整：根据内容类型调整语速，讲故事可稍慢，新闻播报可稍快
- 音调设置：调整音调使其与智能体的角色定位匹配
- 试听测试：配置完成后试听确认效果
使用场景：角色声音特别适合儿童教育、语音助手、有声读物等场景，可以显著提升用户互动体验。
十、更多配置
10.1 插件
通过插件可以扩展智能体的能力边界，小艺开放平台提供以下类型插件：
- 鸿蒙系统插件：OS 底层能力接口，包含 AI、通信、UI、分布式等核心系统能力
- 系统应用插件：系统应用（相机、图库、备忘录、闹铃、设置等）的功能开放接口
- 第三方应用插件：应用市场上架应用的通用能力接口
- MCP 工具：通过 MCP 协议接入的第三方生态工具能力
通过意图框架开放端云插件能力，支持端+云插件灵活编排，实现高性能本地实时交互、安全可信的数据存储与权限管控、多端无缝联动。
说明：插件相关的详细配置步骤将在后续系列文章中单独介绍。
10.2 知识库
接入自定义知识库可以提升智能体回答的准确性，适用于需要基于特定领域知识回答的场景。知识库支持：
- 文档导入：上传产品手册、技术文档等作为知识来源
- FAQ 导入：导入常见问题及其答案
- 自动更新：支持定期刷新知识库索引
10.3 变量
变量功能允许在智能体中定义和管理状态数据：
| 变量类型 | 说明 | 示例 |
|---|---|---|
| 用户变量 | 与特定用户绑定的变量 | 用户偏好设置、历史记录 |
| 计数变量 | 用于计数或统计的变量 | 今日调用次数、累计用户数 |
变量通常与状态型快捷指令配合使用，实现定制化的业务逻辑。例如，记录用户每日使用次数，达到上限时做出不同响应。
10.4 长期记忆
长期记忆功能让智能体能够记住用户的历史交互信息，在多轮对话中保持语义连续性。通过长期记忆，智能体可以：
- 记住用户的偏好和习惯
- 在多轮交互中维护上下文
- 提供更加个性化的服务体验
根据华为官方文档，小艺通过建立一个存储并管理用户信息的记忆体，可以在解答问题、执行操作时进一步结合用户习惯，给出更具个性化的回答和反馈。
10.5 更多扩展功能
单 Agent 还支持以下扩展功能，将在本系列后续文章中详细介绍：
- 工作流：将复杂任务拆解为多步骤流程，通过可视化编辑器拖拽编排
- 触发器：设置定时触发或事件触发的自动化任务
- 关联应用：关联鸿蒙应用，实现应用间协同
十一、测试与发布
11.1 对话效果预览
在完成上述所有配置后，可以通过平台的预览功能查看智能体的对话效果。以一个"今日笑话"智能体为例，完整的用户对话流程如下：
- 用户进入对话界面，看到开场语"我是今日笑话……"
- 用户点击预制问题"讲一个关于程序员的笑话"
- 智能体根据角色指令生成一则符合格式要求的编程笑话
- 对话结束后，显示追问建议"想听冷笑话吗？"
- 用户继续点击，进入下一轮对话
验证要点：测试时重点关注角色指令是否被正确执行、输出格式是否符合预期、快捷指令是否正常工作。
11.2 发布流程
配置完成后，可以按以下步骤进行测试和发布：
- 预览测试：在平台上在线预览智能体的对话效果，输入测试问题检查回复质量
- 真机测试：在手机、平板、车机等设备上进行真机调试，验证多端体验一致性
- 优化迭代：根据测试结果调整角色指令和配置，反复测试直到效果满意
- 提交审核：在智能体市场中提交上架申请，等待平台审核
- 发布上线：审核通过后正式发布，用户即可在多设备上使用
说明：小艺开放平台支持多端调试，包括手机、平板、车机、PC、手表等华为全场景终端设备。
11.3 持续优化
智能体上线后并非一劳永逸，建议持续关注以下方面：
- 用户反馈：收集用户的评价和建议，发现体验问题
- 对话日志：分析用户的实际对话数据，识别回答质量不佳的场景
- 迭代更新：定期优化角色指令和配置，提升智能体表现
- 版本管理：平台支持智能体全生命周期版本管理，方便回滚和更新
十二、总结
本文以"今日笑话"智能体为例，详细介绍了在小艺开放平台上创建单 Agent 的完整流程，涵盖开场语配置、角色指令编写、快捷指令设置、背景图片与角色声音等核心配置项。
核心要点回顾：
- 角色指令是单 Agent 的灵魂，直接决定智能体的行为质量
- 开场语和预制问题引导用户首次交互体验
- 快捷指令提供跳转、指令发送、状态管理三种类型
- 输入文件、知识库、插件共同扩展智能体能力边界
- 配置完成后应进行预览测试和真机调试再上架发布
如果这篇文章对你有帮助，欢迎点赞👍、收藏⭐、关注🔔，你的支持是我持续创作的动力！
相关资源：
扫一扫
925
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
