第六章 插件让 Bot 长出手脚

一、什么是插件

简单说：

插件 = 一个让 Bot 能调用"外部世界 API" 的工具。

举几个真实例子，你立刻就懂：

核心区分：知识库是"已经塞给 Bot 的资料"，插件是"Bot 现场去外面取的能力"。

二、Coze 的 600+ 插件市场

打开 Coze → 左侧「资源库」→「插件」→「插件商店」，你会看到一个琳琅满目的市场。

按官方分类，大致分这 12 类：

国际版（coze.com）还有 GPT-4V、DALL·E、剪映等"高阶选手"。

三、普通人必装的 12 个插件

下面 12 个是我亲测过、几乎所有人都用得上的"传家宝"。挑你需要的装，别贪多。

1. 必应搜索（Bing Web Search）

用途：实时搜索网页，让 Bot 不再"信息过时"。 典型场景：写新闻摘要、追热点、查资料。 怎么用：搜索关键词 "Bing"，找官方插件，点 "添加"。

2. 头条搜索

用途：补充国内信息源，特别是头条系内容（抖音、今日头条、西瓜视频）。 典型场景：做小红书 / 抖音内容时找素材。

3. 豆包文生图（doubao-image）

用途：生成图片，无需懂 Stable Diffusion 参数。 典型场景：海报、封面、表情包、PPT 配图。 示例提示词：

请调用文生图插件，生成一张：
- 风格：扁平插画
- 主题：一只柴犬在咖啡馆码字
- 比例：16:9
- 配色：温暖橙色调

4. PDF 解析

用途：把 PDF 转成可读文本，Bot 才能处理。 典型场景：合同审查、论文摘要、产品手册问答。

5. OCR 图片文字识别

用途：把图片里的文字提取出来。 典型场景：截图问问题、纸质票据扫描、手写笔记数字化。

6. 链接读取（Link Reader）

用途：用户发个网页 URL，Bot 能"打开看看"。 典型场景：公众号文章总结、新闻摘要。

7. 天气查询

用途：返回任意城市的实时 / 预报天气。 典型场景：旅行规划、运动建议、给爸妈做的"今天穿啥"。

8. 头条热榜 / 知乎热榜

用途：拉今日热榜，用于内容创作。 典型场景：自媒体选题、热点追踪。

9. 数据可视化（chart-render）

用途：根据数据生成图表（柱状图、折线图、饼图）。 典型场景：周报、月报、数据分析。

10. 字节翻译

用途：高质量翻译。 典型场景：英文文档翻译、跨境电商。

11. 时间日期工具

用途：返回当前时间、计算日期差、转换时区。 典型场景：定时任务、日历类 Bot、时区换算。

12. Excel 读写

用途：让 Bot 直接读写 Excel 文件。 典型场景：批处理表格、自动化报表。

怎么知道一个插件好不好用？ 看它的"使用次数"和"评分"。装之前先看一眼，2000+ 用户用过、4 星以上的，基本不会踩坑。

四、5 分钟实战：给"小红书爆款标题生成器"装上插件

接着 第二章 的 Bot，我们升级它——让它先去看小红书今天的热门话题，再生成更"应季"的标题。

第 1 步：找插件

1. 进入你的"小红书爆款标题生成器" Bot 编辑页。
2. 在「技能」面板里找到「插件」→ 点「+ 添加」。
3. 搜索关键词："小红书"。
4. 找到一个叫「小红书爆款选题」或「小红书热搜」的插件（具体名字以你看到为准），看一下评分和使用人数，挑高的。
5. 点「+ 添加」。

第 2 步：改提示词

在原来的提示词最前面加一段：

# 工具调用规则
1. 当用户给你一个主题时，第一步必须调用「小红书爆款选题」插件，输入用户的主题，获取近 7 天 Top 10 热门相关帖子的标题和数据。
2. 第二步：分析这些热门标题的共性（高频词、句式、情绪点）。
3. 第三步：基于第一步的真实数据 + 第二步的共性，生成 10 个高潜力标题。

