AI知识库

Coze 扣子平台

22分钟阅读

1. 平台概述

1.1 什么是 Coze 扣子

Coze 扣子是字节跳动推出的一站式 AI 智能体（Agent）开发与应用平台。其核心理念是「降低 AI 应用开发门槛」，通过无代码/低代码的方式，让即使没有编程背景的用户也能快速构建功能强大的 AI 智能体，并一键发布到飞书、抖音、微信、豆包等主流平台。

Coze 更像是一个 AI 应用的「智能工厂」，追求的是标准化、流程化和易用性。

1.2 平台版本

版本适用人群主要区别
个人基础版普通用户尝鲜功能受限，不能部署 OpenClaw
个人高级版有高级需求的用户可部署 OpenClaw，消耗算力积分
个人旗舰版深度用户更多额度和高级功能
企业标准版/旗舰版团队/企业团队协作、权限管理、API 调用

💡 普通用户想要在 Coze 上部署 OpenClaw 小龙虾，需购买个人高级版及以上版本。

1.3 访问地址

2. 核心概念

在深入使用前，需理解 Coze 的几个核心概念：

2.1 智能体（Agent）

智能体是 Coze 平台的核心产品，可以理解为具备语言理解和对话能力的 AI「大脑」：

  • 理解用户的自然语言输入
  • 分析用户意图和上下文
  • 决定对话走向和响应策略
  • 协调调用各种功能模块（插件、工作流、知识库）

2.2 工作流（Workflow）

工作流扮演「执行者」的角色，通过可视化编排实现复杂业务流程：

  • 将多个节点串联成自动化流程
  • 支持条件分支、循环、并行执行
  • 可被智能体调用，实现复杂任务

2.3 知识库（Knowledge）

让 AI 智能体拥有「专业知识」或「私有数据」：

  • 支持上传 PDF、Word、TXT、Excel、CSV 等文件
  • 支持在线网页爬取（URL 导入）
  • 支持 API 自动同步数据
  • 智能分段（Chunking）处理，提升检索精度

2.4 插件（Plugins）

扩展 AI 能力边界的工具集，Coze 集成了60+ 官方插件，涵盖：

  • 新闻阅读、旅行规划、生产力工具
  • 图像理解 API、多模态模型
  • 支持快速集成私有 API 为自定义插件

2.5 卡片（Cards）

用于定制智能体对话界面中的交互卡片，呈现结构化信息（如按钮、表单、数据展示等），提升用户体验。

2.6 变量（Variables）

在智能体或工作流中存储和传递数据，支持不同数据类型，实现跨节点/跨会话的状态保持。

3. 智能体（Agent）

3.1 创建智能体

  1. 登录 coze.cn
  2. 进入工作台，左侧菜单点击「创建 Bot」
  3. 填写基本信息：
  4. 点击「确认」进入编辑页面

3.2 智能体配置项

3.2.1 提示词（Prompt）

提示词是智能体的核心配置，决定其行为风格和专业能力。建议结构：

# 角色
你是一位[职业/身份]，专注于[领域]...
 
# 技能
1. 擅长[技能1]
2. 擅长[技能2]
3. ...
 
# 工作流程
当用户[场景]时，你会：
1. [步骤1]
2. [步骤2]
3. [步骤3]
 
# 限制
- 不做[限制事项]
- 只回答[范围]相关内容

3.2.2 模型选择

在智能体配置中可选择使用的大模型：

模型特点适用场景
豆包大模型免费/低成本，效果好日常对话、通用场景
GPT-4o国际领先英文场景、高质量输出
MiniMax高性价比平衡成本与效果
千问阿里系中文能力强中文专业场景
DeepSeek开源、高性价比技术场景、代码相关

3.2.3 能力配置

  • ✅ 对话（基础能力，默认开启）
  • ✅ 插件：添加所需的插件扩展能力
  • ✅ 知识库：关联私有知识库增强专业性
  • ✅ 工作流：绑定复杂业务流程
  • ✅ 开场白：设置用户首次对话时的欢迎语
  • ✅ 用户问题建议：配置常见问题引导

3.3 调试与优化

Coze 提供内置调试工具：

  1. 预览窗口：在编辑页面右侧实时测试对话
  2. 日志面板：查看每次调用的详细输入输出
  3. 单步调试：针对插件/工作流逐步验证
  4. 效果优化：根据调试结果调整提示词或参数

4. 工作流（Workflow）

