扣子智能体API发布与外部系统调用方法

雨辰小哥_1730

雨辰小哥_1730

2026-06-05

754人浏览

原创

必须发布智能体为API服务并配置bot_id与PAT令牌,否则外部调用返回401错误;发布需勾选“API”,获取bot_id从URL末尾提取,PAT令牌在开发者设置中创建并立即保存;调用时需在Authorization头携带Bearer令牌,且请求体含bot_id、user_id等必要字段。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

扣子智能体api发布与外部系统调用方法 - php中文网

要让扣子智能体被微信小程序、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}" \

扣子Coze CLI工具
扣子Coze CLI工具

与 Coze CLI (@coze/cli) 交互——创建/部署 Coze 项目、管理空间和组织、向项目发送消息、生成图像/音频/视频等功能

下载

-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字段可为空数组,但不能省略。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

扣子 扣子智能体

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
扣子智能体开发实操指南
扣子智能体开发实操指南

本专题面向开发者与产品同学,完整讲解扣子智能体Bot从零到一的搭建流程,包括Bot创建、提示词编写、插件接入、变量与记忆配置、调试与多渠道发布,帮助你打造属于自己的AI助手。

2026.06.05

694

14

扣子工作流全功能使用教程
扣子工作流全功能使用教程

本专题系统讲解扣子工作流的搭建逻辑与节点使用,覆盖LLM节点、代码节点、条件分支、循环节点与子工作流等核心能力,配合15个实战案例,帮助你用工作流把复杂业务流程自动化。

2026.06.05

534

15

扣子知识库零基础入门
扣子知识库零基础入门

本专题围绕扣子知识库与记忆系统,详细讲解知识库创建、文档上传、切片策略、向量召回、问答调优以及变量记忆与数据库的使用方法,帮助你打造高准确率的私有知识问答能力。

2026.06.05

627

15

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

20

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
扣子入门级教程
扣子入门级教程

共0课时 | 306人学习

扣子官方文档
扣子官方文档

共0课时 | 0人学习