添加插件

AgentArts提供了一个丰富的插件生态系统，以增强智能体的能力。插件是一种工具集，一个插件即是一个API工具。

目前，AgentArts集成了类型丰富的插件，包括OCR识别、文件处理、代码解释器、全网热搜榜、高德地图等工具，这些插件能够帮助开发者快速为智能体添加特定功能。此外，平台还支持创建自定义插件，允许开发者将已有的API能力通过参数配置的方式快速集成到智能体中，进一步丰富智能体功能。

关于插件的详细介绍，请参考插件介绍。

前提条件

登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考管理团队空间成员。
如果需要添加个人插件，请确保已完成个人插件的创建插件和调试发布插件。
如果需要添加预置插件，请确保已对插件进行鉴权，详细信息请参考使用平台精选的插件。
如果需要添加共享插件，请确保已有他人共享的插件。

约束与限制

仅AgentArts企业版支持使用他人共享的应用。AgentArts基础版不支持该能力。

表1 插件限制说明
类别	说明
最大工具数量	最多支持添加数量20个。
插件URL	URL协议只支持HTTP和HTTPS。
请求方法	插件服务的请求方式，POST或GET。

添加插件

应用支持添加插件技能，可添加“我的插件”、“插件广场”、“共享插件”和“创建插件”。如果“我的插件”、“插件广场”和“共享插件”不满足用户需求，可以单击左上角“创建插件”，详细参数配置请参见基于API创建插件，插件创建成功后在“插件创建成功”界面单击“确定”即可直接添加插件。

添加预置插件
1. 登录AgentArts智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 单击左侧导航栏“开发中心 > 智能体管理 ”，单击左上角“单智能体”页签，进入单智能体应用管理界面。
3. 单击目标单智能体应用，在“技能 > 插件”模块，单击。
4. 在“添加插件工具”窗口，选择“插件广场”，单击目标插件右侧的展开工具列表，在展开的列表中单击目标工具右侧的“添加”进行添加，并单击“确定”。
  平台提供的插件分为免费和付费两种:
  - 免费插件：免费插件无需购买，无需鉴权的插件可以直接使用，未鉴权的插件设置鉴权后即可使用。设置鉴权请参考使用资产广场的插件资源。
  - 付费插件：付费插件需要先购买并设置鉴权后才能使用，单击“获取鉴权信息”可跳转至购买和获取API Key的页面。
  您可以通过属性类型（插件名称、插件英文名称和插件描述）或搜索关键字的功能来查找插件。
  图1 添加预置插件
5. 添加插件后，可在“技能 > 插件”中查看当前已添加的插件工具。
  图2 已添加插件
  
  已添加的插件单击支持配置插件参数。当参数“可见性”开关关闭时，智能体将无法查看和修改该参数，且在智能体运行时不会动态提取该参数。对于一些不需要智能体动态提取的固定参数，例如密钥等，可以关闭其可见性。
6. 插件添加成功后，在提示词模块修改人设与回复逻辑，指示智能体调用“插件”处理问题。
  
  添加插件后，建议调试智能体，检查被添加的插件是否可以正常使用。
添加个人插件
1. 登录AgentArts智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 单击左侧导航栏“开发中心 > 智能体管理”，单击左上角“单智能体”页签，进入单智能体应用管理界面。
3. 单击目标单智能体应用，在“技能 > 插件”模块，单击。
4. 在“添加插件工具”窗口，选择“我的插件”，单击目标插件右侧的展开工具列表，在展开的列表中单击目标工具右侧的“添加”进行添加，并单击“确定”。
  图3 添加我的插件
5. 添加插件后，可在“技能 > 插件”中查看当前已添加的插件。
6. 插件添加成功后，在提示词模块修改人设与回复逻辑，指示智能体调用“插件”处理问题。
  
  添加插件后，建议调试智能体，检查被添加的插件是否可以正常使用。
移除插件
1. 登录AgentArts智能体平台，在左侧导航栏“个人空间”区域，选择目标空间。
2. 选择左侧导航栏“开发中心 > 智能体管理”，单击左上角“单智能体”页签，进入单智能体应用管理界面。
3. 单击目标单智能体应用，在“技能 > 插件”模块，单击需要删除的插件，在插件右侧单击。
4. 页面提示“插件删除成功”则表示插件已移除。