扣子智能体API发布：外部系统调用方法全解析
想要让扣子智能体被微信小程序、ERP系统甚至IoT设备顺利调用？第一步就是要完成API发布，并配置好合法的鉴权凭证。否则，外部请求会直接收到401错误——连门都进不去。
说白了，整个流程就三步：把智能体发布成API服务、拿到两个关键凭证（bot_id和PAT令牌）、然后在外部的系统里用正确的姿势发起调用。下面一步步拆开来讲。
发布智能体为API服务
进入智能体编辑页，点击右上角的【发布】按钮。在弹出的发布渠道里，一定记得勾选“API”——很多人漏掉这一步，结果折腾半天发现外部怎么也调不通。接着填写本次发布的简要说明，比如“v1.0上线供内部系统调用”，然后点击【发布】。
发布成功后，页面顶部会出现一条绿色提示：“已发布为API服务”。到了这一步，智能体才真正具备了被外部HTTP请求访问的能力。简单说，没这个绿色提示，后面一切免谈。
获取两个关键凭证
先拿bot_id。打开浏览器地址栏，找到类似这样的URL：https://www.coze.cn/space/123456789/bot/7421234567890123456。注意看，斜杠后面的最后一个数字串就是bot_id，复制下来存好。
再拿PAT令牌。点击页面右上角的头像 →【开发者设置】→【API令牌】→【创建令牌】。名称填“生产环境调用”，权限至少勾选“chat”，过期时间建议选“1年”——太短了频繁续期麻烦，太长了又有安全隐患。点击【确定】后，页面只会显示一次完整的Token，赶紧复制到密码管理器或安全笔记里。一旦关闭页面，这个Token就永久丢失，只能重新生成。
配置外部系统发起调用
凭证到手，接下来就是实战了。分享三种最常用的调用方式，你可以根据自己系统的语言环境选一个。
方法一：用curl快速验证
在终端执行下面的命令，记得把{bot_id}和{pat_token}换成你刚才拿到的真实值：
curl -X POST "https://api.coze.cn/v3/chat" \ -H "Authorization: Bearer {pat_token}" \ -H "Content-Type: application/json" \ -d '{"bot_id":"{bot_id}","user_id":"test_001","content":"你好"}'
如果返回的响应里包含"event": "conversation.message.completed"，说明调用链路已经通了。这个响应是流式的，可以直观看到智能体逐字回复的过程。
方法二：Ja va代码调用（OkHttp示例）
构造RequestBody时有个坑——必须设置"stream":false，否则默认流式响应会阻塞主线程，导致程序卡住。另外，user_id建议用业务里的唯一标识，比如用户手机号或订单号，别写死成"123456789"，不然后续没法做会话管理和数据追踪。
方法三：Python requests调用
用requests.post()发送JSON数据，headers里Authorization字段的值格式是Bearer {pat_token}，中间那个空格少不得。请求体中的additional_messages字段可以为空数组，但不能省略——这个字段是给多轮对话用的，即使现在用不到也要留着占位。