4.1 什么是工作流

工作流（Workflow）是通过可视化节点编排，将多个操作串联成自动化流程的工具。相比智能体的「问答式」交互，工作流更适合复杂、标准化的任务。

4.2 适用场景

  • 数据处理与转换（格式转换、批量处理）
  • 多步骤业务流程（内容生成→审核→发布）
  • 定时任务与自动化（每天自动生成日报）
  • API 调用串联（调用多个外部接口）

4.3 创建工作流

  1. 工作台 → 左侧菜单 → 工作流
  2. 点击「创建工作流」
  3. 选择模板或从空白开始
  4. 进入可视化编排界面

4.4 节点类型

节点类型说明
大模型（LLM）调用 AI 模型进行文本处理
代码（Code）执行 Python/JS 代码片段
条件（Condition）if/else 条件分支
循环（Loop）for/while 循环执行
插件（Plugin）调用插件能力
知识库检索从知识库中查询相关内容
HTTP 请求发起外部 API 请求
开始/结束定义流程入口和出口

4.5 工作流编排示例

【开始】→【大模型：提取关键词】→【知识库检索】
                                          ↓
                                   【条件：有无结果】
                                   ↓是              ↓否
                            【大模型：生成答案】  【大模型：通用回答】
                                          ↓
                                     【结束】

4.6 避坑指南

  • ⚠️ 循环节点需设置退出条件，防止死循环
  • ⚠️ HTTP 请求需注意超时设置（建议 ≥ 30s）
  • ⚠️ 复杂工作流建议先在测试环境验证
  • 💡 可以通过工作流市场复制他人的优质工作流

5. 知识库（Knowledge）

5.1 创建知识库

  1. 工作台 → 左侧菜单 → 知识库
  2. 点击「创建知识库」
  3. 设置基本信息：
  4. 选择数据类型：

5.2 数据导入方式

方式说明
本地文件上传支持 PDF、Word、TXT、Excel、CSV
在线网页爬取输入 URL，自动抓取网页内容
API 自动同步通过 API 接口定时同步外部数据

5.3 数据分段（Chunking）

分段设置是决定检索准确性的核心环节：

  • 智能分段：AI 自动识别语义边界
  • 固定长度分段：按字符数均分（如每 500 字符一段）
  • 自定义分段：手动设置段落标记

💡 分段过长会导致信息密度不足，分段过短会丢失上下文。建议根据文档特点选择合适的分段策略。

5.4 知识库召回配置

  • 召回数量：每次检索返回多少条（建议 3-5 条）
  • 相似度阈值：低于此分数的结果将被过滤
  • 召回模式：语义匹配 / 关键词匹配 / 混合

5.5 知识库在智能体中的使用

  1. 打开智能体编辑页面
  2. 在「知识库」配置项中添加已创建的知识库
  3. 智能体会自动根据用户问题检索知识库并结合回答

6. 插件系统（Plugins）

6.1 官方插件

Coze 内置超过 60 种官方插件，涵盖：

📰 内容类

  • 头条新闻、微博热搜、抖音热榜

  • 小红书内容、微信公众号文章 🛠 工具类

  • 网页搜索（Google、Bing、百度）

  • 天气查询、快递查询

  • 代码执行（Python、JavaScript）

  • 文件处理（PDF 解析、图片识别） 🎨 多媒体类

  • 图像生成（DALL-E、Stable Diffusion）

  • 图像理解（GPT-4V、多模态识别）

  • 语音合成 💼 企业类

  • 飞书相关操作

  • 腾讯文档、企业微信

  • 钉钉、Slack 集成

6.2 自定义插件（私有 API）

如果官方插件不满足需求，可快速集成私有 API：

  1. 工作台 → 插件 → 「创建插件」
  2. 填写 API 信息：
  3. 定义输入输出参数
  4. 测试并发布

6.3 插件使用

在智能体编辑页面：

  1. 找到「插件」配置项
  2. 点击「添加插件」
  3. 搜索并选择所需插件
  4. 插件会自动出现在智能体的能力列表中

7. 卡片（Cards）

7.1 什么是卡片

卡片（Cards）是 Coze 为智能体提供的交互界面组件，用于呈现结构化信息，增强用户体验。

7.2 卡片类型

卡片类型适用场景
文本卡片展示长文本、说明文档
按钮卡片提供选项按钮，引导用户下一步操作
表单卡片收集用户输入信息
数据卡片展示表格、列表等结构化数据
媒体卡片展示图片、视频
混合卡片组合以上多种元素