# 关键约束
- 必须先调用插件再生成，不允许"直接生成"。
- 如果插件返回失败，再回到"凭经验生成"模式，并在输出最后加一句"⚠️ 本次未调用最新数据"。

第 3 步：测试

在调试窗口输入"上海老破小装修"。

如果配置正确，你会看到：

1. Bot 会"思考一下"（屏幕上有"正在调用插件 ..."提示）。
2. 几秒后返回 10 个标题，里面会有当下流行的真实词汇（比如"5 万改造"、"建国前装修"等只在最近热门帖子里高频出现的词）。

恭喜，你的 Bot 真的"上网了"。

五、Coze 插件的 4 种调用方式

新手遇到的最大困惑："插件什么时候被自动调，什么时候不调？"

答案：取决于你的 Bot 配置成 4 种调用方式中的哪一种。

方式 1：模型自由判断（默认）

Bot 直接把插件挂在"技能"里，模型根据用户提问自己决定要不要调。

• ✅ 优点：灵活、自然。
• ❌ 缺点：模型偶尔"偷懒"，明明该调却不调。
• 🛠️ 解决：在提示词里强约束（见上面的"工具调用规则"）。

方式 2：用工作流强制调

把插件放进一个"工作流"节点里，每次必调。

• ✅ 优点：100% 调用，绝不偷懒。
• ❌ 缺点：流程固定，灵活度低。
• 适合：客服、报告等"流程性"场景。

方式 3：通过快捷指令触发

在 Bot 编辑页"快捷指令"里挂一个按钮，按钮点一下就触发某个插件。

• ✅ 优点：用户操作直观。
• 适合：高频固定操作（"查天气"、"生成海报"）。

方式 4：通过卡片触发

在多 Agent 场景里，可以让 Bot 给用户发一张"卡片"，卡片上的按钮点一下触发插件。

• ✅ 优点：交互最丰富。
• 适合：电商、客服等结构化场景。

新手只用方式 1 + 方式 2 即可。后两种 第八章 会详细讲。

六、付费插件——3 条钱包保护原则

Coze 平台上绝大多数插件免费，但有些第三方插件（特别是企业服务类）按调用次数收费。

原则 1：装之前看清"价格标签"

每个插件页面都会显示：

• 是否收费。
• 计价单位（按次 / 按月 / 按字数）。
• 单价。

没看清就装的，吃亏的是自己。

原则 2：免费替代优先

90% 的需求都有免费替代：

• 想搜索？Bing / 头条免费。
• 想生图？豆包文生图免费额度大方。
• 想翻译？字节翻译免费。
• 想 OCR？官方 OCR 免费。

只有"必须用第三方专业能力"时（如企查查、天眼查的工商数据），才掏钱。

原则 3：设消费上限

Coze 后台的「账户设置」→「消费提醒」里设一个月度上限（比如 100 元）。一旦达标就停。

新手忠告：第一个月只用免费插件，把流程跑通。第二个月再考虑要不要上付费。

七、自定义插件——5 分钟把任意 API 接进来

如果商店里没有你要的插件，自己造一个比想象中简单。

适合的场景

• 你公司自己的 API（订单系统、CRM）。
• 你订了某个 SaaS（飞书 API、钉钉 API）。
• 第三方公开 API（GitHub API、知乎 API、新浪股票 API）。

5 分钟流程

1. 左侧「资源库」→「插件」→「+ 创建插件」。
2. 「插件类型」选 「云侧插件」→「基于已有服务」。
3. 填基础信息：
   • 插件名称：例如 查询订单状态
   • 描述：例如 根据订单号查询最新物流信息
   • 插件 URL：你的 API 服务地址前缀
   • 鉴权方式：无 / API Key / OAuth（按你的 API 选）
4. 「创建工具」：
   • 工具名：getOrderStatus
   • 工具描述：输入订单号，返回订单状态、物流单号、预计送达时间
   • 输入参数（Input Schema）：定义参数名、类型、是否必填。
   • 输出参数（Output Schema）：定义返回字段。
   • 请求方式：GET / POST。
