Coze插件使用

插件介绍

什么是插件？

插件是一个工具集，一个插件内可以包含一个或多个工具（API）。

目前，扣子集成了类型丰富的插件，包括资讯阅读、旅游出行、效率办公、图片理解等 API 及多模态模型。使用这些插件，可以帮助你拓展智能体能力边界。例如，在你的智能体内添加新闻搜索插件，那么你的智能体将拥有搜索新闻资讯的能力。

如果扣子集成的插件不满足你的使用需求，你还可以创建自定义插件来集成需要使用的 API。

插件与工具

扣子支持创建自定义插件。每个插件可添加多个工具，同一个插件内的不同工具必须使用相同的域名。插件中的每个工具都是一个独立的 API。智能体调用插件时，实际上是调用插件中的某个工具，也就是调用某个 API。

例如，一个天气查询的 API Service 可能会包含以下两个 API：

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

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

费用说明

扣子提供免费插件和付费插件供你使用，收费插件列表及收费说明，请参考插件费用。

每个插件每日提供免费试用次数，基础版和专业版的免费试用次数及使用限制不同，具体如下：

• 基础版：每个插件每日赠送 20 次免费试用次数。当天超出免费试用次数后，无法继续使用。
• 专业版：每个付费插件每日赠送 30 次免费试用次数。免费插件无免费试用次数限制但存在相应的 QPS 限制。
• 如果某个插件内包含多个工具，则调用这些工具的次数将共同计入该插件的免费试用次数限额。
• 在扣子专业版中，主账号及其所有子账号共享免费试用次数限额。

使用限制

• 每个工作空间下最多可创建 1000个插件。
• 每个插件中最多包含 100个工具。
• 每个账号下最多可创建 15个 IDE 插件。

权限说明

插件的创建者可以编辑和删除自己创建的插件；团队内的普通成员可以查看或使用空间中的插件；团队所有者和管理员可以编辑和删除团队内其他成员创建的插件。

​

​

基于 API 创建一个插件

背景信息

在扣子中，一个插件可包含多个工具，每个工具用于完成一个指定的动作。在创建插件时，首先需要将这个 API 服务注册为一个插件，然后再将这个服务下的 API 添加到插件中作为工具使用，最后将插件发布上线。

本教程以扣子的查看智能体列表 API 为例，展示如何一步步创建插件。插件创建成功后，可以通过该插件查看指定空间发布到 Agent as API 渠道的智能体列表。以下是这个接口的基本信息。

准备工作

确保你已经获取了访问令牌，并开通了 getPublishedBot 权限，详细信息参考鉴权方式。

步骤一：创建插件

参考以下操作将上述接口创建为一个插件。

1.登录扣子平台。

2.在左侧导航栏中选择工作空间，并在页面顶部空间列表中选择个人空间或团队空间。

• 系统默认创建了一个个人空间，该空间内创建的资源例如智能体、插件、知识库是你的私有资源，其他用户不可见。你也可以创建团队或加入其他团队，团队内的资源可以和其他团队成员共享。更多信息，请参考管理团队。

3.在资源库页面右上角单击+资源，并选择插件。

4.填写插件基础信息。

a.输入插件名称和描述。

b.插件工具创建方式选择基于已有服务创建。

c.插件 URL：输入 API 的服务地址。本教程是https://api.coze.cn。

d.将以下 Header 信息配置到 Header 列表中。

• Authorization：用于验证客户端身份的访问令牌，本教程以个人访问令牌为例，取值：Bearer $Access_Token。
• Content-Type：解释请求正文的方式，固定值：application/json。