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

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

从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/2c/v3/r7JKudpvQ-WrVlQ5ONNZlA/zh-cn_image_0000002625074319.png?HW-CC-KV=V1&HW-CC-Date=20260709T132838Z&HW-CC-Expire=86400&HW-CC-Sign=96BB5B8988484D09F67A6EB1142C2412B4FDE1F8C7E89E2D5B88E1D6AF8A8D24 "点击放大")
    
2.  在class头部或内部位置，右键选择 **CodeGenie > Insight Intent > Link Insight Intent**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/40/v3/P1pKWnJDQlKtdVNsBse5jA/zh-cn_image_0000002625074323.png?HW-CC-KV=V1&HW-CC-Date=20260709T132838Z&HW-CC-Expire=86400&HW-CC-Sign=6BEF13858F37BFAA80A551CA1285E7AF9CE02F55C211568A5B86E36C3C98B4BD "点击放大")
    
3.  意图装饰器自动添加至CodeGenie对话框中，可选择输入或不输入提示词，CodeGenie根据代码上下文分析输出结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c7/v3/bs3SlXT0TnC0jk-ttUTOdg/zh-cn_image_0000002625074315.png?HW-CC-KV=V1&HW-CC-Date=20260709T132838Z&HW-CC-Expire=86400&HW-CC-Sign=51F82EF3B372E6A482268461357E7C12ED4933168FB4B38BBC3E937767C731B1 "点击放大")
    
4.  生成结果后，点击对话框中生成代码块右上方的**插入**按钮，在class上方插入生成的代码。开发者可基于结果微调，实现意图调用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9e/v3/yQAvQwbsT6C1lN3Lzsjr3A/zh-cn_image_0000002625074325.png?HW-CC-KV=V1&HW-CC-Date=20260709T132838Z&HW-CC-Expire=86400&HW-CC-Sign=CC489E572A453C92586150F98382E3D75AF466AB8DE7B74B8B4FC65BEF1115AE "点击放大")
    

#### \[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/5c/v3/GEkSU6hoRfmNt2KgG5V44g/zh-cn_image_0000002594634744.png?HW-CC-KV=V1&HW-CC-Date=20260709T132838Z&HW-CC-Expire=86400&HW-CC-Sign=ED4FF4163288A90ED28D8DC048DD30FA794EF4757A0E71DD870037EFB8105C28)
    
2.  意图装饰器自动添加至CodeGenie对话框中，可选择输入或不输入提示词，CodeGenie根据代码上下文分析输出结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/72/v3/rAC-QoQATwuvsKZ3ii-qoA/zh-cn_image_0000002625074317.png?HW-CC-KV=V1&HW-CC-Date=20260709T132838Z&HW-CC-Expire=86400&HW-CC-Sign=DEF544B53C8B1631CF9A26F405532C88833CA0B4532FB8D1D766D5D2A66CD925 "点击放大")
    
3.  生成结果后，点击对话框中生成代码块右上方的**插入**按钮，在@Entry上方插入生成的代码。开发者可基于结果微调，实现意图调用。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c6/v3/Ub08F40HTvSVzl_q2avHFg/zh-cn_image_0000002594634736.png?HW-CC-KV=V1&HW-CC-Date=20260709T132838Z&HW-CC-Expire=86400&HW-CC-Sign=03FDAD67BC36B64F9BC104AD6068A5FB4AEBB292AD30A135453B0A228CD7AC10 "点击放大")
    

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

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

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

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

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

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

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

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