夜雨聆风学习资料网

ARTICLE · 1294344

Agent-插件(工具)介绍

Agent-插件(工具)介绍

https://docs.coze.cn/guides_plugin

什么是插件?

插件是一个工具集,一个插件内可以包含一个或多个工具(API)。

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

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

插件与工具

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

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

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

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

插件分类

扣子编程拥有丰富的插件资源,支持开发资源库插件,并提供官方插件及第三方插件,你可一键添加使用。其中,官方插件及第三方插件均包含免费插件和付费插件。

插件分类说明

资源库插件

开发者在资源库中自行开发的插件,仅供当前账号内使用。

资源库插件由开发者自行维护和更新。

插件商店插件

官方插件

由扣子编程上架到插件商店的插件,扣子编程会提供全面技术支持和维护,确保稳定性与兼容性。

包括免费插件和付费插件:

  • 免费插件:无需付费,所有扣子用户均可使用。
  • 付费插件:根据插件调用量(次数、时长等)收取一定费用。付费插件列表及收费说明,请参考插件费用。

三方插件

由开发者开发并上架到插件商店的插件,包括免费插件和付费插件:

  • 免费插件:无需付费,所有扣子用户均可使用。
  • 付费插件:仅扣子计费套餐用户可使用三方的付费插件。三方的付费插件会有三方、付费标识。使用三方的付费插件时,将根据插件调用量(次数、时长等)从使用者的现金账户余额中扣除,不支持积分抵扣。

费用说明

官方插件

扣子编程根据收费插件的调用量收费,每小时统计插件用量,并通过积分方式抵扣费用。扣子编程官方收费插件列表及收费说明,请参考插件费用。

说明

  • 如果某个插件内包含多个工具,则调用这些工具的次数将共同计入该插件的免费额度。
  • 在企业标准版、企业旗舰版中,超级管理员及其所有成员共享套餐内的插件免费额度。

三方插件

使用三方的付费插件时,将根据插件调用量(次数、时长等)从使用者的现金账户余额中扣除,不支持积分抵扣。三方插件的价格由插件开发者自行设定。相关计费项说明,请参考插件费用。

使用限制

插件使用限制如下表所示。

限制项说明

插件数量

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

QPS

  • 官方付费插件 QPS 请参考插件费用。
  • 自定义插件的 QPS 最大值为 50。
依赖包总大小
开发插件时,支持添加的依赖包总大小上限为 250 MB。
发布渠道
添加了三方的付费插件的低代码智能体或应用(工作流),不支持发布到飞书多维表格、掘金、豆包及部分公共渠道。

权限说明

插件相关的权限说明如下:

操作说明
创建、查看、复制插件
工作空间内的所有成员均可以创建插件,查看、复制空间内的所有插件。
编辑、发布、删除插件
企业超级管理员、工作空间管理员、工作空间所有者均可以编辑、删除、发布空间内的所有插件。

操作导航

操作描述

创建自定义插件

扣子编程提供了多种创建自定义插件的方式供你选择,相关操作步骤可参见以下文档。

  • 基于 API 创建插件
  • 使用 IDE 创建插件
  • 通过 JSON 或 YAML 文件导入插件
  • 使用代码注册插件
使用插件
插件可以直接在智能体内使用,拓展智能体的能力边界。插件也可以作为节点添加到低代码工作流,实现工作流的任务处理能力。详情参见使用插件。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料