Okay, let's break down how CodeGenie AI can assist in developing HarmonyOS applications, effectively making "Xiaoyi" (小艺) or the development environment "see" your app. CodeGenie is essentially a code generation and AI assistant integrated into the official HarmonyOS IDE (e.g., DevEco Studio).
Here's how it works and its benefits in the context of app development:
1. "Understanding Your Code (Code Comprehension):"
"How it helps:" CodeGenie analyzes the code you're writing or existing code within your project. It understands the structure, logic, and relationships between different components (like Ability, Element, Data Model classes).
""Seeing" the App:" By understanding the code, CodeGenie can provide context-aware suggestions, explain code snippets, or identify potential issues. This allows it to "see" the structure and functionality you're building.
2. "Generating Code Snippets and Templates (Code Generation):"
"How it helps:" You can ask CodeGenie to generate boilerplate code for common HarmonyOS patterns. For example:
Generate a basic `AbilitySlice` structure.
Create a data model class based on a description.
Provide UI element code (like a `ListContainer` with items).
Generate event handlers.
""Seeing" the App:" This accelerates development by providing
相关内容:
手机越来越懂我们了。你说一句“查看我待取件的快递”,它就能精准打开快递软件服务卡片;你说“播放Dream It Possible”,它就能拉起音乐 App 播放对应歌曲。这背后,是 HarmonyOS 意图框架的默默支撑,也是 DevEco Studio 插件生态的强大助力。
对开发者而言,这不再是遥不可及的语音魔法,而是可以在 DevEco Studio 中一步步构建的现实。今天,我们就来聊聊两个插件:CodeGenie 和 Application Agent ,如何联手帮你的 App 实现“会说话、懂指令”的智能连接。
意图框架
在 HarmonyOS 中,意图框架是连接用户需求与服务能力的桥梁。它支持两种分发模式:用户主动意图和系统主动推荐,通过语音、小艺搜索、导航条等入口,打破 App 孤岛,实现服务直达。
这意味着开发者不再围绕“应用入口”设计功能,而是围绕“用户意图”构建服务。随着 AI 个性化能力的增强,意图框架正向动态学习、跨场景关联、偏好适配等方向演进,成为构建智能体生态的核心基石。

CodeGenie:你的意图,我懂
目前API 20开始已经支持应用开发者通过装饰器开发意图,支持5类意图装饰器的生成:
link/page/function/form/entry接入意图装饰器。

使用CodeGenie生成意图装饰器需要以下几步:
- 在DevEco Studio的编辑器中,在光标处或选中代码片段后“右键” => “CodeGenie” => “Insight Intent”=> 点击5种意图生成的子菜单;
- 在Chat面板输入提示词(可选),点击Enter或发送即可生成您想要的意图注解装饰;
- 将生成的注解装饰器插入到代码中合适的地方;
- 在意图注解上点击“右键”=> 点击“Add Intent Plugin”,即可完成将意图注解插件注册到小艺开放平台中。

从上图中可以到只有“Page Insight Intent”支持点击,这是因为不同意图装饰器只有在特定的上下文环境才能生成:
| 意图装饰器 | 使用场景 | 生成校验规则 |
| @InsightIntentLink | 将应用的URI链接定义为意图,并通过openLink触发跳转。适用于已有的URI链接快速集成到系统入口(如通过语音指令“打开购物软件商品详情页”直接跳转) | 光标或选中的代码在一个class类中,且该类所在的工程module.json配置文件中配置了module->abilities->skills->uris(list配置) |
| @InsightIntentPage | 将应用内的一个Page页面定义为意图,实现从系统入口直达应用内指定页面,适用于需要直接打开特定功能页面的场景(如”查看我的订单”跳转到订单列表页) | 光标或选中的代码在一个被@Component装饰了的struct中 |
| @InsightIntentFunctionMethod | 与@InsightIntentFunction组合使用,将类中的静态函数定义为轻量级意图,无需绑定Ability组件。适合执行一些不需要复杂UI的后台操作,比如用户可以对小艺说“清理手机缓存”或“打开定位” | @InsightIntentFunction和@InsightIntentFunctionMethod需配套使用,@InsightIntentFunction用于装饰class,@InsightIntentFunctionMethod用于装饰class中的静态函数。因此需要光标或选中的代码在一个被@InsightIntentFunction装饰的class中的静态方法中。 |
| @InsightIntentForm | 定义卡片式意图,通过FormComponent组件创建意图卡片,适用于需要添加服务卡片的场景(如天气卡片、日程提醒卡片) | 光标或选中的代码在一个继承了FormExtensionAbility的类中 |
| @InsightIntentEntry | 是功能更强大和灵活的一个装饰器,绑定UIAbility/UIExtensionAbility组件,允许你配置Ability的执行模式(前台或后台),你可以在对应的模式回调方法中实现复杂的意图处理逻辑,比如跳转到不同的页面或执行一系列操作 | 光标或选中的代码在一个继承了InsightIntentEntryExecutor的类中 |
以下图中的一个生成播放指定音乐的意图装饰器为例,点击意图的页面意图子菜单,可在CodeGenie的对话窗口中输入提示词(可选),告诉小艺你想要生成的意图注解:

点击发送按钮(或回车键)即可生成意图注解代码:

最后一步,将生成的意图注解插入到MusicListPage类的头部后,在装饰器的代码块内点击“右键” => “Code Genie” => “Add Intent Plugin”,即可在IDE的内嵌的小艺智能体平台中完成意图插件注册,并在该平台上进行智能体的创建。

Application Agent:让你的 App 会说话
Application Agent是什么?
Application Agent是DevEco Studio 6.0.0.848版本上正式推出的插件,专为开发者打造的智能体创建与管理工具。它的使命很明确:让开发者不再“窗口满天飞”,在 IDE 里就能搞定意图插件注册、智能体创建等关键步骤,省去打开浏览器的繁琐流程,专注写代码,效率拉满。


你只需几步操作,就能将你的App接入小艺开放平台,实现语音唤醒和智能交互。例如,开发了一个音乐App,用户在小艺App中搜索对应的智能体,输入意图“请播放《Dream It Possible》”,你的App就能自动拉起并播放对应歌曲。是不是有点酷?
Application Agent能做什么?
展示已注册的意图插件
你可以使用CodeGenie插件生成意图注解,然后在意图注解代码块内,点击Add Intent Plugin会在小艺开放平台注册意图插件,你可以打开Application Agent插件,点击插件Tab页可以看到刚刚注册的意图插件。

创建智能体并绑定意图插件
整个流程都可以在Application Agent插件中完成,无需跳转浏览器或切换平台,真正实现一站式开发体验。
1)确保意图插件已上架
意图插件注册完成后,默认处于草稿状态。此时它还无法被智能体识别和绑定。你需要先完成插件的上架操作,否则在后续创建智能体时将无法选择该插件进行绑定。
2)填写智能体基本信息

3)补充智能体交互细节。

4)绑定意图插件并完成上架
在智能体配置完成后,选择已上架的意图插件进行绑定。绑定成功后,你可以进行智能体的上架操作。通过审核后,用户即可在小艺 App 中通过语音指令唤醒你的智能体,实现与 App 的无缝连接。

总结

在 DevEco Studio 中,CodeGenie 和 Application Agent 插件的组合,不仅让意图开发变得轻松高效,更让你的 App 拥有了“听得懂、能回应”的智能能力。
构建一个面向手机AI智能体的应用,绝非简单的功能扩展,而是一次根本性的范式转变。它要求我们从“应用为中心”转向“以用户意图为中心”,通过标准化的语义接口、场景化的上下文理解与动态化的服务聚合,将APP从功能孤岛转化为AI智能体可灵活调用的能力模块。未来,随着多模态交互(语音、视觉、环境感知)的普及与 AI 个性化能力的深化,意图框架还将向 “意图动态学习”“跨场景意图关联”“用户偏好适配”等方向演进。对开发者而言,是拥抱全新流量入口与服务分发模式的机遇;对用户而言,意味着无缝、主动、个性化的服务体验将成为现实;而对整个移动生态而言,这则是构建一个以用户意图为枢纽、应用能力深度融合的协同智能体的关键一步。而积极拥抱这一框架的先行者,必将在这场人机交互的变革中占领先机。
如果你正在开发 ArkTS 项目,不妨试试这两个插件。也许你的下一个用户,只需一句话,就能与你的 App 建立连接。

微信扫一扫打赏
支付宝扫一扫打赏