5. 测试 → 发布。

关键提醒：写好"工具描述"

模型要靠"工具描述"来判断"什么时候该调用这个工具"。

❌ 不好的描述："查询订单"

✅ 好的描述："当用户询问订单状态、物流位置、是否发货、预计送达时间时调用本工具。输入参数为订单号（字符串）。"

好描述 = 模型不会调错也不会漏调。

八、插件调用失败的 5 种常见原因

原因 1：模型没识别出该调用

症状：Bot 直接凭脑补回答，没调插件。 解决：在提示词里强约束，写明"什么场景必须调用什么插件"。

原因 2：插件参数错误

症状：调用了，但报"参数缺失"或"参数类型错误"。 解决：在工作流的"插件节点"里，手动配置参数映射，别让模型自己猜。

原因 3：插件被限流

症状：偶尔成功偶尔失败。 解决：换个时段测试；或者升级到付费版（如果是付费插件）。

原因 4：插件已下架 / 失效

症状：所有调用都失败。 解决：去插件商店看一下原插件，可能已被官方下架，找替代品。

原因 5：网络 / 鉴权问题（自定义插件）

症状：调用直接报错。 解决：用 Postman 单独测试一次 API；检查 API Key 是否过期。

九、本章一图回顾

插件 = 让 Bot 能调用外部 API 的"手脚"

12 个必装：
   搜索     Bing / 头条
   图像     豆包文生图
   文档     PDF 解析 / OCR
   网页     Link Reader
   生活     天气 / 时间日期
   热点     头条 / 知乎热榜
   数据     chart-render
   翻译     字节翻译
   表格     Excel 读写

4 种调用方式：
   模型自由判断（默认，要靠提示词约束）
   工作流强制调（100% 调用）
   快捷指令触发（按钮触发）
   卡片触发（多 Agent 用）

付费插件 3 原则：
   看清价格 / 免费替代优先 / 设月度上限

自定义插件 5 分钟：
   API 地址 → 鉴权 → Input Schema → 写好"工具描述" → 发布

十、避坑清单

• ❌ 别一次装 30 个插件。装太多模型会"选择困难"，反而调不准。一个 Bot 控制在 5-10 个插件以内。
• ❌ 别忘了在提示词里强约束"什么时候调用什么插件"。
• ❌ 别盲目装付费插件。先确认免费替代不够用再说。
• ❌ 别忘了检查"调用结果"。Coze 调试窗口有"调用日志"，能看到每次调用是否成功、传了什么参数、返回了什么。
• ❌ 自定义插件的 "工具描述"必须详细，否则模型不会调。

十一、本章实战附赠：3 个"插件 + 提示词"的组合拳

组合 1：实时新闻摘要 Bot

插件：Bing 搜索 + Link Reader + 头条搜索

提示词关键段：
"当用户问任意话题，先调用 Bing 搜索拉 5 个最新结果（按时间排序），
然后用 Link Reader 读取前 3 个链接的正文，最后总结成 200 字摘要 + 5 个关键事实。"

组合 2：海报一键生成 Bot

插件：豆包文生图 + OCR

提示词关键段：
"用户给一段文案，先生成 3 张备选海报（不同风格），
然后让用户选 1 张，最后调用 OCR 检查文字是否清晰，
如果不清晰就重生成。"

组合 3：周报自动生成 Bot

插件：Excel 读写 + chart-render

提示词关键段：
"用户上传本周数据 Excel，
读取数据 → 调用 chart-render 出 3 个图（趋势 / 占比 / 对比）→
按"成绩 - 问题 - 下周计划"三段式生成 600 字周报。"

这 3 个组合在 附录 B 30 个开箱即用 Bot 模板 里有完整提示词。

十二、下一步

提示词、知识库、插件——你已经掌握了 Coze 的 3 大武器。但单纯让 Bot "聊天"已经不够了，复杂任务需要"按步骤跑"。这就是工作流的舞台。

请翻 第七章 工作流从对话到自动化。