夜雨聆风
你有没有这种感觉——辛辛苦苦调教好的Bot，聊起天来头头是道，但一让它干点实事就歇菜？查个天气说"暂时无法访问"，搜个资料回"我做不到"……哦，这不就是个嘴炮王者吗？
别急，这不是Bot的错，是你自己没给它配上趁手的"武器"。今天咱们就来聊聊Coze插件（Plugin）——这东西才是让Bot从"只会动嘴"升级到"手脚麻利"的关键。
一、插件是啥？说白了就是给Bot装外挂
图：插件就像给Bot安装的外挂模块，让Bot具备各种扩展能力
先来点硬核科普，嫌啰嗦的可以直接跳到下一节（但我建议你别跳，因为这段真的很重要）。
插件的本质是啥？
插件就是API的集合，而API是啥？就是你家Bot跟外部世界通信的"对讲机"。没有插件，Bot就是个信息孤岛；有插件，它才能连接搜索引擎、地图服务、数据库、文档处理工具……真正变成一个能干活的数字助手。
Coze平台目前内置了120+预置插件，覆盖了日常开发中你能想到的大部分场景：
必应搜索 —— 实时联网搜资料，不再一本正经胡说八道
图像生成 —— DALL·E、Stable Diffusion，想画啥画啥
文档解析 —— PDF、Word、Excel，丢进去直接提取内容
高德地图 —— 查地点、算路线，一条龙服务
飞书集成 —— 读写飞书文档、表格，发消息不在话下
剪映 —— 视频剪辑自动化，素材处理好直接出片
Excel处理 —— 读写表格、数据分析，小Case
哦？光这些内置插件就够很多人用一辈子了。但别急，真正的重头戏在后面——自定义插件。
二、插件是怎么工作的？先搞懂原理
图：插件工作流程——从用户输入到最终回复的完整链路
知道插件能干啥还不够，你得知道它是怎么工作的。不然配置的时候一脸懵，改提示词的时候更是抓瞎。
插件工作流程（建议背下来）：
用户输入 → LLM理解意图 → 选择合适工具 → 准备API参数 → 执行调用 → 接收结果 → 理解结果 → 生成回复
这个流程里有个关键点——LLM怎么知道该用哪个插件？
答案是：靠提示词引导，靠插件描述判断。
这就是为什么同样是加了个搜索插件，有的Bot能精准回答"帮我查下今天北京的天气"，有的Bot却无动于衷。问题出在两个地方：
插件描述写得不清楚 —— Bot根本不知道这插件能干啥
提示词里没告诉Bot什么时候用 —— 插件加了白加
所以啊，插件配置是个系统工程，不是简单点两下就完事的。
三、3步搞定！给Bot加上必应搜索插件
好了，废话不多说，先来点能立刻用上的。
假设你现在有个Bot，用户问它实时信息它就哑火。来，手把手教你3步加上搜索能力。
1进入Bot编辑页面，找到插件区域
打开你的Bot编辑页面，左侧菜单找到「插件」选项。点击那个大大的「+」按钮，准备添加插件。
2搜索并选择必应搜索插件
在插件搜索框里输入"必应"或"Bing"，找到「必应搜索」插件，点击添加。这插件是Coze官方提供的，预设了合适的描述，基本不用改配置。
3在提示词里告诉Bot什么时候用它
这是最关键的一步！找到提示词编辑区，加入类似这样的话：
当用户询问实时信息、最新新闻、当前价格、天气状况等需要联网查询的内容时，你应该使用「必应搜索」插件获取最新信息。
图1：在Bot编辑页面点击「+」添加插件
就这三步，你的Bot现在能实时联网了。测试一下，问它"今天有啥科技新闻"，看看是不是秒回？
💡 小提示
插件不是越多越好！每增加一个插件，Bot的响应时间会增加200-500ms（因为LLM要多一步决策）。建议一个Bot保持4-5个核心插件足矣，别贪多嚼不烂。
四、从零创建自定义插件——5步搞定API对接
内置插件再强大，也有不够用的时候。比如你要对接公司内部的库存系统、第三方付费API、或者自己写的服务……这时候就得自己造轮子了。
Coze支持三种自定义插件创建方式：
云侧插件 - 基于已有服务（最常用，调用外部API）✅
云侧插件 - 在Coze IDE中创建（自己写Python代码）
端侧插件（本地设备处理，数据不出网）
绝大多数场景下，你只需要第一种方式。下面来实操：
1进入插件开发页面
在Coze工作台左侧找到「插件」，点击「创建插件」按钮。
2填写基本信息
插件名称（30字内）、插件描述（600字内，越详细越好）、选择创建方式「基于已有服务创建」。描述这块千万别敷衍，你写得越清楚，后面Bot调用准确率越高。
3配置插件URL
输入你要对接的API地址。注意！这个URL必须是支持OpenAPI/Swagger规范的HTTP服务。
4设置鉴权方式
根据你的API类型选择合适的鉴权方式：
无鉴权 —— 公开接口，谁都能调
Bearer Token —— OAuth常用，放在Header里
API Key (Header) —— 放在请求头里
API Key (Query) —— 拼接在URL参数里
Basic Auth —— 用户名+密码形式
5导入或配置API接口
如果你的API是标准的OpenAPI规范（支持JSON或YAML格式的规范文件），直接点击「导入」，Coze会自动解析所有接口。
如果没有标准规范，也可以手动一个个添加接口——定义接口名称、方法（GET/POST）、路径、参数。
图2：新建插件页面，填写API信息和鉴权方式
搞定之后，你的自定义插件就创建好了。接下来跟添加内置插件一样，在Bot里引用它，然后在提示词里说明什么时候用它。
⚠️ 注意：插件描述的精准度直接决定Bot能否正确调用。模糊的描述=插件形同虚设。参数描述也要详细，Bot需要知道每个参数是什么意思、什么格式、必填还是可选。
五、插件嵌入工作流——高级玩法
如果你觉得单独用插件太简单，那就把插件嵌进工作流里，跟其他节点配合使用。这才是Coze的真正强大之处。
举个例子：用户说"帮我查下腾讯今天的股价"，工作流可以这样设计：
输入节点 —— 接收用户查询
意图识别节点 —— 判断是查股票
插件节点 —— 调用股票API获取数据
大模型节点 —— 整理数据，生成自然语言回复
输出节点 —— 返回给用户
图3：在工作流中添加插件节点，配置输入参数引用前面节点的输出
工作流里用插件有个好处——参数传递是自动的！你只需要在插件节点配置「输入参数映射」，把前一个节点的输出字段拖过来就行。
六、实战案例：这些插件配置方案可以直接抄
图：实战案例配置界面——股票查询、库存管理、图像处理等多种场景
光说不练假把式，给你几个拿来就能用的方案：
案例1：股票价格查询Bot
用到的插件：51CTO股票API + 必应搜索
提示词关键句：
当你需要查询某只股票的价格、涨跌幅、市值等实时数据时，必须使用「股票查询」插件。当你需要查询股票的实时新闻或公告时，应使用「必应搜索」插件。
案例2：企业内部库存查询Bot
用到的插件：亚蓝智能体API（自定义，需对接内部ERP系统）
提示词关键句：
当员工询问某产品的库存数量、在途数量或预计到货时间时，使用「库存查询」插件连接公司ERP系统获取实时数据。回复时注明数据更新时间。
案例3：智能图像处理Bot
用到的插件：CSDN图像编辑API + 图像生成插件
提示词关键句：
当用户要求对图片进行风格转换、尺寸调整、格式转换等操作时，使用「图像编辑」插件。当用户要求生成全新图片时，使用「图像生成」插件。
写在最后
图：插件是Bot连接现实世界的桥梁，选对、写清、教会用
好，说了这么多，来个总结吧：
插件配置的三个核心要点：
1️⃣ 选对插件 —— 不是越多越好，4-5个核心插件足够
2️⃣ 写清描述 —— 插件描述和参数描述决定Bot能否正确调用
3️⃣ 教Bot用 —— 提示词里明确告诉它什么时候、什么场景下调用插件
记住，插件是Bot连接现实世界的桥梁。你把桥修得多宽多稳，Bot就能走多远走多稳。
好了，今天的分享就到这里。如果你配置插件的时候遇到啥问题，欢迎评论区留言，看到了都会回。
哦对了，如果你觉得这篇文章有用，转发给你身边也在玩Coze的朋友，大家一起卷起来~
关注我，获取更多Coze开发技巧
