coze-studio 是什么?

Coze Studio 是 coze-dev 开源的可视化 Agent 开发平台,可在一个界面中配置模型、提示词、RAG 知识库、插件、数据库、Agent、应用和工作流,并通过 OpenAPI 或 Chat SDK 接入业务系统。社区版后端是 Go,前端是 React + TypeScript。

⭐ 20,411 Stars 🍴 2,944 Forks TypeScript Apache-2.0 作者: coze-dev
来源:github.com/coze-dev/coze-studio 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

项目当前 Docker 镜像已到 0.5.1,README 还明确补充了公网部署风险、模型配置前置条件和开源版/商业版差异;旧页面缺少这些决定是否能上线的内容。

来源:github.com/coze-dev/coze-studio/releases/tag/v0.5.1

核心功能

可视化 Agent 与工作流

在画布中建立 Agent、应用和 workflow,把模型、插件、知识库、数据库和提示词组织成可发布资源。

来源:github.com/coze-dev/coze-studio
多模型配置

管理员在模型管理页添加模型服务;官方示例环境变量覆盖 OpenAI、Ark、DeepSeek、Ollama、Qwen 和 Gemini 等协议。

来源:github.com/coze-dev/coze-studio/wiki/3.-Model-configuration
知识库与检索组件

Docker Compose 默认编排 Elasticsearch、Milvus、MinIO、etcd 等组件,为文档存储、索引和向量检索提供底座。

来源:github.com/coze-dev/coze-studio/blob/main/docker/docker-compose.yml
API 与 Chat SDK

社区版提供对话和 workflow API,使用 Personal Access Token 认证,也可将应用接入本地业务系统。

来源:github.com/coze-dev/coze-studio/wiki/6.-API-Reference

技术架构

前端 React/TypeScript 通过 Go 后端管理 Agent、workflow 与资源,代码按微服务和 DDD 组织。默认 Compose 同时启动 MySQL、Redis、Elasticsearch、MinIO、Milvus、etcd、NSQ、coze-server 与 coze-web;模型调用与 embedding/rerank/OCR 等能力再按 .env 指向外部或本地服务。

来源:github.com/coze-dev/coze-studio/blob/main/docker/docker-compose.yml

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 至少 2 核 CPU、4 GB 内存至少 2 核 CPU、… Docker 与 Docker ComposeDocker 与 Dock… Git LFS 拉取仓库资源Git LFS 拉取仓… 至少一个可用模型服务及其凭证至少一个可用模型… 生产环境需要自管数据库、检索、对象存储与消息组件生产环境需要自管… 可视化 Agent 与工作流 多模型配置 知识库与检索组件 API 与 Chat SDK coze-studio 项目本体 核心功能 关键依赖

技术栈

语言Go 后端 + React/TypeScript 前端框架微服务、DDD、Eino agent/workflow runtime、FlowGram workflow canvas
至少 2 核 CPU、4 GB 内存Docker 与 Docker ComposeGit LFS 拉取仓库资源至少一个可用模型服务及其凭证生产环境需要自管数据库、检索、对象存储与消息组件
默认 Compose 包含 MySQL、Redis、Elasticsearch、MinIO、Milvus、etcd 和 NSQ;网页默认监听 8888
来源:github.com/coze-dev/coze-studio

快速上手

安装 Git LFS、Docker 和 Compose 后克隆官方仓库,复制 docker/.env.example 为 docker/.env,再从仓库根目录启动 docker compose -f ./docker/docker-compose.yml up。浏览器打开 http://localhost:8888/sign 注册本地账号,然后在 /admin/#model-management 添加模型。先保持本机访问,跑通一条不含代码节点的最小 workflow。
来源:github.com/coze-dev/coze-studio

使用场景

适合需要自托管可视化 Agent、知识库问答、插件与工作流的团队,也可作为二次开发底座。公开服务之前,要先关闭或限制注册、隔离 Python 代码节点、收紧服务监听地址、验证 API 鉴权与水平越权,并为模型调用、向量库和对象存储准备监控与备份。

来源:github.com/coze-dev/coze-studio

优势与局限

优势

  • Agent、应用、workflow、知识库和插件在同一管理界面
  • 社区版采用 Apache-2.0
  • Docker Compose 给出完整的本地依赖编排
  • OpenAPI 与 Chat SDK 便于接入现有产品

局限

  • 官方最低 2 核 4 GB 只代表启动门槛,完整 Compose 的生产资源和运维成本明显更高
  • 没有模型服务配置就不能在 Agent、workflow 和应用中选择模型
  • README 明示公网风险包括开放注册、Python 执行、监听地址、SSRF 和部分 API 水平越权
  • 部分功能仅商业版提供,开源版不能照搬商业平台文档中的所有能力
来源:github.com/coze-dev/coze-studio

最新版本

官方最新 release 是 v0.5.1,发布于 2026-02-05,对应 cozedev/coze-studio-server:0.5.1 和 cozedev/coze-studio-web:0.5.1。该版本包含模型与 embedding 配置优化、非流式 chat API、conversation isolation 以及 API 水平越权修复。

来源:github.com/coze-dev/coze-studio/releases/tag/v0.5.1

实测与证据

status: docs-only  |  checked_at: 2026-09-23  |  environment: 核对官方 README、Docker Compose、环境变量示例、Wiki 链接、Apache-2.0 LICENSE 与 v0.5.1 release  |  limitations: 未拉取镜像、启动 Compose、注册账号或配置模型;未做 SSRF、代码节点、鉴权、资源占用和升级测试  |  observed_output: 最新 release 为 v0.5.1,发布页列出 server/web 0.5.1 镜像,并包含 API 水平越权修复

来源:github.com/coze-dev/coze-studio/releases/tag/v0.5.1

同类项目对比

Dify 同样提供 LLM 应用、agent workflow 和 RAG pipeline,并有 Docker 自托管路径;Coze Studio 的官方材料更强调 Coze 风格的 Agent/应用/资源一体化画布以及 Eino、FlowGram 底座。选择时不要只看界面:用同一模型做一条含知识检索、人工审批和 API 发布的流程,对比插件生态、导出能力、权限隔离与升级成本。

来源:github.com/langgenius/dify

总结评价

Coze Studio 适合愿意承担完整平台运维的团队。先在内网用固定镜像跑通模型配置、知识库和一条最小 workflow,再逐项处理注册、代码执行、SSRF、鉴权和数据备份;只想做一个简单聊天页时,这套依赖会偏重。

来源:github.com/coze-dev/coze-studio

常见问题

Coze Studio 启动后为什么还不能创建可运行的 Agent?

社区版不会自带可调用模型。注册本地账号后,还要在模型管理页添加模型服务。

2 核 4 GB 足够把 Coze Studio 放到生产环境吗?

这是官方最低安装门槛,不是生产容量建议。默认 Compose 还有数据库、搜索、向量库、对象存储和消息组件,应按并发与数据量压测。

可以把 8888 端口直接暴露到公网吗?

不建议。官方列出的风险包括开放注册、Python 执行、SSRF、监听地址和部分 API 水平越权,应先做访问控制、网络隔离和安全测试。

Coze 商业平台的功能都在开源版里吗?

不是。官方明确说部分能力仅商业版提供,例如 tone customization;应对照社区版 feature list。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件