｜不写代码 ｜ 按需定制 ｜ 让机器人拥有无限能力
不知不觉，这个专栏已经陪你走过了五篇文章。你已经学会了：
— ✅ 从零创建第一个AI智能体（天气查询）
— ✅ 用工作流编排机器人，告别“大模型不听话”
— ✅ 用知识库让机器人记住你的产品，7x24小时应答
— ✅ 用卡片让机器人回复像财经APP一样精致
但你有没有想过一个问题：如果插件商店里没有你想要的插件，怎么办？
比如，你想让机器人自动查询你公司内部的客户CRM系统数据，或者每天定时给你推送某个特定网站的行情信息。插件商店里有现成的吗？大概率没有。
好消息是：Coze支持你自己创建插件。
今天这篇文章，我就带你从零创建三种类型的插件，无论你会不会写代码，都能找到适合自己的方案。
📌 本篇你将学到什么？
— ✅ 什么是插件？为什么它是机器人的“万能工具箱”？
— ✅ 零代码法：用免费API创建“无授权插件”（无需写代码）
— ✅ 进阶法：用“Service认证”创建需要Token的插件
— ✅ 高阶法：用Coze IDE创建可托管运行的代码插件
— ✅ 插件发布与集成：让智能体学会调用你创建的插件
一、插件是什么？为什么它是机器人的“万能工具箱”？
想一下，你之前做的天气机器人，它能查天气，靠的是什么？是一个叫“天气插件”的东西。你添加它后，大模型就知道：用户问天气时，我该调用这个插件去获取实时数据。
插件 ≈ 机器人的“能力扩展器”。
Coze的插件本质上是一个或多个函数的集合（即工具集），每新增一个插件，就相当于给自己的机器人新增了一个“远程技能”。
二、插件的两种创建方式（先知道，后动手）
在Coze中创建插件的入口：左侧“工作空间” → “插件” → “创建插件”。
创建时，有两种核心方式：
创建方式 | 适用人群 | 核心逻辑 |
基于已有服务创建 | 零代码基础 | 只需填写现成API的URL和参数，纯配置 |
在Coze IDE中创建 | 需要编写代码 | 代码托管在Coze云端，无需自备服务器 |
今天我帮你把三种经典的插件场景全部拆解，总能找到最适合你的一种。
三、场景一：零代码法——用免费API创建一个“无授权插件”
如果插件商店没有适合的插件，我们可以通过免费API（应用程序编程接口）快速创建！“无授权插件”顾名思义，指的就是调用时不需要OAuth、Secret、Token等任何认证流程的插件。这种方式：简单快速，不需要写代码。
第一步：找到目标API
这里拿阿里云提供的“随机获取名言”免费接口演示：
- URL：`https://api.anosci.com/qod`
- 请求方法：GET
- 返回示例：
```json
{
"quote": "这不是一句普通的话。",
"author": "虚构的作者名"
}
```
第二步：创建插件
1. 进入“插件”页面，点击“创建插件”。
2. 名称：`名言助手`，描述：`随机返回一句名人名言`。
3. 创建方式：选择 “基于已有服务创建” 。
4. 插件URL：填写 `https://api.anosci.com`（注意：根目录最后不要加斜线）。
5. 授权方式：选择 “不需要授权” 。
第三步：在插件中创建工具
1. 插件创建成功后，点击“创建工具”。
2. 工具名称：`get_quote`，描述：`获取一句随机名言`。
3. 工具路径：`/qod`（必须斜线开头），请求方法：GET。
4. 配置输入参数：此接口没有必填参数，直接点“下一步”。
5. 输出参数：点击 “自动解析”。Coze会调用一次API，侦测出返回JSON中`quote`和`author`两个字段。
6. 测试：输入参数为空，点击“运行”。如果右下角 `运行 成功` ，说明接口成功调用！
第四步：发布插件
插件测试通过后，右上角【发布】插件。
最后，把插件用到机器人身上：
1. 在智能体左侧“技能”模块 → “插件” → 添加你刚发布的“名言助手”插件。
2. 修改人设与回复逻辑：“每当你不知道说什么时，可以调用名言插件来安慰用户。”
3. 测试输入“来一句名言吧”！
这种适合个人开发者、文案类机器人，一天内可快速搞定。
四、场景二：进阶法——用需要Token的API创建“授权插件”
很多有价值的API，比如企业内部的CRM系统、天气付费接口等，调用时需要携带Token或API Key进行身份验证。
我们拿免费测试接口做演示，目标是让它生成摘要。所需接口可从各大API集合库里查找获取。
第一步：获取API的Token/API Key
大部分服务平台注册后可在控制台生成Token。为了练习，我们随便找一个要求提供KEY的服务，比如“百度智能云的图像识别”。
第二步：创建插件，配置授权
1. 进入“插件”页面，点击“创建插件”。
2. 名称：`文本分析`。
3. 插件URL：填写你拿到的Base URL。
4. 关键点：授权方式选择 “Service”。
5. Header列表：参数名填Token或X-API-Key，值从控制台粘贴你获取的真实Key。
6. 点击“确认”。
第三步：创建工具并配置参数（POST方法）
假设接口路径是 `/summary`，请求方法选择POST。
接口需要三个Body必填参数：text（待分析文本）、max_length（字数）、language（语言）。
配置好这些输入参数，传递方式全部选`body`。
第四步：自动解析输出
点击“自动解析”。成功后会得到输出参数（如`summary`字符串）。
第五步：测试与发布
输入测试文本，运行测试，看到摘要返回即为成功。
这种适合企业内部答疑、付费天气插件、数据查询机器人等。
五、场景三：高阶法——用Coze IDE创建代码插件
万一外部没有现成API怎么办？又或者，AI的Token数不够想自己写脚本来调用？这时候用Coze IDE就对了。
Coze IDE是扣子提供的在线编码和运行环境，无需关心服务器环境，代码测试完，Coze自动帮你托管运行。你需要了解最基础的Python或Node.js语法。
推荐Python3，因为Coze嵌入AI助手，可以辅助你写代码。
第一步：创建插件并选择IDE模式
1. 点击创建插件。
2. 名称：`数据分析`，描述`调用API处理大量文本数据`。
3. 关键点：创建方式 → 选择 “在Coze IDE中创建”，运行时选择 `Python3`。
第二步：填写代码
IDE默认提供handler函数。假设我们需要一个延迟提醒功能，必须计算用户输入的秒数（实际代码待编写，建议用户自行实现，大约10-20行）。
第三步：安装依赖包
如果代码中用了类似`requests`模块，回到左侧依赖包区域，点击+号搜索`requests`安装，能保证代码正常运行。
第四步：定义“元数据”
在“元数据”选项卡定义输入参数和输出参数，名称必须完全对应代码中的参数。
第五步：测试
模拟输入18，点运行，控制台输出日志，提示“等待18秒”。
第六步：发布与集成
测试通过的插件，点击发布，然后在机器人编辑页面点击“添加插件”，选择你刚发布的新插件。
这种适合处理复杂算法、加密/解密、数据清洗、批量文本分析等自定义需求。
六、避坑指南：这些错误你一定会碰到
常见问题 | 原因 | 解决方法 |
工具调试失败（404） | 插件根目录URL末尾加了斜线，工具路径也加了斜线 | URL不要以/结尾 |
自动解析报错“参数格式错误” | 接口返回的不是标准JSON | 检查API是否正常返回JSON |
Service认证总失败 | Token过期或者选成了query传递 | 确认Token有效且在Header体里传递 |
机器人调用插件失败 | Prompt没说清楚何时调用此插件 | 修改机器人提示词：“当用户要求整理数据时，调用该工具” |
IDE代码运行失败 | 没引入依赖或参数名不一致 | 依赖包必须安装，元数据参数名必须和代码变量名一致 |
关于“如何在机器人中使用插件”，最核心的技巧是修改`人设与回复逻辑`，明确告诉大模型，什么情况下需要调用该插件。
七、尾声：当你拥有了自己的插件……
掌握了创建插件的能力，你就跨出了“只搭建静态机器人”的核心一步——让机器人拥有真正的工程落地能力。
从此，你可以：
— 把内部Excel表格数据API化，让Coze帮你查公司销售数据
— 写Python脚本封装任意复杂的网络爬虫逻辑
— 对接付费API代理，商业化你的智能体
在我编写的电子书《Coze从零到一》中，我详细对比了“无授权插件”“授权插件”“IDE代码插件”在不同业务场景下的选择策略，以及如何打包成独立工具并上架赚钱。
附：秒哒筑梦计划——你的下一站创收路径
插件创作不只是完成工作。百度秒哒已启动“筑梦计划”，平台准备扶持20万开发者实现商业营收，帮助优质开发者年增收超过5000万元。
入门级别只需在应用广场发布10个可用作品，即可申请1万到10万元不等的筑梦基金扶持，进入百万融资直通车候选池。
如果你在Coze插件上有高价值作品，也可以尝试推广到秒哒生态开展二次创收。
📢 下篇预告：数据库节点——让机器人拥有跨会话的长久记忆
机器人总忘记上次聊到哪？下篇“数据库节点”让机器人拥有跨对话永久的记忆机制，并教你构建一个完整的记账AI助手。记得点关注！
