# 添加插件
AgentArts提供了一个丰富的插件生态系统，以增强智能体的能力。插件是一种工具集，一个插件即是一个API工具。
目前，AgentArts集成了类型丰富的插件，包括OCR识别、文件处理、代码解释器、全网热搜榜、高德地图等工具，这些插件能够帮助开发者快速为智能体添加特定功能。此外，平台还支持创建自定义插件，允许开发者将已有的API能力通过参数配置的方式快速集成到智能体中，进一步丰富智能体功能。
关于插件的详细介绍，请参考[插件介绍](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0123.html)。
#### 前提条件
- 登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考[管理团队空间成员](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0216.html)。
- 如果需要添加个人插件，请确保已完成个人插件的[创建插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0125.html)和[调试发布插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0129.html)。
- 如果需要添加预置插件，请确保已对插件进行鉴权，详细信息请参考[资产广场](https://support.huaweicloud.com/productdesc-agentarts0/agentarts_03_0028.html)。
- 如果需要添加共享插件，请确保已有他人共享的插件。
 
#### 约束与限制
仅**AgentArts** **企业版** 支持使用他人共享的应用。**AgentArts基础版**不支持该能力。
表1插件限制说明 
| 类别     | 说明                  |
|:---|:---|
| 最大工具数量 | 最多支持添加数量20个。        |
| 插件URL  | URL协议只支持HTTP和HTTPS。 |
| 请求方法   | 插件服务的请求方式，POST或GET。 |
   
#### 添加插件
应用支持添加插件技能，可添加"插件广场"、"组件库插件"、"团队共享"形式的插件，并可以单独"创建插件"。如果"组件库插件"、"插件广场"和"共享插件"不满足用户需求，可以单击左上角"创建插件"，详细参数配置请参见[基于API创建插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0126.html)，插件创建成功后在"插件创建成功"界面单击"确定"即可直接添加插件。
- **添加预置插件**
  1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。
  
  2. 单击左侧导航栏"开发中心 \> 智能体管理 "，单击左上角"单智能体"页签，进入单智能体应用管理界面。
  
  3. 单击目标单智能体应用，在"技能 \> 插件"模块，单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538385004.png)。
  
  4. 在"添加插件工具"窗口，选择"插件广场"，单击目标插件右侧的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538385008.png)展开工具列表，在展开的列表中单击目标工具右侧的"添加"进行添加，并单击"确定"。
     平台提供的插件分为免费和付费两种:
     - **免费插件：**免费插件无需购买，无需鉴权的插件可以直接使用，未鉴权的插件设置鉴权后即可使用。
     
     - **付费插件：**付费插件需要先购买并设置鉴权后才能使用，单击"获取鉴权信息"可跳转至购买和获取API Key的页面。
      
     您可以通过属性类型（插件名称、插件英文名称和插件描述）或搜索关键字的功能来查找插件。
     图1添加预置插件   
     ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538385002.png) 
  
  5. 添加插件后，可在"技能 \> 插件"中查看当前已添加的插件工具。
     图2已添加插件   
     ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544934.png)
     相关操作：
     - 鼠标放置在"![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544930.png)"图标上，支持快速查看插件参数详情。
     
     - 单击"![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538384994.png)"参数配置图标支持配置插件参数。可与[为应用添加记忆](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0026.html)结合使用。
       当参数"可见性"开关关闭时，智能体将无法查看和修改该参数，且在智能体运行时不会动态提取该参数。对于无需智能体动态提取的固定参数，例如密钥等，可关闭其可见性开关。
       
     
     - 添加插件后，若未配置鉴权需要单击"配置鉴权"进行操作。
      
  
  6. 插件添加成功后，在提示词模块修改人设与回复逻辑，指示智能体调用"插件"处理问题。
   
- **添加个人插件**
  1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。
  
  2. 单击左侧导航栏"开发中心 \> 智能体管理"，单击左上角"单智能体"页签，进入单智能体应用管理界面。
  
  3. 单击目标单智能体应用，在"技能 \> 插件"模块，单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538384988.png)。
  
  4. 在"添加插件工具"窗口，选择"组件库插件"，单击目标插件右侧的![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569424689.png)展开工具列表，在展开的列表中单击目标工具右侧的"添加"进行添加，并单击"确定"。
     图3添加组件库插件   
     ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538544926.png) 
  
  5. 添加插件后，可在"技能 \> 插件"中查看当前已添加的插件。
  
  6. 插件添加成功后，在提示词模块修改人设与回复逻辑，指示智能体调用"插件"处理问题。
   
- **移除插件**
  1. 登录[AgentArts智能体开发平台](https://console.huaweicloud.com/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。
  
  2. 选择左侧导航栏"开发中心 \> 智能体管理"，单击左上角"单智能体"页签，进入单智能体应用管理界面。
  
  3. 单击目标单智能体应用，在"技能 \> 插件"模块，单击需要删除的插件，在插件右侧单击![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569424693.png)。
  
  4. 页面提示"插件删除成功"则表示插件已移除。
   
 
#### 相关文档
AgentArts中配置插件的详细信息，请参考[创建插件](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0125.html)。