CodeGenie AI辅助开发意图，让小艺“看见”你的鸿蒙应用

手机越来越懂我们了。你说一句“查看我待取件的快递”，它就能精准打开快递软件服务卡片；你说“播放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生成意图装饰器需要以下几步：

1. 在DevEco Studio的编辑器中，在光标处或选中代码片段后“右键” => “CodeGenie” => “Insight Intent”=> 点击5种意图生成的子菜单；
2. 在Chat面板输入提示词（可选），点击Enter或发送即可生成您想要的意图注解装饰；
3. 将生成的注解装饰器插入到代码中合适的地方；
4. 在意图注解上点击“右键 ”=> 点击“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 建立连接。

更多高级使用技巧参考官网鸿蒙智能体开发指南：https://developer.huawei.com/consumer/cn/doc/service/developer-guide-0000002469667881