7.3 创建卡片

  1. 工作台 → 智能体 → 编辑页面
  2. 找到「卡片」配置项
  3. 点击「创建卡片」或选择模板
  4. 拖拽式编辑界面组件
  5. 预览效果并保存

7.4 卡片使用示例

┌─────────────────────────────────────┐
│ 📚 推荐书籍                          │
├─────────────────────────────────────┤
│ 1. 《刻意练习》— 提升技能的方法论     │
│ 2. 《原子习惯》— 养成好习惯的指南     │
│ 3. 《深度工作》— 高效工作的艺术        │
├─────────────────────────────────────┤
│  [查看详情]  [加入书架]  [换一批]    │
└─────────────────────────────────────┘

8. 变量与记忆

8.1 变量（Variables）

变量用于在工作流或智能体中存储临时数据：

创建变量：

  1. 智能体/工作流编辑页面 → 「变量」配置项
  2. 点击「添加变量」
  3. 设置： 使用变量：
  • 在提示词中引用：今天的日期是 {{date}}
  • 在工作流中引用：{ { variable_name } }
  • 支持跨节点传递数据

8.2 记忆（Memory）

记忆功能让智能体在多轮对话中保持上下文：

记忆类型说明
对话历史自动保存最近 N 轮对话（默认 20 轮）
用户描述（User Memory）用户主动提供的个人信息
AI 总结（AI Memory）AI 自动总结的关键信息
知识库召回从关联知识库中动态检索

8.3 配置记忆

  1. 智能体编辑页面 → 「记忆」配置项
  2. 开启所需的记忆类型
  3. 设置记忆容量（轮数/token 上限）
  4. AI 会自动管理记忆，过期信息会被遗忘

9. AI 模型配置

9.1 模型选择策略

选择合适的模型需要考虑以下因素：

考虑维度建议
使用场景日常对话选豆包，技术场景选 DeepSeek
语言偏好中文场景优先千问/豆包，英文场景优先 GPT-4o
成本预算高频调用选低单价模型（如 MiniMax、DeepSeek）
质量要求高质量要求选 GPT-4o、豆包旗舰版

9.2 模型参数配置

参数说明建议值
Temperature创造性/确定性（0-1）0.7（平衡）
Max Tokens单次最大输出 token 数2048-4096
Top P采样多样度0.9（默认）

9.3 专业版大模型添加

Coze 专业版支持添加自定义大模型：

  1. 进入「扣子专业版」
  2. 找到「大模型设置」
  3. 添加新的模型渠道：
  4. 配置 API Key 和接口地址

💡 1 元即可体验新版本福利，赠送火山引擎算力。

10. 发布与渠道

10.1 一键发布

Coze 最大的优势之一就是一键发布到多个平台。支持的发布渠道：

渠道类型说明
豆包字节系抖音旗下 AI 助手
飞书办公协作企业/个人飞书机器人
微信公众平台社交微信公众号自动回复
微信客服客服微信客服接入
抖音社交抖音小程序/评论互动
Telegram国际社交Telegram Bot
Discord国际社区Discord Bot
Slack企业协作Slack App
钉钉办公协作钉钉机器人
企业微信办公协作企业微信应用
网站Web嵌入网页的 Widget

10.2 发布流程

  1. 完成智能体开发并通过调试
  2. 点击右上角「发布」按钮
  3. 选择目标发布渠道
  4. 按渠道要求完成授权（如微信公众号需扫码）
  5. 等待审核（如需）
  6. 发布成功，开始使用

10.3 渠道配置要点

飞书：

  • 需要在飞书开放平台创建应用

  • 配置机器人权限和事件订阅

  • 授权后即可在飞书中@机器人使用 微信公众号：

  • 需将 Coze 接入微信公众号后台

  • 自动回复设置在 Coze 中配置

  • 需公网可访问的回调地址 抖音/豆包：

  • 登录对应账号授权即可

  • 部分渠道需开发者认证

11. 扣子编程

11.1 什么是扣子编程

扣子编程是 Coze 在 2025-2026 年推出的重磅新功能，实现了从代码驱动到自然语言驱动的开发革新。无需专业编程基础，用户只需用自然语言描述需求，AI 即可自动编写代码，快速搭建完整的应用程序。

