# 插件介绍
## 什么是插件？
插件是一个工具集，一个插件内可以包含一个或多个工具（API）。
目前，扣子编程集成了类型丰富的插件，包括资讯阅读、旅游出行、效率办公、图片理解等 API 及多模态模型。使用这些插件，可以帮助你拓展智能体能力边界。例如，在你的智能体内添加新闻搜索插件，那么你的智能体将拥有搜索新闻资讯的能力。
如果扣子编程集成的插件不满足你的使用需求，你还可以创建自定义插件来集成需要使用的 API。
## 插件与工具
扣子编程支持创建自定义插件。每个插件可添加多个工具，同一个插件内的不同工具必须使用相同的域名。插件中的每个工具都是一个独立的 API。智能体调用插件时，实际上是调用插件中的某个工具，也就是调用某个 API。
例如，一个天气查询的 API Service 可能会包含以下两个 API：
* 查询当前天气：`http://api.weather.com/current`
* 查询未来天气：`http://api.weather.com/forecast`
那么在创建插件时，每个 API 就是一个插件下的一个工具。
## 插件分类
扣子编程拥有丰富的插件资源，支持开发资源库插件，并提供官方插件及第三方插件，你可一键添加使用。其中，官方插件及第三方插件均包含免费插件和付费插件。
| **插件分类** | | **说明** |
| --- | --- | --- |
| 资源库插件 | | 开发者在资源库中自行开发的插件，仅供当前帐号内使用。
资源库插件由开发者自行维护和更新。 |
| 插件商店插件 | 官方插件 | 由扣子编程上架到插件商店的插件，扣子编程会提供全面技术支持和维护，确保稳定性与兼容性。
包括免费插件和付费插件：
* 免费插件：无需付费，所有扣子用户均可使用。
* 付费插件：根据插件调用量（次数、时长等）收取一定费用。付费插件列表及收费说明，请参考[插件费用](https://www.volcengine.com/docs/84458/1468047)。 |
| | 三方插件 | 由开发者开发并上架到插件商店的插件，包括免费插件和付费插件：
* 免费插件：无需付费，所有扣子用户均可使用。
* 付费插件：仅扣子计费套餐用户可使用三方的付费插件。三方的付费插件会有**三方**、**付费**标识。使用三方的付费插件时，将根据插件调用量（次数、时长等）从使用者的现金账户余额中扣除，不支持积分抵扣。 |
## 费用说明
### **官方插件**
扣子编程根据收费插件的调用量收费，每小时统计插件用量，并通过积分方式抵扣费用。扣子编程官方收费插件列表及收费说明，请参考[插件费用](https://docs.coze.cn/api/open/docs/coze_pro/plugin_fee)。
* 如果某个插件内包含多个工具，则调用这些工具的次数将共同计入该插件的免费额度。
* 在**企业标准版、企业旗舰版**中，超级管理员及其所有成员共享套餐内的插件免费额度。
### 三方插件
使用三方的付费插件时，将根据插件调用量（次数、时长等）从使用者的现金账户余额中扣除，不支持积分抵扣。三方插件的价格由插件开发者自行设定。相关计费项说明，请参考[插件费用](https://docs.coze.cn/api/open/docs/coze_pro/plugin_fee)。
## 使用限制
插件使用限制如下表所示。
| **限制项** | **说明** |
| --- | --- |
| 插件数量 | * 每个工作空间下最多可创建 1000 个插件。
* 每个账号下最多可创建 30 个 IDE 插件。 |
| 插件工具数量 | 每个插件中最多包含 100个工具。 |
| QPS | * 官方付费插件 QPS 请参考[插件费用](https://docs.coze.cn/api/open/docs/coze_pro/plugin_fee)。
* 自定义插件的 QPS 最大值为 50。 |
| 依赖包总大小 | 开发插件时，支持添加的依赖包总大小上限为 250 MB。 |
| 发布渠道 | 添加了三方的付费插件的低代码智能体或应用（工作流），不支持发布到飞书多维表格、掘金、豆包及部分公共渠道。 |
## 权限说明
插件相关的权限说明如下：
| **操作** | **说明** |
| --- | --- |
| 创建、查看、复制插件 | 工作空间内的所有成员均可以创建插件，查看、复制空间内的所有插件。 |
| 编辑、发布、删除插件 | 企业超级管理员、工作空间管理员、工作空间所有者均可以编辑、删除、发布空间内的所有插件。 |
## 操作导航
| **操作** | **描述** |
| --- | --- |
| 创建自定义插件 | 扣子编程提供了多种创建自定义插件的方式供你选择，相关操作步骤可参见以下文档。
* [基于 API 创建插件](https://docs.coze.cn/api/open/docs/guides/services)
* [使用 IDE 创建插件](https://docs.coze.cn/api/open/docs/guides/ide)
* [通过 JSON 或 YAML 文件导入插件](https://docs.coze.cn/api/open/docs/guides/import)
* [使用代码注册插件](https://docs.coze.cn/api/open/docs/guides/use_code) |
| 使用插件 | 插件可以直接在智能体内使用，拓展智能体的能力边界。插件也可以作为节点添加到低代码工作流，实现工作流的任务处理能力。详情参见[使用插件](https://docs.coze.cn/api/open/docs/guides/use_plugin)。 |