一、添加插件(让 Bot 拥有“手脚”)
插件是 Coze 扩展 Bot 能力边界的主要方式,能让 Bot联网搜索、执行代码、调用外部 API,而不只是依赖模型自身的知识。
添加插件的方式
在 Bot 编辑页的「技能」→「插件」区域,有两种添加方式:
方式一:手动添加
点击「+」图标,从插件商店或你的工作空间资源库中挑选已发布的插件。展开目标插件后,点击对应工具旁边的「添加」即可。
方式二:自动添加
点击「自动添加」图标,大模型会根据你的 Bot 人设和回复逻辑,自动从商店中选择合适的插件。不过自动添加后,建议手动调试,检查插件是否能被正常调用。
常用插件示例
| 插件 | 作用 | 典型场景 |
|---|---|---|
| Bing 搜索 | 联网获取实时信息 | 查新闻、找资料 |
| 代码解释器 | 执行 Python 代码 | 数据处理、画图、计算 |
| PDF 解析器 | 提取 PDF 中的文本和表格 | 论文分析、文档处理 |
以“智能科研助手”为例,添加 Bing 搜索插件后,可以在提示词中明确规则:“当用户提供论文标题或 DOI 时,优先使用 Bing 搜索插件获取 PDF 或摘要”。这样模型就知道什么时候该调用插件。
插件调用
必须在提示词中明确定义插件的使用场景。Coze 官方文档也强调:为了提高插件调用时机的准确性,建议在「人设与回复逻辑」区域明确定义插件的使用场景,从而减少因模型回复随机性导致的插件调用不符合预期的情况。
# 插件使用规则 1. 当用户询问实时信息(如新闻、天气、最新论文)时,调用 Bing 搜索插件。 2. 当用户要求执行代码、计算或数据处理时,调用代码解释器插件。 3. 当用户上传 PDF 并需要解析内容时,调用 PDF 解析器插件。注意事项
部分三方插件是付费的,首次添加时会弹出开通提示框,确认后才能使用。
添加了三方付费插件的 Bot,不支持发布到飞书多维表格、掘金、豆包及部分公共渠道。
如果插件调用频繁,可以考虑申请 QPS 扩容。
二、编排工作流(自动化复杂任务)
工作流是 Coze 的高级功能,通过拖拽节点将多步骤任务串联起来,实现从“单次问答”到“自动化流程”的跨越。
工作流本质上是一个有向无环图(DAG),由多个节点按照特定逻辑连接而成,每个节点代表一个处理单元,连接线定义了数据流向。与线性脚本不同,工作流支持条件分支、并行处理和错误恢复,更贴合真实业务场景。
核心节点类型
工作流默认包含Start和End节点,中间可以拖入以下节点:
| 节点类型 | 作用 | 关键配置 |
|---|---|---|
| 大模型节点(LLM) | 调用 AI 模型处理文本 | 模型选择、系统提示词、用户提示词(支持{{变量名}}引用) |
| 插件节点 | 调用外部 API | 选择插件和具体工具,配置输入参数来源 |
| 代码节点 | 执行 Python/JS 逻辑 | 适合自定义数据处理、格式转换 |
| 条件分支(IF/Else) | 根据条件走不同路径 | 设置判断条件和分支逻辑 |
| 知识库检索 | 从知识库召回内容 | 选择知识库,设置召回数量 |
| 循环/批处理 | 逐条或批量处理数据 | 适合批量生成、批量入库 |
大模型节点的提示词技巧:在大模型节点中,可以用{{变量名}}引用前面节点的输出,实现数据传递。
工作流示例
以“论文深度解析”工作流为例,展示从输入到输出的完整流程:
每个节点的配置:
开始节点:定义输入参数
query(String 类型)代码节点(预处理):用 Python 从 query 中提取 DOI
import re paper_pattern = r'\b(10\.\d{4,9}/[-._;()/:A-Z0-9]+\b)' doi = re.search(paper_pattern, query) return {"doi": doi.group(0) if doi else None}插件节点(Bing搜索):用提取出的 DOI 搜索论文
LLM 节点:从搜索结果中提取 Method 名称、损失函数公式、消融实验结论
代码节点:根据 LLM 输出生成 LaTeX 伪代码
结束节点:返回最终结果
调试与测试
工作流配置完成后,点击「试运行」,输入测试数据,观察每个节点的输出。节点边框变绿表示执行成功,变红表示有错误,点击节点可以查看具体报错信息。
确认无误后,回到 Bot 编辑页,在「工作流」区域关联这个工作流。当对话触发工作流运行时,Coze 会根据工作流的配置逻辑自动调用插件节点,完成整个流程。