0.前言
字节跳动的AI产品豆包,由于其功能齐全并且性能也不错,在互联网AI行业一直广受用户的喜爱,然而由于豆包并未开源,无法本地部署,而当今互联网行业又极其重视数据安全,所以很多企业不得不选择Dify这种开源AI产品。终于,字节开源了豆包的核心产品coze-studio,coze-studio一经开源立马引起了各界人士的广泛关注,github上的star数也是快速增长,那么今天我们就来部署一下coze-studio,并且简单的使用一下coze-studio。
1.coze开源版简介
在部署之前,稍微先了解一下什么事coze Studio。
1.1 开源目标
Coze Studio,源自服务了上万家企业、数百万开发者的「扣子开发平台」,我们将它的核心引擎完全开放。它是一个一站式的 AI Agent 可视化开发工具,让 AI Agent 的创建、调试和部署变得前所未有的简单。通过 Coze Studio 提供的可视化设计与编排工具,开发者可以通过零代码或低代码的方式,快速打造和调试智能体、应用和工作流,实现强大的 AI 应用开发和更多定制化业务逻辑,是构建低代码 AI 产品的理想选择。Coze Studio 致力于降低 AI Agent 开发与应用门槛,鼓励社区共建和分享交流,助你在 AI 领域进行更深层次的探索与实践。
1.2 技术选型
Coze Studio 的后端采用 Golang 开发,前端使用 React + TypeScript,整体基于微服务架构并遵循领域驱动设计(DDD)原则构建。为开发者提供一个高性能、高扩展性、易于二次开发的底层框架,助力开发者应对复杂的业务需求。
1.3 功能清单
功能模块 | 功能点 |
---|---|
模型服务 | 管理模型列表,可接入OpenAI、火山方舟 等在线或离线模型服务 |
搭建智能体 | * 编排、发布、管理智能体 * 支持配置工作流、知识库等资源 |
搭建应用 | * 创建、发布应用 * 通过工作流搭建业务逻辑 |
搭建工作流 | 创建、修改、发布、删除工作流 |
开发资源 | 支持创建并管理以下资源: * 插件 * 知识库 * 数据库 * 提示词 |
API 与 SDK | * 创建会话、发起对话等 OpenAPI * 通过 Chat SDK 将智能体或应用集成到自己的应用 |
2.环境准备
2.1 服务器资源
操作系统 | IP地址 | CPU | 内存 |
---|---|---|---|
rocky8 linux | 10.173.100.10 | 8核 | 16G |
大家可以根据自己的需要选择操作系统和虚拟机配置,但官方要求至少是2核4G以上。
2.2 环境依赖
本次部署采用docker容器的方式,需要在虚拟机上安装好docker和docker-compose。
名称 | 版本号 |
---|---|
docker | 26.1.4 |
docker-compose | v2.30.1 |
3.部署coze Studio
环境准备好之后,就可以开始着手部署coze Studio了。
3.1 拉取源码
我们可以在服务器上创建一个存放coze Studio代码的目录,然后将代码拉取到服务器上,命令如下:
mkdir /root/project
cd /root/project
git clone https://github.com/coze-dev/coze-studio.git
3.2 修改配置文件
coze Studio在启动服务之前,需要将整合进coze Studio的大模型配置文件准备好,本次我们使用Doubao-Seed-1.6大模型。
(1)拷贝模板文件,命令如下:
cd /root/project/coze-studio
cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml
(2)修改ark_doubao-seed-1.6.yaml文件
为了能够访问火山方舟管理的Doubao-Seed-1.6大模型,需要在配置文件中配置api_key和model:
获取api_key的方式可以参考:获取 API Key 并配置;
获取model ID的方式可以参考:获取 Endpoint ID;
获取之后,将其填写在如下位置即可:
vim backend/conf/model/ark_doubao-seed-1.6.yaml
.......
conn_config:
base_url: ""
api_key: "xxxxxxxxxxxxxxx" // 这里是api_key
timeout: 0s
model: "xxxxxxxxxxxx" // 这里是model ID
.......
3.3 运行容器
配置文件填写完成之后就可以运行容器了,命令如下:
cd /root/project/coze-studio/docker
cp .env.example .env
docker compose --profile "*" up -d
[+] Running 14/14
✔ Network docker_coze-network Created 0.0s
✔ Container coze-nsqlookupd Healthy 5.9s
✔ Container coze-etcd Healthy 5.9s
✔ Container coze-elasticsearch Healthy 32.1s
✔ Container coze-minio Healthy 32.1s
✔ Container coze-mysql Healthy 32.1s
✔ Container coze-nsqadmin Started 6.0s
✔ Container coze-nsqd Started 6.0s
✔ Container coze-mysql-setup-init-sql Exited 32.1s
✔ Container coze-minio-setup Exited 32.1s
✔ Container coze-milvus Healthy 36.1s
✔ Container coze-mysql-setup-schema Exited 31.5s
✔ Container coze-redis Healthy 37.0s
✔ Container coze-server Started 37.2s
该命令会基于该目录下的docker-compose.yml文件,启动服务需要的容器,整个启动过程比较长,需要耐心等待一下。
3.4 检查运行情况
通过如下命令可以检查容器的运行情况:
cd /root/project/coze-studio/docker
docker compose ps -a
coze-elasticsearch bitnami/elasticsearch:8.18.0 "/opt/bitnami/script…" elasticsearch 4 minutes ago Up 3 minutes (healthy) 0.0.0.0:9200->9200/tcp, :::9200->9200/tcp, 9300/tcp
coze-etcd bitnami/etcd:3.5 "/opt/bitnami/script…" etcd 4 minutes ago Up 3 minutes (healthy) 0.0.0.0:2379-2380->2379-2380/tcp, :::2379-2380->2379-2380/tcp
coze-milvus milvusdb/milvus:v2.5.10 "/tini -- bash -c '\n…" milvus 4 minutes ago Up 3 minutes (healthy) 0.0.0.0:9091->9091/tcp, :::9091->9091/tcp, 0.0.0.0:19530->19530/tcp, :::19530->19530/tcp
coze-minio minio/minio:RELEASE.2025-06-13T11-33-47Z-cpuv1 "/usr/bin/docker-ent…" minio 4 minutes ago Up 3 minutes (healthy) 0.0.0.0:9000-9001->9000-9001/tcp, :::9000-9001->9000-9001/tcp
coze-minio-setup minio/mc:RELEASE.2025-05-21T01-59-54Z-cpuv1 "/bin/sh -c '\n (/us…" minio-setup 4 minutes ago Exited (0) 3 minutes ago
coze-mysql mysql:8.4.5 "docker-entrypoint.s…" mysql 4 minutes ago Up 3 minutes (healthy) 0.0.0.0:3306->3306/tcp, :::3306->3306/tcp, 33060/tcp
coze-mysql-setup-init-sql mysql:8.4.5 "docker-entrypoint.s…" mysql-setup-init-sql 4 minutes ago Exited (0) 3 minutes ago
coze-mysql-setup-schema arigaio/atlas:0.35.0-community-alpine "/bin/sh -c 'set -ex…" mysql-setup-schema 4 minutes ago Exited (0) 3 minutes ago
coze-nsqadmin nsqio/nsq:v1.2.1 "/nsqadmin --lookupd…" nsqadmin 4 minutes ago Up 3 minutes 4150-4151/tcp, 4160-4161/tcp, 4170/tcp, 0.0.0.0:4171->4171/tcp, :::4171->4171/tcp
coze-nsqd nsqio/nsq:v1.2.1 "/nsqd --lookupd-tcp…" nsqd 4 minutes ago Up 3 minutes (healthy) 4160-4161/tcp, 0.0.0.0:4150-4151->4150-4151/tcp, :::4150-4151->4150-4151/tcp, 4170-4171/tcp
coze-nsqlookupd nsqio/nsq:v1.2.1 "/nsqlookupd" nsqlookupd 4 minutes ago Up 3 minutes (healthy) 4150-4151/tcp, 4170-4171/tcp, 0.0.0.0:4160-4161->4160-4161/tcp, :::4160-4161->4160-4161/tcp
coze-redis bitnami/redis:8.0 "/opt/bitnami/script…" redis 4 minutes ago Up 3 minutes (healthy) 0.0.0.0:6379->6379/tcp, :::6379->6379/tcp
coze-server opencoze/opencoze:latest "/app/bootstrap.sh" coze-server 4 minutes ago Up 3 minutes 0.0.0.0:8888-8889->8888-8889/tcp, :::8888-8889->8888-8889/tcp
可以看到coze-minio-setup、coze-mysql-setup-init-sql、coze-mysql-setup-schema是Exit状态,这个是正常的。
4.coze Studio使用
coze Studio正常部署之后,就可以正常使用了。
4.1 访问coze Studio
默认情况下,coze Studio的访问地址是:http://serverIP:8888(http://10.173.100.10:8888)
在浏览器输入以上URL,出现如下界面:
因为是首次登录,输入邮箱账号和密码,然后点击注册就可以进入到coze Studio首页了,如下图所示:
之后就可以在coze Studio完成一些其他的操作了。
4.2 创建智能体
进入coze Studio首页之后,点击右上角【创建】按钮,之后在智能体选项点击【创建】按钮,即可创建智能体,如下图所示:
智能体创建流程如下图所示:
输出智能体名称,还可以根据需要输入智能体功能介绍或者修改下图标,之后点击【确认】按钮,出现调试页面,如下图所示:
可以随便问智能体几个问题,如果可以正常响应,说明coze Studio可以正常工作,之后点击【发布】按钮即可。
5.总结
今天带大家部署了了coze Studio开源版,整个部署过程还是很简单的,稍微有点困难的地方在如何在国内拉取coze Studio使用的镜像以及配置大模型,整个coze Studio界面简单,用起来也比较丝滑,由于刚刚开源,功能还比较少,但构建智能体和智能应用并通过API给外部调用已经足够了,期待后面开源更多的功能。