Coze（扣子）上手
学习目标：用 Coze 从零搭建一个带人设和知识库的 Agent，并成功发布到豆包或微信
预计时间：40 分钟
难度等级：⭐⭐☆☆☆
一、注册与界面介绍
1.1 注册
Coze 有两个版本，注册方式不同：
| 版本 | 地址 | 注册方式 | 默认模型 |
|---|---|---|---|
| 国内版（coze.cn） | https://www.coze.cn | 手机号注册 | 豆包 |
| 国际版（coze.com） | https://www.coze.com | Google / GitHub 注册 | GPT-4o |
怎么选？
- 你在国内、用中文场景 → 国内版（coze.cn）
- 你在海外、需要接 OpenAI 模型 → 国际版（coze.com）
- 两个版本账号不互通，功能有细微差异
注册流程（国内版）：
- 打开 https://www.coze.cn
- 点击"注册/登录"
- 输入手机号 → 获取验证码 → 完成
- 首次登录会要求设置昵称
全程不超过 2 分钟。
1.2 界面一览
登录后你会看到几个核心区域：
| 区域 | 功能 |
|---|---|
| 左侧导航 | 工作空间管理、Bot 列表、知识库管理、插件市场 |
| 中间区域 | 当前 Bot 的配置面板 |
| 右侧预览 | 实时对话预览，边配置边测试 |
核心操作都在中间的配置面板。Coze 把 Agent 的四个核心模块（人设、知识库、工作流、插件）都放在这个面板里，通过标签页切换。
二、创建智能体完整流程
2.1 第一步：创建 Bot
- 点击左上角"创建智能体"按钮
- 填写基本信息：
- 名称：给你的 Agent 起个名字（比如"学习小助手"）
- 描述：一句话说明它干什么（比如"帮你整理学习笔记和回答课程相关问题"）
- 图标：可以上传或用 AI 生成
命名建议
名称要让用户一看就知道这个 Agent 能干什么。"万能助手"不如"英语语法检查助手"。
2.2 第二步：配置人设与提示词
这是 Agent 的灵魂。Coze 把人设配置放在"人设与回复逻辑"标签页。
核心是写一个 System Prompt，定义 Agent 的角色和行为。
一个好用的人设模板：
# 角色
你是一个专业的【角色名称】，擅长【核心能力】。
## 背景信息
【补充 Agent 需要知道的背景】
## 核心能力
1. 【能力 1】：【具体说明】
2. 【能力 2】：【具体说明】
3. 【能力 3】：【具体说明】
## 回答规则
- 优先使用知识库中的内容回答问题
- 如果知识库中没有相关信息，明确告知用户"我目前没有相关资料"
- 回答时使用简洁的中文，避免过于学术化的表达
- 每次回答控制在 300 字以内
## 禁止行为
- 不回答与【角色范围】无关的问题
- 不编造不存在的资料或数据
- 不替用户做最终决策实际案例 — "Python 学习助手"人设：
# 角色
你是一个 Python 编程学习助手，专为零基础学习者设计。
## 核心能力
1. 解答 Python 语法问题：用简单类比解释复杂概念
2. 代码调试：分析用户粘贴的代码，指出错误并提供修改建议
3. 学习路径建议：根据用户当前水平推荐下一步学什么
## 回答规则
- 代码示例必须可以直接运行
- 解释概念时用一个生活中的类比
- 如果用户的问题不明确，主动追问，而不是瞎猜
- 每次回答控制在 500 字以内
## 禁止行为
- 不讨论非 Python 话题
- 不给用户布置"作业"——学习者自驱，不搞强制2.3 第三步：添加知识库
点击"知识库"标签页 → "添加知识库" → 选择创建方式：
| 方式 | 适合场景 | 支持格式 |
|---|---|---|
| 上传文件 | 已有文档资料 | PDF、Word、TXT、Excel |
| 在线网页 | 抓取网页内容 | 输入 URL 自动抓取 |
| Notion 同步 | 团队协作知识库 | Notion 数据库/页面 |
| 数据库 | 结构化数据查询 | MySQL、PostgreSQL |
最常用的操作 — 上传 PDF：
- 点击"创建知识库" → 选择"文件类型"
- 给知识库起个名字（比如"Python 入门教程"）
- 上传 PDF 文件（单文件最大 20MB，单知识库最多 100 个文件）
- 等待系统自动处理（分块 + 向量化，通常 1-3 分钟）
- 处理完成后，回到 Bot 配置页面，把这个知识库关联到 Bot
注意
知识库不是越大越好。塞进去 100 个不相关的 PDF，检索效果反而差。只上传与 Agent 角色高度相关的资料。
2.4 第四步：设置开场白和对话引导
在"开场白"配置区域：
开场白文案：用户打开对话时看到的第一段话
你好！我是 Python 学习助手 🐍 我可以帮你： 1. 解答 Python 语法问题 2. 调试你的代码 3. 推荐学习路径 直接问我就行，不需要客气。推荐问题：开场白下方的快捷按钮，引导用户提问
- Python 变量是什么？ - 帮我看看这段代码哪里错了 - 零基础应该从哪学起？
开场白不是装饰。好的开场白能让用户立刻知道这个 Agent 能干什么、怎么开始，大幅降低使用门槛。
2.5 第五步：测试
千万别跳过测试这一步。 配置完就在右侧预览面板里试几下：
- 问一个知识库里有答案的问题 → 检查回答是否引用了知识库
- 问一个知识库里没有的问题 → 检查 Agent 是否正确说"不知道"
- 问一个与角色无关的问题 → 检查 Agent 是否拒绝回答
- 连续对话 3-5 轮 → 检查上下文是否连贯
三、国内版与国际版的区别
| 维度 | 国内版（coze.cn） | 国际版（coze.com） |
|---|---|---|
| 模型 | 豆包、Kimi、DeepSeek、GLM 等 | GPT-4o、Claude、Gemini 等 |
| 发布渠道 | 豆包、微信、飞书、掘金 | Discord、Telegram、WhatsApp、Messenger |
| 知识库 | 支持 Notion、飞书文档 | 支持 Notion、Google Drive |
| 插件市场 | 国内服务为主（天气、搜索、新闻） | 国际服务为主（Google 搜索、DALL-E） |
| 免费额度 | 豆包模型免费 | 有一定免费额度，具体看模型 |
| 语言 | 中文优先 | 英文优先 |
能不能两个都注册？
可以。两个版本互不影响，根据项目目标选择用哪个。比如给国内用户做 Agent 用 coze.cn，给海外用户做用 coze.com。
四、发布渠道
Coze 支持多种发布方式，这是它相比 Dify/FastGPT 的一大优势：
4.1 发布到豆包
最简单的发布方式。点击"发布" → 选择"豆包" → 你的 Agent 会出现在豆包 App 中。
- 适合：个人使用、分享给朋友
- 时间：1 分钟搞定
4.2 发布到微信
通过微信公众号/小程序接入。
- 发布时选择"微信公众号"或"微信客服"
- 按照指引绑定你的微信公众号
- 用户在公众号里直接和 Agent 对话
- 适合：面向用户的客服、内容分发
- 时间：10-15 分钟（需要已有微信公众号）
4.3 API 调用
发布后获得 API 端点，可以在任何应用中调用你的 Agent。
POST https://api.coze.cn/v3/chat
Authorization: Bearer {your_token}
Content-Type: application/json
{
"bot_id": "your_bot_id",
"user_id": "user_123",
"stream": false,
"auto_save_history": true,
"additional_messages": [
{
"role": "user",
"content": "你好，帮我解释一下 Python 的列表推导式"
}
]
}- 适合：嵌入到自己的产品中
- 时间：5-10 分钟
4.4 其他渠道
| 渠道 | 说明 |
|---|---|
| 飞书 | 绑定飞书机器人，在飞书群聊中使用 |
| 掘金 | 发布到掘金社区 |
| 网页嵌入 | 生成嵌入代码，放到任何网页里 |
五、常见问题
Q1：Coze 收费吗？
豆包模型免费使用。接入第三方模型（如 Kimi、DeepSeek）消耗 API 额度。对于个人学习和轻量使用，免费额度完全够。
Q2：知识库上传后多久能用？
通常 1-3 分钟。大文件（接近 20MB）可能需要 5 分钟左右。
Q3：Agent 回答"我不知道"，但知识库里明明有相关内容？
这是最常见的知识库检索问题。检查：
- 文档分块是否合理（太大的块会稀释关键信息）
- 用户的提问方式是否和文档内容匹配
- 尝试在 Prompt 中明确要求"优先检索知识库"
Q4：国内版和国际版能互相同步吗？
不能。两个版本完全独立，Bot 不能跨版本迁移。
本节小结
回顾要点
✅ Coze 注册 2 分钟搞定，国内版用手机号，国际版用 Google 账号
✅ 创建 Agent 五步走：创建 Bot → 配置人设 → 添加知识库 → 设置开场白 → 测试
✅ 人设是 Agent 的灵魂——用模板写 System Prompt，比自由发挥靠谱
✅ 发布渠道丰富：豆包、微信、飞书、API，根据目标用户选择
✅ 别跳过测试——配置完立刻在预览面板里验证