11.2 适用场景

  • 🖼️ 朋友圈金句卡片生成
  • 📊 数据可视化图表生成
  • 📝 自动生成文案/报告
  • 🔄 自动化数据处理工具
  • 🎨 图片处理与合成工具

11.3 使用方法

  1. 在 Coze 工作台找到「扣子编程」入口
  2. 点击「新建应用」
  3. 用自然语言描述你的需求，例如：
  4. “帮我做一个朋友圈金句卡片生成器，要有莫兰迪色渐变背景，优雅的字体排版，还要有水印”
  5. AI 自动生成完整代码和界面
  6. 预览效果，可进一步用自然语言调整
  7. 确认无误后发布

11.4 核心优势

  • 🚀 5 分钟从想法到成品：无需 IDE，无需配置环境
  • 🎨 所见即所得：实时预览，效果立等可取
  • 💬 自然语言迭代：不满意？继续用文字描述修改
  • 📱 一键发布：生成的应用可直接发布使用

12. OpenClaw 部署指南

12.1 什么是 OpenClaw

OpenClaw（小龙虾）是 Coze 平台上的一个 AI Agent，支持通过 Coze 云端部署，集成在飞书等平台中使用。

12.2 部署前提

  • ✅ Coze 个人高级版及以上版本（需付费）
  • ✅ 飞书账号（用于授权）
  • ⚠️ 每次运行会消耗算力积分

12.3 部署步骤

第一步：进入部署入口

  1. 打开 www.coze.cn，右上角「免费开始」登录
  2. 左侧菜单栏找到「扣子编程」，点击进入
  3. 在右侧窗口最上方找到「部署 OpenClaw」

第二步：创建小龙虾

  1. 点击「部署」按钮进入部署页面
  2. 目前 Coze 只支持：个人高级版、个人旗舰版、企业标准版及企业旗舰版
  3. 选择版本：
  4. 为小龙虾命名（点击笔头图标修改）
  5. 点击「确定」完成创建

第三步：飞书授权

  1. 点击右上角「齿轮图标」进入设置
  2. 找到飞书图标，点击「授权并创建」
  3. 登录飞书完成授权（等待约 2 分钟）
  4. 点击「去飞书对话」验证授权状态

第四步：开始使用

  1. 打开飞书，找到「开发者助手」
  2. 开始与小龙虾对话
  3. 每次对话会消耗算力积分，注意额度管理

12.4 常见问题

问题解决方案
部署失败检查网络连接，等待 1-2 分钟后重试
无法授权飞书确认飞书账号状态，重新扫码授权
算力积分不足在 Coze 平台充值或参与赠送活动
每个人只能创建一个如需重新部署，先删除现有实例

13. 常见问题与技巧

13.1 常见问题

Q：Coze 免费版有哪些限制？

免费版可创建基础智能体，但不能部署 OpenClaw，高级插件和知识库额度有限。

Q：如何提升智能体的回答质量？

  • 优化提示词（Prompt），结构越清晰效果越好

  • 关联知识库，提供专业背景信息

  • 添加合适的插件，扩展能力边界

  • 使用工作流处理复杂任务 Q：知识库检索不准确怎么办？

  • 调整分段策略，减小分段粒度

  • 提高召回数量，获取更多候选

  • 检查知识库数据质量，去除噪声

  • 尝试不同的相似度阈值 Q：工作流执行失败怎么排查？

  • 查看日志，找到失败的节点

  • 检查 API 配置（URL、参数、认证）

  • 确认节点输入数据格式正确

  • 逐步单步调试，定位问题节点 Q：如何管理算力积分？

  • 在 Coze 控制台查看使用明细

  • 选择「省流版」降低单次消耗

  • 参与官方赠送活动获取积分

13.2 使用技巧

  1. 提示词优化：用 # 角色、## 技能、## 限制 等结构化格式，AI 理解效果更好
  2. 插件组合：将多个相关插件组合使用，发挥「1+1>2」的效果
  3. 知识库 + 工作流：先用知识库检索，再用工作流处理数据，效率翻倍
  4. 善用开场白：配置合理的开场白和用户问题建议，降低使用门槛
  5. 版本管理：发布前做好版本记录，方便回退
  6. 复用模板：Coze 模板市场有大量优质模板，可直接复用或作为参考

14. 附录

14.1 快捷入口

资源链接
国内版 Cozehttps://www.coze.cn
国际版 Cozehttps://coze.com
Coze 模板市场https://www.coze.cn/marketplace

关系图谱