扣子智能体插件接入与商城插件使用指南

2026-06-06阅读 0热度 0

智能体

在使用扣子（Coze）平台构建智能体时，很多人会发现，智能体默认是不“认识”任何外部工具的。它就像一个只有大脑、没有感官和手脚的个体。

想要让它能实时查新闻、帮你问天气，或者调用某个特定的API接口（比如接上ChatGPT），就必须给它装上“感官”和“工具”——这就是插件。

具体操作其实不复杂，但有几个关键点容易踩坑。我们直接进入正题。

从零开始添加商城插件

第一步，登录扣子平台（coze.cn），进入「项目开发」模块，点击「创建」，选择「创建智能体」。填好名称和功能描述后，确认创建。

第二步，进入智能体编辑页，在左侧导航栏中找到「编排」并点击。在右侧的「技能」区域，你会看到「插件」模块。关键点来了——点击它旁边的「+」按钮。

此时会弹出插件商店。在顶部的搜索框里输入你需要的功能关键词，比如“头条新闻”“墨迹天气”“dataeyes”，找到目标插件后，点击右侧的「添加」按钮。这个插件就会立刻出现在当前智能体的插件列表中，不需要复杂的安装或重启流程。

需要注意的是：插件添加后，默认是“禁用”状态。它并不会自动被调用。必须在「人设与回复逻辑」的提示词里明确写出触发指令，它才会真正干活。

在编排画布的空白处，点击右上角的「+」符号，选择「HTTP 插件」。可以将其命名为“调用GPT-4o”，请求方式设为POST。

这一步是核心，参数填错一个都不会通。

请求URL：填入兼容OpenAI格式的地址，例如：https://your-api-domain.com/v1/chat/completions。
请求头：必须包含两个关键参数：
{"Authorization": "Bearer 【你的API密钥】", "Content-Type": "application/json"}
请求体：必须使用JSON格式，并正确引用用户输入的变量。例如：
{"model":"gpt-4o-mini","messages":[{"role":"user","content":"{{input}}"}]}

输入来源：在「输入字段映射」中，将变量「input」绑定到HTTP插件请求体中的 content 字段。
输出去向：在「输出字段映射」中，设置输出路径为 choices.0.message.content，并将结果命名为「gpt_reply」。
后续的对话节点，就可以直接引用 {{gpt_reply}} 来输出结果了。需要注意，如果路径写成了 choices[0].message.content 或 choices.0.message.text，解析会失败，而且平台不会给出报错提示。

插件配置好了，但智能体不会主动去用它。它需要我们通过提示词明确告诉它“什么时候、用什么工具、怎么做”。

举个例子：如果你想让智能体具备获取新闻的能力，提示词要写成：

“你具备实时获取最新AI行业新闻的能力。当用户询问‘最近有什么AI大事件’时，请调用‘头条新闻’插件的 getToutiaoNews 工具，限制返回3条，按时间倒序排列。”

这里包含了三个关键要素：插件名称（头条新闻）、工具名称（getToutiaoNews）、明确的动作指令（调用）。

如果写成“你可以查新闻”这样模糊的指令，扣子是识别不了的，它不会执行任何调用动作。

所以，如果插件配置正确但始终没有触发，别急着怀疑配置，先回头检查一下提示词——是不是同时满足了三个条件：插件名称完全一致（区分大小写）、工具名拼写准确、指令动词为“调用”“使用”“执行”等明确的动作词。