意图装饰器生成和小艺智能体创建
===============

通过装饰类或方法可以将应用的功能定义为"意图"，然后将应用功能以"意图"形式集成至系统入口。用户通过系统入口（如语音助手、智能推荐卡片）触发意图执行，即可便捷使用应用提供的功能。

从DevEco Studio 6.0.0 Beta2开始，CodeGenie新增通过装饰器开发意图的功能，支持生成五类意图装饰器。同时，DevEco Studio新增Application Agent入口，通过该入口可完成意图插件注册、智能体创建等，提升开发效率。

#### 使用约束

*   使用API 20及以上版本。
*   仅支持使用团队账号登录时，添加意图插件。个人加入目标团队方式具体可参考[添加成员](https://developer.huawei.com/consumer/cn/doc/app/agc-help-manageaccount-0000002306610129#section151241455193313)。
*   应用在AGC已注册，具体可参考[创建HarmonyOS应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506#section1772711713288)。
*   生成意图装饰器时使用HarmonyOS Ask智能体。

#### 意图装饰器分类

CodeGenie提供了几类意图装饰器，开发者可根据业务场景进行选择，具体请参考[意图装饰器定义](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-insightintentdecorator)：

*   @InsightIntentLink装饰器：在class头部或内部位置唤起意图装饰器，在class上方插入生成的代码。
*   @InsightIntentPage装饰器：在@Component头部/struct结构体内部/选中整个结构体区域唤起意图装饰器，在@Entry上方插入生成的代码。
*   @InsightIntentFunction装饰器：在类中静态方法区域唤起意图装饰器，在class上方插入@InsightIntentFunction，在class内部插入@InsightIntentFunctionMethod生成内容。
*   @InsightIntentForm装饰器：在继承FormExtensionAbility的class头部或内部唤起意图装饰器，在class上方插入生成的代码。
*   @InsightIntentEntry装饰器：在直接继承InsightIntentEntryExecutor的class头部或内部唤起意图装饰器，在class上方插入生成的代码。

#### \[h2\]@InsightIntentLink装饰器

1.  打开module.json5文件，配置**abilities > skills > uris**字段。uri格式要求请参考[应用链接说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-uri-config)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/35/v3/-IqwrRqMQ4GLwFcjFip6aQ/zh-cn_image_0000002625074319.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=BB33D6CEA4D44F5E772CE0DF3EC40A5540108EF6E877AE839F31EB8A71FD7C39 "点击放大")
    
2.  在class头部或内部位置，右键选择 **CodeGenie > Insight Intent > Link Insight Intent**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/de/v3/WWPlov1GSJyElYf2-gQUlw/zh-cn_image_0000002625074323.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=F518783AAFEEC2A43107C8E8251CD4FFB36F43192A972462EE4DCC21AB15759F "点击放大")
    
3.  意图装饰器自动添加至CodeGenie对话框中，可选择输入或不输入提示词，CodeGenie根据代码上下文分析输出结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/7f/v3/GkO5toUMQM2NwZtXFNNLTQ/zh-cn_image_0000002625074315.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=D81276501D893334E4D4DA8F30E6CF648BAC5E8C75F5B9FAE4FD38BD4699BDE1 "点击放大")
    
4.  生成结果后，点击对话框中生成代码块右上方的**插入**按钮，在class上方插入生成的代码。开发者可基于结果微调，实现意图调用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0a/v3/2oGhuSyVSYG_SxKc-UloVA/zh-cn_image_0000002625074325.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=ECC25657E010394A80D4269652E25B22ED462D7422FBF851E1B8C10863DB099F "点击放大")
    

#### \[h2\]@InsightIntentPage装饰器

基于组件导航（Navigation）的子页面使用，@Component和struct需成对出现。

1.  在@Component头部\\struct结构体内部\\选中整个结构体区域，点击**右键 > CodeGenie > Insight Intent > Page Insight Intent**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/1f/v3/I0rbnqhNSIuTi85H5XmyhA/zh-cn_image_0000002594634744.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=7EE92A61ABBB44A05FAF433F0470B56D5E3380D0CFF44015AE12417FC13E45E6)
    
2.  意图装饰器自动添加至CodeGenie对话框中，可选择输入或不输入提示词，CodeGenie根据代码上下文分析输出结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ef/v3/PsP2kM76QPOsH6LxOyfCRw/zh-cn_image_0000002625074317.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=AE0750C9F90985F4266AA7448FC96FE42414406B9F6E01BF37873B2BCEC4C3CC "点击放大")
    
3.  生成结果后，点击对话框中生成代码块右上方的**插入**按钮，在@Entry上方插入生成的代码。开发者可基于结果微调，实现意图调用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c8/v3/5l9XVJHOQS-L3aY0I0mJjw/zh-cn_image_0000002594634736.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=F17FA2A9D4462130B5E7A9E0A137AB72F42DEE0C5DFF1512A722EA5A8C244095 "点击放大")
    

#### \[h2\]@InsightIntentFunction装饰器

1.  在类中静态方法区域，右键选择 **CodeGenie > Insight Intent > Function Insight Intent**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4a/v3/8A1f1qv7SDqeoPt1w3OTjQ/zh-cn_image_0000002594634746.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=6BDEABA196443FC80C967A7AF024D51A8B5AC30F2EB2D0CAF4D94D5E4D69B52E)
    
