> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

## 什么是插件？ {#be11fdbc}
插件是一个工具集，一个插件内可以包含一个或多个工具（API）。
目前，扣子编程集成了类型丰富的插件，包括资讯阅读、旅游出行、效率办公、图片理解等 API 及多模态模型。使用这些插件，可以帮助你拓展智能体能力边界。例如，在你的智能体内添加新闻搜索插件，那么你的智能体将拥有搜索新闻资讯的能力。
如果扣子编程集成的插件不满足你的使用需求，你还可以创建自定义插件来集成需要使用的 API。
![Image=498x407](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/d02286f2ea43468aaef1b63486d00278~tplv-goo7wpa0wc-image.image)
## 插件与工具 {#7cd6b9bb}
扣子编程支持创建自定义插件。每个插件可添加多个工具，同一个插件内的不同工具必须使用相同的域名。插件中的每个工具都是一个独立的 API。智能体调用插件时，实际上是调用插件中的某个工具，也就是调用某个 API。
例如，一个天气查询的 API Service 可能会包含以下两个 API：

* 查询当前天气：`http://api.weather.com/current`
* 查询未来天气：`http://api.weather.com/forecast`

那么在创建插件时，每个 API 就是一个插件下的一个工具。

<div class="flow-chart-container"><svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="795px" height="295px" viewBox="-0.5 -0.5 795 295"><defs/><g><rect x="222" y="2" width="570" height="290" rx="43.5" ry="43.5" fill="#ffffff" stroke="#000000" pointer-events="all"/><rect x="242" y="82" width="510" height="77.5" fill="#ffffff" stroke="#000000" stroke-dasharray="3 3" pointer-events="all"/><rect x="359.5" y="100.75" width="90" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 121px; margin-left: 361px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">配置工具参数</div></div></div></foreignObject></g><rect x="489.5" y="100.75" width="90" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 121px; margin-left: 491px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">工具调试与校验</div></div></div></foreignObject></g><path d="M 449.5 120.75 L 483.13 120.75" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 488.38 120.75 L 481.38 124.25 L 483.13 120.75 L 481.38 117.25 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><rect x="644.5" y="100.75" width="90" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 121px; margin-left: 646px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">发布工具</div></div></div></foreignObject></g><path d="M 579.5 120.75 L 638.13 120.75" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 643.38 120.75 L 636.38 124.25 L 638.13 120.75 L 636.38 117.25 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 121px; margin-left: 613px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; ">成功</div></div></div></foreignObject></g><path d="M 329.5 120.8 L 349.5 120.8 L 339.5 120.8 L 353.13 120.8" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 358.38 120.8 L 351.38 124.3 L 353.13 120.8 L 351.38 117.3 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><rect x="259.5" y="100.75" width="70" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 68px; height: 1px; padding-top: 121px; margin-left: 261px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">工具 1<br />/current</div></div></div></foreignObject></g><path d="M 142 147.1 L 182 147.1 L 182 147 L 215.63 147" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 220.88 147 L 213.88 150.5 L 215.63 147 L 213.88 143.5 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><rect x="2" y="111.38" width="140" height="71.25" rx="10.69" ry="10.69" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 138px; height: 1px; padding-top: 147px; margin-left: 3px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">天气插件（https://api.weather.com/）</div></div></div></foreignObject></g><rect x="432" y="22" width="90" height="20" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 32px; margin-left: 433px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">添加工具</div></div></div></foreignObject></g><rect x="242" y="182" width="510" height="77.5" fill="#ffffff" stroke="#000000" stroke-dasharray="3 3" pointer-events="all"/><rect x="359.5" y="200.75" width="90" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 221px; margin-left: 361px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">配置工具参数</div></div></div></foreignObject></g><rect x="489.5" y="200.75" width="90" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 221px; margin-left: 491px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">工具调试与校验</div></div></div></foreignObject></g><path d="M 449.5 220.75 L 483.13 220.75" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 488.38 220.75 L 481.38 224.25 L 483.13 220.75 L 481.38 217.25 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><rect x="644.5" y="200.75" width="90" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 88px; height: 1px; padding-top: 221px; margin-left: 646px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">发布工具</div></div></div></foreignObject></g><path d="M 579.5 220.75 L 638.13 220.75" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 643.38 220.75 L 636.38 224.25 L 638.13 220.75 L 636.38 217.25 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 221px; margin-left: 613px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; ">成功</div></div></div></foreignObject></g><path d="M 329.5 220.8 L 349.5 220.8 L 339.5 220.8 L 353.13 220.8" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 358.38 220.8 L 351.38 224.3 L 353.13 220.8 L 351.38 217.3 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><rect x="259.5" y="200.75" width="70" height="40" rx="6" ry="6" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 68px; height: 1px; padding-top: 221px; margin-left: 261px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; ">工具 2<br />/forecast</div></div></div></foreignObject></g></g></svg></div>

