目录

一、前言

二、Coze 插件介绍

2.1 什么是插件

2.1.1 插件主要功能

2.1.2 coze 插件常用类型

2.1.3 coze 插件优势

2.2 插件与工具

2.3 插件费用说明

2.4 使用限制

2.5 权限说明

2.6 coze添加插件入口

三、Coze插件创建与使用

3.1 前置准备

3.1.1 查看api列表

3.1.2 获取token

3.2 创建插件操作过程

3.2.1 创建插件

3.2.2 创建工具

3.2.3 发布插件

3.3 使用插件

3.3.1 添加自定义插件

3.3.2 修改提示词

3.3.3 发布智能体并测试效果

四、写在文末

---

一、前言

在当下各类AI大模型应用异常火爆的今天，AI智能体的诞生，让大模型的能力得到充分的发挥，AI智能体作为一个AI综合性工具，不仅可以调动起AI大模型能力，也可以集成更多的第三方应用能力，从而完成更多复杂的业务场景，为实际业务拓展业务价值，在AI智能体中，插件就是这种拓展AI能力的很重要的工具，本文以Coze为例，详细介绍下插件工具的详细使用。

二、Coze 插件介绍

2.1 什么是插件

插件是一个工具集，一个插件可以包含一个或多个工具（API）。目前，coze 集成了类型丰富得插件，包括资讯阅读，旅游出行，效率办公，图片理解等API以及多模态模型，使用这些插件，可以帮助使用者拓宽智能体能力边界。比如，在你的智能体内添加新闻插件，那么你的智能体将拥有搜索新闻咨询的能力。官方文档：扣子

如果coze集成的插件还不能满足你的使用需求，你还可以创建自定义插件来集成需要使用的API。在coze主页的插件商店菜单下，内置了很多种插件可供用户使用。

2.1.1 插件主要功能

coze插件主要具备如下功能：

• 增强 Bot 能力
  • 插件可以让 Bot 突破基础对话限制，执行如 实时信息查询、计算、翻译、内容生成 等任务。
  • 例如：天气查询、股票数据、航班信息、专业翻译等。
• 支持多种交互方式
  • API 调用：对接外部服务（如天气 API、数据库等）。
  • 文件处理：支持上传 PDF、Excel、Word 等文件，并提取关键信息。
  • 自定义逻辑：通过代码（如 Python、JavaScript）实现复杂功能。
• 无需复杂开发
  • Coze 提供可视化界面，用户可以通过简单配置快速创建插件，无需深入编程。

2.1.2 coze 插件常用类型

coze的插件主要包括如下类型

• API 插件
  • 调用外部 API 获取实时数据（如天气、新闻、股票等）。
• 知识库插件
  • 基于上传的文档（PDF/TXT/Excel）提供专业问答（如法律、医疗等）。
• 工具插件
  • 提供计算、翻译、代码执行等功能（如 Wolfram Alpha、Python 脚本执行）。
• 多模态插件
  • 处理图片、音频等非文本数据（如 OCR 识别、语音转文字）。

2.1.3 coze 插件优势

coze插件具有如下优势

• 低代码开发：无需复杂编程即可扩展 Bot 能力。
• 灵活集成：支持 REST API、数据库、云服务等。
• 多场景适用：客服、教育、数据分析等领域均可使用。

2.2 插件与工具

coze还支持创建自定义插件，每个插件可以添加多个工具，同一个插件内的不同工具必须使用相同的域名，插件中的每个工具都是一个独立的API。智能体在调用插件的时候，实际上是调用插件中的某个工具，也就是调用某个具体的API能力。比如，一个用于查询天气的API Service可能包含以下两个API：

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

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

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

2.3 插件费用说明

coze提供了免费插件和付费插件两种类型。每个插件来说，都会有一定的免费使用次数，基础版和专业版免费使用次数以及限制不相同，具体来说：

• 基础版：每个插件每日赠送20次免费使用次数，当天超出使用次数后，将无法继续使用。

• 专业版：每个付费插件每日赠送30次免费使用次数，免费插件无免费使用次数限制，但是存在相应的QPS限制。

• 如果某个插件内包含多个工具，则调用这些工具的次数将共同计入该插件的免费使用次数限额。

