目录
一、前言
在当下各类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平台创建自己的智能体应用，同时在智能体中接入插件增强智能体的功能，事实上，在实际使用中，插件的能力远不止这些，有兴趣的同学可以在此基础上继续深入研究，本篇到此结束，感谢观看。