## 插件分类 {#8ff3afcf}
扣子编程拥有丰富的插件资源，支持开发资源库插件，并提供官方插件及第三方插件，你可一键添加使用。其中，官方插件及第三方插件均包含免费插件和付费插件。
<!-- @cols-width: 121,100,654 -->
| || | \
|**插件分类** | |**说明** |
|---|---|---|
| || | \
|资源库插件 | |开发者在资源库中自行开发的插件，仅供当前帐号内使用。 |\
| | |资源库插件由开发者自行维护和更新。 |
| | | | \
|插件商店插件 |官方插件 |由扣子编程上架到插件商店的插件，扣子编程会提供全面技术支持和维护，确保稳定性与兼容性。 |\
| | |包括免费插件和付费插件： |\
| | | |\
| | |* 免费插件：无需付费，所有扣子用户均可使用。 |\
| | |* 付费插件：根据插件调用量（次数、时长等）收取一定费用。付费插件列表及收费说明，请参考[插件费用](https://www.volcengine.com/docs/84458/1468047)。 |
|^^| | | \
| |三方插件 |由开发者开发并上架到插件商店的插件，包括免费插件和付费插件： |\
| | | |\
| | |* 免费插件：无需付费，所有扣子用户均可使用。 |\
| | |* 付费插件：仅扣子计费套餐用户可使用三方的付费插件。三方的付费插件会有**三方**、**付费**标识。使用三方的付费插件时，将根据插件调用量（次数、时长等）从使用者的现金账户余额中扣除，不支持积分抵扣。 |

## 费用说明 {#eeb2d8e7}
### **官方插件** {#0a5c811d}
扣子编程根据收费插件的调用量收费，每小时统计插件用量，并通过积分方式抵扣费用。扣子编程官方收费插件列表及收费说明，请参考[插件费用](/coze_pro/plugin_fee)。
:::tip 说明
* 如果某个插件内包含多个工具，则调用这些工具的次数将共同计入该插件的免费额度。
* 在**企业标准版、企业旗舰版**中，超级管理员及其所有成员共享套餐内的插件免费额度。
:::
### 三方插件 {#99575139}
使用三方的付费插件时，将根据插件调用量（次数、时长等）从使用者的现金账户余额中扣除，不支持积分抵扣。三方插件的价格由插件开发者自行设定。相关计费项说明，请参考[插件费用](/coze_pro/plugin_fee)。
## 使用限制 {#90687207}
插件使用限制如下表所示。
<!-- @cols-width: 158,689 -->
| | | \
|**限制项** |**说明** |
|---|---|
| | | \
|插件数量 |* 每个工作空间下最多可创建 1000 个插件。 |\
| |* 每个账号下最多可创建 30 个 IDE 插件。 |
| | | \
|插件工具数量 |每个插件中最多包含 100个工具。 |
| | | \
|QPS |* 官方付费插件 QPS 请参考[插件费用](/coze_pro/plugin_fee)。 |\
| |* 自定义插件的 QPS 最大值为 50。 |
| | | \
|依赖包总大小 |开发插件时，支持添加的依赖包总大小上限为 250 MB。 |
| | | \
|发布渠道 |添加了三方的付费插件的低代码智能体或应用（工作流），不支持发布到飞书多维表格、掘金、豆包及部分公共渠道。 |

## 权限说明 {#eb8f150b}
插件相关的权限说明如下：
<!-- @cols-width: 202,638 -->
| | | \
|**操作** |**说明** |
|---|---|
| | | \
|创建、查看、复制插件 |工作空间内的所有成员均可以创建插件，查看、复制空间内的所有插件。 |
| | | \
|编辑、发布、删除插件 |企业超级管理员、工作空间管理员、工作空间所有者均可以编辑、删除、发布空间内的所有插件。 |

## 操作导航 {#7da63b40}
<!-- @cols-width: 149,686 -->
| | | \
|**操作** |**描述** |
|---|---|
| | | \
|创建自定义插件 |扣子编程提供了多种创建自定义插件的方式供你选择，相关操作步骤可参见以下文档。 |\
| | |\
| |* [基于 API 创建插件](/guides/services) |\
| |* [使用 IDE 创建插件](/guides/ide) |\
| |* [通过 JSON 或 YAML 文件导入插件](/guides/import) |\
| |* [使用代码注册插件](/guides/use_code) |
| | | \
|使用插件 |插件可以直接在智能体内使用，拓展智能体的能力边界。插件也可以作为节点添加到低代码工作流，实现工作流的任务处理能力。详情参见[使用插件](/guides/use_plugin)。 |


