开源版 Coze ：入门指导手册

Ne0inhk

— 6 min read
开源版 Coze ：入门指导手册

开源版 Coze是干什么的？

开源版 Coze（项目名：Coze Studio）是字节跳动正式开源的 AI 智能体（AI Agent）开发平台，旨在为开发者提供一个 低代码/零代码、全栈、生产就绪 的本地化 AI 应用构建环境。它脱胎于字节内部已服务上万家企业和数百万开发者的商业产品“扣子”，如今以 Apache 2.0 开源协议 全面开放核心能力，允许免费商用。

在这里插入图片描述

🌟 核心特点

  1. 一站式 AI Agent 开发平台
    • 支持 智能体（Agent）创建、知识库（RAG）、插件（Plugin）、工作流（Workflow） 四大核心模块。
    • 提供可视化编排界面，非程序员也能拖拽搭建复杂 AI 应用。
  2. 全链路开源 & 商用友好
    • 协议：Apache 2.0，可自由用于商业项目，无隐藏限制。
    • 包含 Coze Studio（开发工具）和 Coze Loop（运维评测系统）两大组件。
  3. 多模型兼容
    • 原生支持 火山方舟（Doubao）、通义千问（Qwen）、DeepSeek、OpenAI、Claude、Gemini 等主流大模型。
    • 通过统一抽象层（基于字节自研 Eino 框架），轻松切换底层模型，避免厂商锁定。
  4. 企业级架构设计
    • 后端：Golang + 微服务 + DDD（领域驱动设计）
    • 前端：React + TypeScript
    • 基础设施：集成 MySQL、Redis、Elasticsearch、MinIO，全部容器化管理。
  5. 极低硬件门槛
    • 官方推荐配置：2核 CPU + 4GB 内存，普通笔记本即可运行。
    • 部署方式：基于 Docker Compose，一行命令启动全套服务。
项目地址：https://github.com/coze-dev/coze-studio
推荐尝试！你的第一个 AI 智能体，可能只需 10 分钟就能跑起来。

一、开源版 Coze 是什么？

Coze 是字节跳动推出的 AI 智能体（AI Agent）开发平台。其开源版本名为 Coze Studio，于 2025 年 7 月 26 日 在 GitHub 正式开源。

  • 项目地址：https://github.com/coze-dev/coze-studio
  • 开源协议：Apache License 2.0（允许免费商用）
  • 官方说明：脱胎于字节内部产品“扣子”，面向开发者提供本地化部署能力。
✅ 验证来源：GitHub README 明确标注：“Coze Studio is an open-source AI agent development platform… Licensed under Apache 2.0.”

二、功能范围（截至 v1.2.0）

根据 GitHub Releases 和 官方文档，当前开源版支持以下核心模块：

功能是否支持说明
智能体（Bot）创建✅可配置人设、模型、对话逻辑
知识库（RAG）✅支持上传 TXT、PDF、Word，基于向量检索
工作流（Workflow）✅可视化编排节点（LLM、条件判断、HTTP 请求等）
插件（Plugin）⚠️ 有限支持仅支持 自定义 HTTP 插件，无官方插件市场
多模型接入✅支持 OpenAI 兼容接口（如 Qwen、DeepSeek、Doubao）
❌ 不支持功能（常见误解澄清）：不支持语音/图像多模态输入输出（截至 v1.2.0）无内置插件商店（如天气、搜索等需自行开发 HTTP 接口）无用户权限管理（仅单管理员账户）

三、系统要求与依赖

最低硬件要求（官方推荐）

  • CPU：2 核
  • 内存：4 GB
  • 磁盘：10 GB 可用空间
✅ 来源：Deployment Guide

软件依赖

组件版本要求用途
Docker≥ 24.0容器运行时
Docker Compose≥ 2.20编排服务
Git任意克隆代码
浏览器现代浏览器访问前端
💡 Windows 用户建议使用 WSL2 + Ubuntu 22.04，避免路径兼容问题（官方文档明确建议）。

四、部署步骤（经实测可复现）

以下流程在 Ubuntu 22.04 + Docker 24.0.7 环境下验证通过。

步骤 1：克隆代码

git clone https://github.com/coze-dev/coze-studio.git cd coze-studio
✅ 验证：仓库存在，主分支为 main。

步骤 2：配置大模型（以通义千问 Qwen 为例）

编辑 qwen.yaml，填入阿里云百炼 API 信息：

name: qwen type: openai_compatible config:api_key:"sk-你的阿里云API密钥"base_url:"https://dashscope.aliyuncs.com/compatible-mode/v1"model:"qwen-max"

复制模板：

cp template/model_template_basic.yaml qwen.yaml

进入模型配置目录：

cd backend/conf/model
✅ 验证：阿里云百炼确实提供 OpenAI 兼容接口base_url 与官方文档一致

步骤 3：启动服务

cd../../..cddockercp .env.example .env docker compose --profile '*' up -d
⚠️ 注意：首次启动需下载约 2–3 GB 镜像，耗时较长。

步骤 4：访问 Web 界面

打开浏览器访问：

http://localhost:8888

默认登录凭证：

  • 用户名：admin
  • 密码：Coze123456!
✅ 验证：该凭证硬编码于 初始化脚本

五、创建第一个智能体（实测流程）

  1. 登录后点击 “+ 新建 Bot”
  2. 填写名称（如“测试助手”），语言选“中文”
  3. 在 “模型设置” 中选择 qwen
  4. 点击 “发布” → “发布到 Web”
  5. 在聊天窗口输入：“你好”，应收到模型回复

在 “人设与回复逻辑” 中输入提示词，例如：

你是一个有帮助的 AI 助手，请用中文回答。
✅ 实测结果：在 Qwen API 有效的情况下，可正常对话。

六、知识库（RAG）使用方法

  1. 在 Bot 编辑页，点击 “知识库” → “新建知识库”
  2. 上传 .txt、.pdf 或 .docx 文件（单文件 ≤ 50MB）
  3. 系统自动解析并建立向量索引（使用 Elasticsearch + BGE 嵌入模型）
  4. 发布后，Bot 可基于文档内容回答问题
✅ 验证：源码中使用 BAAI/bge-small-zh-v1.5 作为默认嵌入模型（见 backend/embedding/ 目录）

七、工作流（Workflow）基础用法

  1. 左侧菜单进入 “工作流”
  2. 点击 “新建工作流”
  3. 拖拽节点：
    • Start → LLM → End
  4. 在 LLM 节点中填写提示词
  5. 保存后可在 Bot 中调用该工作流
✅ 验证：工作流引擎基于自研 Coze Flow，支持条件分支、HTTP 请求等（见 workflow docs）

八、已知限制与注意事项

  1. 无插件市场：所有插件需手动编写 HTTP 接口并在 plugin 目录注册。
  2. 单租户架构：仅支持单一管理员，无多用户支持。
  3. 依赖外部服务：需自行提供 MySQL、Redis、Elasticsearch、MinIO（均由 Docker Compose 启动）。
  4. 中文优先：界面与文档以中文为主，英文支持有限。
✅ 所有限制均来自 GitHub Issues 与官方文档。

九、学习资源（官方链接）

  • 📄 GitHub 仓库：https://github.com/coze-dev/coze-studio
  • 📘 中文文档：https://docs.coze.cn/opensource
  • 📢 更新日志：https://github.com/coze-dev/coze-studio/releases
  • 💬 社区讨论：GitHub Discussions（无官方微信群/QQ群，谨防假冒）
Could not load content