2.  意图装饰器自动添加至CodeGenie对话框中，可选择输入或不输入提示词，CodeGenie根据代码上下文分析输出结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3c/v3/mXYezyjjSk-rVAWHkbLD9w/zh-cn_image_0000002624994175.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=C1A68A8329F0A2E18D7C1F166C67E9585E4B33EFD2DE597AB40DFDD40A34CB8B "点击放大")
    
3.  生成结果后，点击对话框中生成代码块右上方的**插入**按钮，在class上方插入@InsightIntentFunction，在class内部插入@InsightIntentFunctionMethod生成内容。开发者可基于结果微调，实现意图调用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d0/v3/o9MpdvE_SnaVQ2IDGxNyxg/zh-cn_image_0000002624994183.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=770020FFCC89CF0AC8C4EE6E9674EFFD034DADDC8E5BB9AAAAF804FAECBE203A "点击放大")
    

#### \[h2\]@InsightIntentForm装饰器

1.  基于FormExtensionAbility使用，在继承FormExtensionAbility的class头部或内部，右键选择**CodeGenie > Insight Intent > Form Insight Intent**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/84/v3/YInh3fIaSuiL8n2Wb7hDCA/zh-cn_image_0000002594474816.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=0256423E69363369393FDE3BE3B2246E493460840617989B3E6407D34EC9202D)
    
2.  意图装饰器自动添加至CodeGenie对话框中，可选择输入或不输入提示词，CodeGenie根据代码上下文分析输出结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/77/v3/76zBWtGTTQa-qnYM8KMghg/zh-cn_image_0000002624994179.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=15E7B8BF7B65603EE9AF29A15F92CBDF916DB2850AE5B93882A08D9D30649707 "点击放大")
    
3.  生成结果后，点击对话框中生成代码块右上方的**插入**按钮，在class上方插入生成的代码，开发者可基于结果微调，实现意图调用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/22/v3/AGHvTG59TV24rYmPUSOD1g/zh-cn_image_0000002625074327.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=F84C9040E691E47D94C85A5C860E6B639BE8A16784F7CADE6B485175DF83C092 "点击放大")
    

#### \[h2\]@InsightIntentEntry装饰器

1.  基于InsightIntentEntryExecutor使用，在直接继承InsightIntentEntryExecutor的class头部或内部，右键选择**CodeGenie > Insight Intent > Entry Insight Intent**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e6/v3/V1S22XMbT_KvgvrG3n5RBA/zh-cn_image_0000002625074321.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=6B9C6F0AFD2166EDD38246182859FA67FB588A5139A0E00155147BDA4E1125D6)
    
2.  意图装饰器自动添加至CodeGenie对话框中，可选择输入或不输入提示词，CodeGenie根据代码上下文分析输出结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f9/v3/ycEVy7sfRzi8i0M6AlsNqQ/zh-cn_image_0000002594474814.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=5194B869B1A37F04C2F6B6BE9E94D7A22C14A762130CCAE355F57E684680CD40 "点击放大")
    
3.  生成结果后，点击对话框中生成代码块右上方的**插入**按钮，在class上方插入生成的代码，开发者可基于结果微调，实现意图调用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a0/v3/uPpvan8YQjSS14Yik7LqCw/zh-cn_image_0000002594474812.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=5A73D0FBB3E841982357BB31A0D1E91C394FC3F49C90F722170C2FE0AC5C9F42 "点击放大")
    

#### 生成意图插件和创建小艺智能体

1.  点击DevEco Studio右上角![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/34/v3/PHyH9C6RSCezyDdo8-UOTQ/zh-cn_image_0000002594634738.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=305B1EA93AB4B38D7DE0326484616470ABD2CBEF630DB0690AB95A9425F0C52F)图标登录个人账号，再切换至个人所在的团队账号。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/aa/v3/LCK_ZTzBTT2LWeKwYTGlxA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=4439CBD5C0DEA6AF6ADE0AEFFF34E9315CA072C16C1BEA5ACFFADB6E60B906FD)
    
    *   个人账号需要完成实名认证，具体请参考[实名认证](https://developer.huawei.com/consumer/cn/doc/start/rna-0000001062530373)。
    *   如下企业开发者账号为某团队账号名称，仅供参考。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/44/v3/QInZhLHoRk6IQYDCtxfoRg/zh-cn_image_0000002594474824.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=54629F1644518D433CA250CAEA384556366808734F84E92F0C100F821ACE37AA)
    
2.  在意图注解代码块内部任意位置，右键选择**CodeGenie > Add Intent Plugin**，生成的意图注解插件将注册到小艺智能平台中。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/38/v3/ptCvrMpxQGGRU2zVsGd5Xw/zh-cn_image_0000002594634742.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=DF44C2165ACAA8C82885C36ECFA3DD3A465BFD1E5ABE2AFBB819460889D27490 "点击放大")
    
3.  在DevEco Studio菜单栏点击**View > Tool Windows > Application Agent** ，打开内嵌的小艺智能平台新建智能体和添加插件。小艺智能平台更多具体操作可参考[鸿蒙智能体](https://developer.huawei.com/consumer/cn/doc/service/developer-guide-0000002469667881)。