必须发布智能体为API服务并配置bot_id与PAT令牌，否则外部调用返回401错误；发布需勾选“API”，获取bot_id从URL末尾提取，PAT令牌在开发者设置中创建并立即保存；调用时需在Authorization头携带Bearer令牌，且请求体含bot_id、user_id等必要字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让扣子智能体被微信小程序、ERP系统或IoT设备调用，必须完成API发布并配置合法鉴权凭证，否则外部请求会直接返回401错误。
发布智能体为API服务
进入智能体编辑页，点击右上角【发布】按钮→在发布渠道中【必须勾选“API”】→填写本次发布的简要说明（如“v1.0上线供内部系统调用”）→点击【发布】。
发布成功后，页面顶部会显示“已发布为API服务”绿色提示，此时智能体才具备被外部HTTP请求访问的能力。
获取两个关键凭证
第一步：打开浏览器地址栏，找到形如https://www.coze.cn/space/123456789/bot/7421234567890123456的URL，斜杠后最后一个数字串就是bot_id，复制保存。
第二步：点击右上角头像→【开发者设置】→【API令牌】→【创建令牌】→名称填“生产环境调用”，权限至少勾选“chat”，过期时间建议选“1年”→点击【确定】→页面仅显示一次完整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"的流式响应，说明调用链路已通。
方法二：Java代码调用（OkHttp示例）
构造RequestBody时，必须设置"stream":false，否则默认流式响应会阻塞主线程；user_id建议用业务唯一标识（如用户手机号），不能固定写死为"123456789"。
方法三：Python requests调用
使用requests.post()发送JSON数据，注意headers中Authorization字段值格式为Bearer {pat_token}，中间有空格；请求体中的additional_messages字段可为空数组，但不能省略。
