ORANGE BOOK · COZE

附录 A 常用操作速查表

一、注册 / 登录

操作 路径
国内版注册 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