单 AgentLLM 模式是小艺开放平台提供的最基础的智能体编排方式。根据华为官方文档LLM 模式是一种基于大模型的智能体编排方式开发者按需选择大模型根据业务逻辑编写提示词以 LLM 为理解中枢结合意图识别、工具调用、对话上下文动态选择插件、工作流响应用户需求。LLM 模式适用于简单对话、知识问答、基础内容生成等场景。小艺开放平台依托鸿蒙系统生态为开发者打造全链路智能体开发解决方案配备端到端工具链覆盖从智能体开发、多端调试手机/平板/车机/PC/手表到部署上架的全生命周期。智能体完成开发后将统一上架至智能体市场实现集中管理和多设备、多入口分发。本文是「鸿蒙智能体开发实战」系列的第二篇将以创建一个今日笑话智能体为例手把手演示如何在 小艺开放平台 上完成单 Agent 的创建和配置涵盖从基础信息设置、角色指令编写到快捷指令配置等全流程操作。一、创建智能体进入小艺开放平台点击“新建智能体”选择“单 Agent”模板填写智能体名称和描述点击“创建”。创建时需要填写的基本信息配置项说明示例值智能体名称智能体的显示名称用户可见今日笑话智能体描述简要描述智能体的功能帮助用户理解用途每天为你带来一则有趣的笑话模板类型选择编排方式创建后不可更改单 AgentLLM 模式智能体图标上传头像建议使用 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 的灵魂直接决定智能体的行为质量开场语和预制问题引导用户首次交互体验快捷指令提供跳转、指令发送、状态管理三种类型输入文件、知识库、插件共同扩展智能体能力边界配置完成后应进行预览测试和真机调试再上架发布如果这篇文章对你有帮助欢迎点赞、收藏⭐、关注你的支持是我持续创作的动力相关资源小艺开放平台 - 创建智能体小艺开放平台 - 基础信息配置小艺开放平台 - 开场语与预制问题小艺开放平台 - 输入文件设置小艺开放平台 - 用户问题建议小艺开放平台 - 快捷指令配置小艺开放平台 - 背景图片设置小艺开放平台 - 角色声音配置华为开发者联盟