自定义智能体（Agent）配置和调用
==================

从DevEco Studio 6.0.1 Beta1开始，CodeGenie支持用户添加模型和自定义Agent，增强AI问答能力，提升AI辅助编程和分析能力。

从DevEco Studio 6.0.2 Release（6.0.2.646）开始，支持智能体切换模型和配置三方模型。

#### Agent配置

1.  可以通过如下两种方式进入Agent配置页面。
    
    *   点击界面右上方![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4a/v3/7kKhsmEVSEWDu0rQAcmkrg/zh-cn_image_0000002625074235.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=32EEBF0DEBD8F26C5ED9110BFAAC7E7CAB7CE4F327AD0F2597A8256E411EBDAC "点击放大")按钮或者点击界面右上方**Settings**![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/95/v3/FFeAP3M0Q3GNJngGUp491w/zh-cn_image_0000002594474730.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=F3E0D72F13FD1DF6346AB1839BC0DDB0227B9D408F16617956516A72CD1A0319)按钮，选择**Agent**。
    *   在输入框左下角下拉框选择**Create Agent**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/51/v3/UjueVvqbT8GJES4YvKrmvg/zh-cn_image_0000002625074239.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=7E758EB57D722ADAF2932DC6B482B4B395C84FCD603597DD9C0A41559C169F74 "点击放大")
    
2.  点击![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5a/v3/ebbPgYowQ72N25O9V9M8yQ/zh-cn_image_0000002624994093.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=9CD6E055F7E81841CA3728E614E0F391C8055BE648366B14B04E9C9F799E7571 "点击放大")按钮，填写自定义Agent的相关信息。点击**Add**，将创建自定义Agent。
    
    *   **Name**：必填，自定义Agent的名称。
    *   **Prompt Description**：可选，自定义Agent的提示词。
    *   **MCP Tools**：可选，添加MCP工具，具体请参考[MCP配置](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-agent-mcp)。
    *   **Built-in Tools**：DevEco Studio 6.0.2 Beta1新增，可选，内置工具，包含File Manager、Terminal、Compile and Build、Web Rag、To Do、Skill、UI Verification，默认开启。
        
        | 
        工具名称
        
         | 
        
        说明
        
         |
        | :-- | :-- |
        | 
        
        File Manager
        
         | 
        
        开启后，支持读写本地的代码文件。
        
         |
        | 
        
        Terminal
        
         | 
        
        开启后，在CodeGenie对话框执行命令时可自动拉起Terminal终端。
        
         |
        | 
        
        Compile and Build
        
         | 
        
        开启后，支持编译与构建项目。
        
         |
        | 
        
        Web Rag
        
         | 
        
        开启后，支持在问答过程中检索鸿蒙相关的资料，提升答复准确性。
        
        DevEco Studio 6.1.0 Beta2新增。
        
         |
        | 
        
        To Do
        
         | 
        
        开启后，支持把一个复杂任务拆解成多步执行，帮助CodeGenie聚焦任务，避免遗忘任务，提升答复准确性。
        
        DevEco Studio 6.0.2 Release（6.0.2.646）新增。
        
         |
        | 
        
        Skill
        
         | 
        
        开启后，支持在自定义智能体中使用配置的Skill。
        
        DevEco Studio 6.1.0 Release（6.1.0.830）新增。
        
         |
        | 
        
        UI Verification
        
         | 
        
        开启后，支持通过自然语言描述测试步骤，自动在HarmonyOS设备上执行UI操作并验证结果。
        
        26.0.0 Beta1新增。
        
         |
        
    *   **Select Model**：必填，选择需要使用的模型，具体请参考[模型（Model）配置](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-agent-model)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/45/v3/A3LQ5fcqQXaePXBFmpde-A/zh-cn_image_0000002624994095.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=3C01048913E50590A778FCA88A04E8ED40EA81695F39F6C4D6F767ACB0F92C73 "点击放大")
    
3.  在**All Agents**下展示所有智能体。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e8/v3/rCdVv3JXROKXCKVqjdAj-w/zh-cn_image_0000002624994091.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=08EFE316F44AF74D2AF159A95CE05B18DA04044CCAAE261E274075D2B88FE7E1)
    
4.  设置自动执行开关和白名单列表。
    
    *   **Auto Run**：DevEco Studio 6.0.2 Beta1新增，内置工具（命令行工具除外）和MCP工具被调用过程中，自动执行的开启开关。开启时，工具被调用可自动执行和输出内容；关闭时，工具被调用需开发者授权。默认关闭。
    *   **AllowList**：DevEco Studio 6.0.2 Beta1新增，白名单列表，开启Auto Run后，白名单中的命令同样会自动执行。点击**Enter Command**中输入命令，点击**Add**可将命令添加至白名单列表；点击命令后×，可将命令从白名单列表中删除。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fb/v3/UIFdXQcuSIeZEbBtfjPaRA/zh-cn_image_0000002594634650.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=72AAD723A973EDC3A33107B19396CF11ABEC7E6FD38C4343B4603C4C26267007 "点击放大")
    
5.  选择自定义智能体后，开发者可以切换模型，包括内置模型/默认模型（deepseek-v3.2、glm-5）和三方模型（如deepseek）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b7/v3/GY4iWOCNRZ6IBy1C0qVmPA/zh-cn_image_0000002624994089.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=F25D3B11FC808036B1801B077A4CB34AB9E789E59A88FDFFA05AC6E487803EA6)
    
6.  点击置灰的三方模型会跳转到Service Provider配置界面（如**deepseek-chat**），填写**API Key**字段即可添加模型。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ba/v3/zWKcyujvTTG1gpYPYP4w8Q/zh-cn_image_0000002625074231.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=5B0B8CDB2ED78331EE0B1369E549F627CB6F4821E4141CF38EF06BAA95C38C03 "点击放大")
    

#### Agent调用

1.  Agent配置完成后，可以通过如下两种方式开启调用：
    
    *   在对话区域输入"/"调出命令，选择自定义的Agent（如**figma2code**）。从DevEco Studio 6.1.0 Beta2开始不支持。
    *   在输入框左下角HarmonyOS Ask处下拉框中选择自定义的Agent（如**figma2code**）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/cc/v3/z08wt74tRkC2RTJ-enzY8w/zh-cn_image_0000002625074233.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=6D932D8D3ED8E67EB2C1BA2A1CF9856CF1C02A6A709F7D4A44937B46EE1626E6)
    
2.  选择自定义Agent后，在右侧可以切换模型，默认使用配置Agent时添加的模型。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/91/v3/dhkHj8dTTZyeAooll10Ipg/zh-cn_image_0000002594634654.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=405BFB2FF2392A2DE2EC2B9BC7B5DDC9D3608E94F6718FCD7F1F3B8B054DFDFA)
    
3.  根据业务需要，进行智能问答、代码生成、代码智能解读等，CodeGenie将会调用自定义Agent和选择的模型生成内容。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c7/v3/Vw8bMjvtSdekYACqq2CIjw/zh-cn_image_0000002625074237.png?HW-CC-KV=V1&HW-CC-Date=20260612T073830Z&HW-CC-Expire=86400&HW-CC-Sign=12B523E5B913503C381AE7B599DF9D9CAADB862A21B0772664F030117703ADC6 "点击放大")