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