插件使用
掌握 Coze 内置插件和自定义插件开发，让智能体能力翻倍
Coze 内置插件介绍
Coze 提供了多个内置插件，让你的智能体拥有搜索、计算、代码执行、图片生成等超能力。开箱即用，无需开发。
让智能体能够搜索互联网获取最新信息。这是最常用的内置插件，适合需要实时信息的场景。
能力
搜索互联网上的最新信息
获取特定网页的内容
搜索新闻、文章、论坛等
适用场景
回答时事新闻相关的问题
查找最新的产品信息、价格
获取特定领域的最新研究和文章
事实验证（辅助判断信息真假）
Prompt 配置建议
在 Prompt 中说明什么情况下使用搜索
告诉 AI 搜索后要整理信息再回答，而不是直接粘贴
限制搜索频率，避免每个问题都搜索
Prompt 示例
当用户问到以下类型问题时，使用搜索插件获取最新信息： 1. 时事新闻、最新事件 2. 需要实时数据的问题（价格、股票等） 3. 你不确定的事实性问题 搜索后： - 整合多个搜索结果 - 用自己的话概括，不要直接复制 - 标注信息来源
让智能体能够执行 Python 代码。适合需要计算、数据处理、文件操作的场景。
能力
执行 Python 代码（支持主流库）
处理上传的文件（CSV、Excel、JSON 等）
生成图表和可视化
进行数学计算和数据分析
适用场景
数据分析和报表生成
数学/统计计算
CSV/Excel 文件处理
简单的自动化脚本
Prompt 配置建议
明确告诉 AI 什么时候该用代码而不是直接回答
指定代码执行后要解读结果，不要只输出代码
对于计算类问题，要求 AI 先估算再用代码验证
Prompt 示例
遇到以下情况时，使用代码执行插件： 1. 需要精确数学计算（超过简单四则运算） 2. 用户上传了数据文件需要处理 3. 需要生成图表或可视化 代码执行规则： - 代码要有注释 - 执行完后用通俗语言解释结果 - 如果代码报错，分析原因并修复重试
让智能体能够生成图片。通常调用 DALL-E 或其他图片生成模型。
能力
根据文字描述生成图片
生成不同风格的插画、写实图等
调整图片尺寸和比例
适用场景
营销物料生成（海报、banner）
产品概念图
文章配图
创意设计参考
Prompt 配置建议
引导用户描述清楚图片需求
帮用户把模糊描述转化为详细的图片 Prompt
告诉用户图片生成的限制
Prompt 示例
当用户需要生成图片时： 1. 先确认用户的需求：主题、风格、用途、尺寸 2. 将用户描述优化为详细的图片生成 Prompt 3. 生成图片后，询问是否满意，不满意可以调整描述重新生成 图片 Prompt 优化规则： - 加上风格描述（写实/插画/扁平化等） - 加上画面细节（颜色、构图、光线等） - 加上质量描述（高质量、4K、专业等）
让智能体能够读取和处理用户上传的文件，包括文档、表格、PDF 等。
能力
读取 PDF、Word、TXT 等文档
解析 CSV、Excel 表格
提取文件中的文本内容
分析文件结构和内容
适用场景
文档摘要和提取关键信息
表格数据分析和处理
简历解析和评估
合同/文档审查
Prompt 配置建议
告诉 AI 文件可能有哪些格式
指定提取信息的优先级
处理大文件时分段处理
Prompt 示例
当用户上传文件时： 1. 先识别文件类型和大小 2. 提取文件内容 3. 根据用户需求进行处理 处理规则： - 文档类：生成摘要 + 关键要点 - 表格类：展示数据概览 + 统计分析 - 如果文件过大，分段处理并告知用户
提供精确的数学计算能力。比大模型自带的计算更准确可靠。
能力
基础四则运算
科学计算（三角函数、对数等）
单位换算
汇率换算
适用场景
财务计算（利息、税费、折扣）
物理/化学计算
日常单位换算
汇率和货币转换
Prompt 配置建议
涉及数字的问题优先用计算器而不是大模型估算
计算结果要配合解释说明
复杂计算建议用代码执行插件
Prompt 示例
所有涉及数字计算的问题，使用计算器插件确保准确性。 大模型不擅长精确计算，一定要调用计算器。
怎么创建自定义插件
当内置插件不能满足需求时，可以创建自定义插件对接任意第三方 API。6 步完成。
确定需求
明确你需要智能体调用什么外部服务。比如查询天气、发送邮件、查数据库等。
先确认有没有内置插件能满足
确认目标 API 是否有公开接口
评估 API 的稳定性和费用
准备 API
获取目标 API 的接口文档，确认鉴权方式、请求格式和响应格式。
用 Postman 或 curl 先测试 API
记录所有必要的参数和返回字段
确认 API 的调用频率限制
创建插件
在 Coze 开发者平台创建自定义插件，填写 API 接口信息。
Coze 支持 OpenAPI 规范导入
也可以手动填写接口信息
设置好鉴权方式（API Key / OAuth）
配置接口
配置 API 的请求参数、请求头和响应解析规则。
用清晰的参数描述，方便 AI 理解何时调用
设置参数的必填/选填和默认值
配置响应字段映射
测试调试
在插件测试页面模拟调用，确认请求和响应都正确。
测试正常请求和异常请求
确认错误码和错误信息处理
检查响应数据格式是否正确
挂载使用
在智能体中挂载插件，在 Prompt 中说明什么时候使用这个插件。
在 Prompt 中描述插件的能力和使用场景
设置调用频率限制
监控 API 调用量和费用
常用第三方 API 对接
这些 API 是做智能体最常用的外部服务。大部分都有免费额度，适合起步阶段。
| API | 提供商 | 说明 | 费用 | 适用场景 |
|---|---|---|---|---|
| 天气查询 | 和风天气 / OpenWeatherMap | 查询全球天气数据，支持实时天气和未来预报 | 有免费额度 | 旅行助手、日常问答 |
| 汇率查询 | ExchangeRate-API | 实时汇率查询和货币换算 | 有免费额度 | 财务工具、跨境电商 |
| 快递查询 | 快递 100 / 快递鸟 | 查询快递物流信息 | 按次计费 | 电商客服、物流助手 |
| API | 提供商 | 说明 | 费用 | 适用场景 |
|---|---|---|---|---|
| OCR 文字识别 | 百度 OCR / 腾讯 OCR | 识别图片中的文字 | 有免费额度 | 文档处理、票据识别 |
| 语音合成 | 百度 TTS / Azure TTS | 将文字转换为语音 | 按字符计费 | 有声读物、语音助手 |
| 翻译 API | 百度翻译 / DeepL | 多语言文本翻译 | 有免费额度 | 翻译助手、多语言支持 |
| API | 提供商 | 说明 | 费用 | 适用场景 |
|---|---|---|---|---|
| 邮件发送 | SendGrid / Resend | 发送邮件通知 | 有免费额度 | 报告推送、用户通知 |
| 企业微信/飞书通知 | 企业微信 API / 飞书 API | 发送消息到群聊或个人 | 免费 | 工作提醒、告警通知 |
| Webhook | 自定义 | 通过 HTTP 请求触发外部操作 | 免费 | 自动化流程、系统对接 |
| API | 提供商 | 说明 | 费用 | 适用场景 |
|---|---|---|---|---|
| Airtable | Airtable | 在线数据库，支持增删改查 | 有免费版 | 数据收集、CRM |
| Notion API | Notion | 读写 Notion 文档和数据库 | 免费 | 知识管理、任务管理 |
| Google Sheets | 读写 Google 表格 | 免费 | 数据记录、报表 |
插件使用最佳实践
能不用插件就不用。简单的问题 AI 自己就能回答，调用插件反而慢
优先用内置插件。内置插件稳定性和兼容性最好
第三方 API 选大厂的。小厂 API 可能不稳定或随时停服
考虑成本。每次 API 调用都有成本，高频场景要算清楚
明确说明每个插件的用途和触发条件
设定插件调用的优先级（先知识库 → 再搜索 → 再 API）
告诉 AI 插件调用失败时的兜底方案
限制每次对话最多调用的插件次数
API 超时要有提示（请稍后再试）
数据为空要有说明（未找到相关信息）
参数错误要引导用户重新输入
预算不足要提前预警
对频繁查询的数据做缓存
减少不必要的 API 调用（先判断是否真的需要）
异步调用非关键 API（如日志记录）
批量操作优于单条调用
API Key 不要暴露在 Prompt 中
限制 API 调用频率，防止恶意滥用
敏感数据（用户信息等）不要在日志中明文记录
定期轮换 API Key
插件使用决策流程
1. 用户提出问题
2. AI 自身知识能回答？ → 直接回答
3. 知识库有答案？ → 基于知识库回答
4. 需要实时信息？ → 调用搜索插件
5. 需要计算/处理？ → 调用代码/计算器插件
6. 需要外部数据？ → 调用自定义插件
7. 以上都不行？ → 告知用户无法回答