一、注册 / 登录
| 操作 |
路径 |
| 国内版注册 |
https://www.coze.cn → 右上角「立即开始」 |
| 国际版注册 |
https://www.coze.com → Sign Up |
| 切换账号 |
头像 → 退出登录 → 重新登录 |
| 切换工作空间 |
左上角「个人空间」下拉切换 |
二、智能体(Bot)相关
| 操作 |
路径 |
| 创建智能体 |
工作空间 → 「+ 创建」→「智能体」 |
| 复制智能体 |
智能体卡片 → 右键 / 三个点 → 「复制」 |
| 删除智能体 |
智能体卡片 → 三个点 → 「删除」 |
| 修改名字 / 头像 |
编辑页左上角点名字 / 头像 |
| 切换到多 Agent 模式 |
编辑页右上角「Multi-Agent」 |
| 设置开场白 |
编辑页右侧「开场白」 |
| 设置快捷指令 |
编辑页右侧「快捷指令」 |
| 试运行 |
编辑页右侧「预览与调试」窗口 |
| 发布 |
编辑页右上角「发布」 |
| 看历史版本 |
编辑页 → 「版本管理」 |
| 回滚到旧版 |
版本管理 → 选旧版 → 「恢复到此版本」 |
三、模型相关
| 操作 |
路径 |
| 切换模型 |
编辑页右侧 / 顶部「模型」下拉 |
| 调温度 (Temperature) |
模型旁的「参数设置」 |
| 改最大输出长度 |
模型参数中的 Max Tokens |
| 关闭 / 打开思维链 |
选用 Thinking 类模型即可 |
四、知识库
| 操作 |
路径 |
| 创建知识库 |
资源库 → 知识库 → 「+ 创建」 |
| 上传文档 |
知识库内 → 「+ 添加内容」 |
| 调切片参数 |
上传后 → 「分段设置」 |
| 调召回参数 |
Bot 编辑页 → 知识库技能 → 「召回设置」 |
| 删除知识库 |
知识库列表 → 三个点 → 「删除」 |
| 知识库支持的格式 |
PDF, DOC, TXT, MD, Excel, CSV, HTML, URL, FAQ |
五、插件
| 操作 |
路径 |
| 安装插件 |
Bot 编辑页 → 技能 → 插件 → 「+ 添加」 |
| 创建自定义插件 |
资源库 → 插件 → 「+ 创建插件」 |
| 看插件调用日志 |
调试窗口 → 「调用日志」 |
| 卸载插件 |
Bot 内插件列表 → 「移除」 |
六、工作流
| 操作 |
路径 |
| 创建工作流 |
资源库 → 工作流 → 「+ 创建」 |
| 添加节点 |
左侧节点库 → 拖到画布 |
| 连接节点 |
节点边缘小圆点 → 拖到下一节点 |
| 试运行 |
画布右上角「试运行」 |
| 看每节点输出 |
试运行后点节点本身 |
| 发布工作流 |
画布右上角「发布」 |
| 把工作流挂到 Bot |
Bot 编辑页 → 技能 → 工作流 → 添加 |
七、发布渠道
| 渠道 |
路径 / 关键参数 |
| 扣子商店 |
发布弹窗 → 勾选「扣子商店」 |
| 豆包 |
发布弹窗 → 勾选「豆包」 |
| 飞书 |
需 App ID + Secret + 回调 URL |
| 微信公众号 |
需 AppID + AppSecret + Token + EncodingAESKey |
| 微信客服 |
微信客服后台开通 → 接入 |
| 抖音 / 头条 |
创作者后台 → 智能管家 → 接入 |
| 网页 SDK |
发布弹窗 → 「网页 SDK」→ 拷 <script> |
| API |
发布弹窗 → 「API」→ 拿 bot_id |
八、API 调用速查
# Python 示例
import requests
headers = {
"Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN",
"Content-Type": "application/json"
}
data = {
"bot_id": "YOUR_BOT_ID",
"user": "user-001",
"query": "你好",
"stream": False
}
resp = requests.post(
"https://api.coze.cn/open_api/v2/chat",
headers=headers,
json=data
)
print(resp.json())
// Node.js 示例
const fetch = require('node-fetch');
fetch('https://api.coze.cn/open_api/v2/chat', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_TOKEN',
'Content-Type': 'application/json'
},
body: JSON.stringify({
bot_id: 'YOUR_BOT_ID',
user: 'user-001',
query: '你好',
stream: false
})
}).then(r => r.json()).then(console.log);
九、常见报错与处理
| 报错 |
原因 |
解决 |
| 调试窗口"模型异常" |
模型暂时性故障 |
等 30 秒重试 / 换一个模型 |
| 插件返回 401 |
鉴权失败 |
检查插件的 API Key |
| 插件返回 429 |
被限流 |
降低调用频率 / 升级付费 |
| 知识库召回为空 |
阈值太高或文档质量差 |
阈值降到 0.4 / 重传文档 |
| 工作流跑不动 |
某节点配置错误 |
单节点试运行排查 |
| 发布失败 |
必填项没填 |
检查名字、描述、头像、提示词 |
| 公众号 Bot 不回消息 |
服务器配置错误 |
重新走"设置与开发 → 服务器配置" |
| 微信 5 秒超时 |
工作流太慢 |
改成"先回'正在处理' + 异步发" |
| API 调用 403 |
Token 错或无权限 |
重新生成 Personal Access Token |
| 上传文档失败 |
大小超限 / 格式不支持 |
拆分文档 / 转 PDF |
十、命令式操作(API / 终端)
# 创建对话会话
curl -X POST https://api.coze.cn/v3/chat \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"bot_id":"xxx","user_id":"u1","stream":false,"additional_messages":[{"role":"user","content":"hi"}]}'
# 查询会话状态
curl https://api.coze.cn/v3/chat/retrieve?chat_id=xxx&conversation_id=yyy \
-H "Authorization: Bearer $TOKEN"
# 发布工作流
# (目前只能在 Web 界面,无 CLI)
十一、效率快捷键(Web 界面)
| 快捷键 |
功能 |
| Ctrl/Cmd + S |
保存当前编辑 |
| Ctrl/Cmd + Z |
撤销 |
| Ctrl/Cmd + Shift + Z |
重做 |
| Esc |
关闭弹窗 |
| Tab |
工作流画布内切换节点 |
十二、限额速查(个人版,2026 年 4 月)
⚠️ 限额会随官方政策调整,以扣子官网公示为准。
| 资源 |
个人版限额 |
| 智能体数量 |
不限 |
| 知识库数量 |
~50 个 |
| 单文档大小 |
~50 MB |
| 工作流节点数 |
~30 个 |
| 月度免费 Token |
几十万 - 几百万(按模型) |
| 插件调用 |
多数免费,部分按次收费 |
十三、3 个最常用的官方文档链接
- 扣子官方文档:https://www.coze.cn/docs
- 扣子开放平台:https://www.coze.cn/open
- 扣子社区帮助:https://www.coze.cn/community