扣子工作流怎么调用外部插件或自定义API接口

明明想让Bot查个实时天气或者同步订单状态，结果它只能在那儿“一本正经”地胡说八道，这种无力感做AI应用的都懂。其实扣子（Coze）的工作流早就留好了“后门”，只要接上外部插件或API，Bot就能瞬间变成能干实事的业务助手。

很多新手卡在第一步：分不清什么时候该用现成的插件，什么时候得自己写API。简单说，如果是查汇率、搜新闻这种通用需求，直接调官方插件最快；要是想连自家公司的CRM或数据库，那就得靠自定义API节点。咱们先看看怎么把这两类接口稳稳地接进工作流里。

添加官方插件：像搭积木一样简单

如果你需要的功能在扣子插件市场里已经有现成的，比如发送飞书消息、查询维基百科，那完全没必要重复造轮子。在工作流编辑页面，点击左侧工具栏的“插件”图标，搜索你需要的服务。

选中插件后，拖拽到画布中，系统会自动生成一个节点。这时候别急着连线，双击节点检查授权状态。大部分官方插件需要你先在个人设置里完成OAuth授权，否则运行时会报“未授权”错误。授权完成后，你会看到输入参数列表，这里通常已经预设好了必填项，比如搜索关键词或接收人ID。

在插件市场搜索并添加节点，注意检查授权状态

关键点在于参数的来源。不要手动填死值，而是要点击参数输入框右侧的“引用”按钮，选择上游节点（比如开始节点或LLM节点）输出的变量。这样，每次用户提问不同，传给插件的参数才是动态变化的。改完后，记得点一下节点右上角的“试运行”，看返回的JSON结构是否符合预期。

接入自定义API：打通私有数据的关键

当官方插件满足不了需求，比如你要查询内部库存或写入客户信息，就得用“HTTP请求”节点。这个节点相当于一个通用的浏览器，帮你向指定URL发送GET或POST请求。

首先，在画布中添加“HTTP请求”节点。在配置面板中，填入你的API地址。注意，如果接口需要鉴权，通常在Headers里添加Authorization字段，格式一般是Bearer加上你的Token。为了安全，建议把Token放在工作流的“环境变量”或“秘密”中引用，而不是直接明文写在代码里。

配置URL、Headers及Body中的动态变量引用

接下来是重头戏：构造请求体。如果是POST请求，需要在Body中选择JSON格式，并填入接口文档要求的字段。同样，这里的值要从上游节点引用。比如，用户问“查订单123”，你就把“123”这个变量映射到API需要的order_id字段上。

很多开发者在这里容易踩坑：API返回的数据往往嵌套很深，比如data.list[0].name。在工作流后续节点中引用时，必须准确找到这个路径。你可以先在HTTP节点的“试运行”里查看完整返回结果，复制那个具体的JSON路径，再粘贴到下游节点的引用表达式中。

处理返回数据与错误兜底

接口调通了不代表万事大吉，网络波动或参数错误随时可能发生。如果API返回失败，整个工作流不应该直接崩溃，而是应该给用户一个友好的提示。

建议在HTTP节点后加一个“条件分支”节点。判断HTTP状态码是否为200，或者返回体中success字段是否为true。如果是，走正常流程，把数据交给LLM总结；如果不是，走异常分支，输出一句“暂时无法获取数据，请稍后再试”。

根据状态码或成功字段分流处理正常与异常数据

另外，注意数据类型的匹配。有些API返回的数字是字符串格式，而后续的数学计算节点需要数字类型。如果遇到报错，检查一下是否需要在中间加一个“代码”节点，用简单的JavaScript做一下类型转换，比如parseInt()。

调试与发布前的最后检查

在正式发布前，务必使用工作流右上角的“调试”功能，模拟几种典型的用户输入。观察每个节点的输入输出，特别是API节点的响应时间。如果某个接口响应超过5秒，考虑是否需要优化接口性能，或者在Bot提示语中告知用户“正在查询中，请稍候”。

记住，工作流的价值在于稳定。不要试图在一个节点里完成所有逻辑，保持每个节点功能单一，出错时才容易定位是参数传错了，还是接口本身挂了。把这些外部连接理顺，你的Bot才算真正拥有了“手脚”，能替你去互联网和公司系统里跑腿办事了。