• coze专业版中，主账号以及所有子账号共享免费试用次数限制。

2.4 使用限制

在使用过程中，下面一些限制需要注意，避免

• 每个工作空间下最多可创建1000个插件；

• 每个插件中最多包含100个工具；

• 每个账号下最多可创建15个IDE工具；

2.5 权限说明

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

2.6 coze添加插件入口

在coze中，你可以通过不同的方式添加插件

1）智能体编辑页面添加插件

比如在之前自己创建的一个智能体编辑页面，点击中间的添加插件

在弹出的下面的插件添加框中，可以根据你自己的需要，为你的智能体添加相应的插件，在左侧，还可以进行搜索

如果系统提供的插件还不能满足你的要求时，还可以自己创建一个插件，点击左侧的创建插件，跳转到下面的自定义创建插件页面，在这里你可以自己创建一个插件给智能体使用。

2）工作空间添加插件

进入工作空间

在右侧选择插件，在下面弹出的新建插件框中，按要求填写对应的信息，即可完成一个自定义插件的创建。

三、Coze插件创建与使用

3.1 前置准备

在后面插件使用过程中，在集成工具的时候需要使用到鉴权，需要提前准备好相关的必要参数，比如当我们在自己的插件中，需要调用coze官方的api时，需要按照coze的鉴权方式才能正常调用。

3.1.1 查看api列表

在左侧菜单栏中有个扣子 API，在这个页面，展示了coze官方提供的很多不同功能的API列表可供用户选择使用，可以在插件中根据自己的需要选择添加或集成。

比如，我们点击其中一个查看智能体列表的API进去查看，在这里展示了详细的有关这个API调用的说明

在这个页面的必要参数中，token是一个非常重要的请求参数，有过与三方平台对接经验的伙伴对这个应该不陌生，所以，接下来一个非常重要的事情，那就是获取请求API的token参数。

发起API调用，将上一步拿到的token + 智能体所在的space ID填进去，然后点击右侧的运行，可以看到响应结果中就拿到了个人空间下的两个智能体信息。

3.1.2 获取token

点击鉴权方式

跳转到下面的页面，继续点击添加个人访问令牌

跳转到下面的页面之后

通过图中的两种方式都可以获取到令牌，比如我这里选择个人访问令牌页面，点击之后来到下面的页面

点击添加新令牌，勾选里面的选项即可

添加成功后，在列表上就能看到这个令牌信息了

3.2 创建插件操作过程

3.2.1 创建插件

在我的空间下面创建一个插件

创建完成后，可以在列表上看到这个插件基本信息

• 可以将插件简单理解为一个包含了很多工具集的分组名

3.2.2 创建工具

点击列表中的某个插件名称，进入到这个插件页面，在这里你可以定义具体的工具，比如集成你自己编写的API接口等

点击创建工具，在下面的页面，填写获取个人空间列表信息这个API接口的参数详细信息

• 具体的参数信息，可以在这个API详情里面进行查看

将接口中的参数配置到工具中

表单页面配置完成后，点击保存，然后点击右上侧的试运行

确保试运行调试通过之后

配置完成之后，可以在我的插件列表中看到上面创建的这个工具

3.2.3 发布插件

点击右上侧的发布

3.3 使用插件

3.3.1 添加自定义插件

在上一步定义完成插件后，在接下来自己创建的智能体中就可以使用了，以之前创建的一个智能体为例进行说明，在添加插件的地方，资源库工具中就能看到上面这个自定义插件了

添加完成后，在列表中就能看见这个插件了

3.3.2 修改提示词

为了让智能体能够用上这个自定义插件，简单调整一下提示词，如下

3.3.3 发布智能体并测试效果

此时我们在右侧的对话框中，输入问题：我的空间信息 ，此时可以看到助手就调用了个人的自定义插件进行了回答

四、写在文末

本文通过实际案例操作演示了如何在Coze平台创建自己的智能体应用，同时在智能体中接入插件增强智能体的功能，事实上，在实际使用中，插件的能力远不止这些，有兴趣的同学可以在此基础上继续深入研究，本篇到此结束，感谢观看。