> 技术文档 > Coze:Window操作系统部署Coze Studio

Coze:Window操作系统部署Coze Studio

       Coze Studio,源自服务了上万家企业、数百万开发者的「扣子开发平台」,我们将它的核心引擎完全开放。它是一个一站式的 AI Agent 可视化开发工具,让 AI Agent 的创建、调试和部署变得前所未有的简单。通过 Coze Studio 提供的可视化设计与编排工具,开发者可以通过零代码或低代码的方式,快速打造和调试智能体、应用和工作流,实现强大的 AI 应用开发和更多定制化业务逻辑,是构建低代码 AI 产品的理想选择。Coze Studio 致力于降低 AI Agent 开发与应用门槛,鼓励社区共建和分享交流,助你在 AI 领域进行更深层次的探索与实践。

一、Coze Studio 支持的模型服务如下

  • Ark(火山方舟)
  • OpenAI
  • DeepSeek
  • Claude
  • Ollama
  • Qwen
  • Gemini

二、克隆代码

git clone https://github.com/coze-dev/coze-studio.git

三、配置Qwen模型

从模板目录复制Qwen 模型的模版文件,并粘贴到配置文件目录。

cd coze-studio

# 复制模型配置模版

copy backend\\conf\\model\\template\\model_template_qwen.yaml backend\\conf\\model\\qwen.yaml

在配置文件目录下,修改模版文件。

进入目录 backend/conf/model。打开复制后的文件qwen.yaml。

设置 id、meta.conn_config.api_key、meta.conn_config.model 字段,并保存文件。

id:Coze Studio 中的模型 ID,由开发者自行定义,必须是非 0 的整数,且全局唯一。模型上线后请勿修改模型 id 。

meta.conn_config.api_key:模型服务的 API Key

meta.conn_config.model:模型服务的 model ID。

 

 ​​​​​​​四、配置本地嵌入模型

cd docker

copy .env.example .env

vi .env

​​​​​​​五、启动服务

cd docker

docker compose --profile \"*\" up -d

✅ --profile \'*\'

作用:启用指定的 profiles。

\'*\' 是一个通配符,表示启用所有定义在 docker-compose.yml 中的 profiles。

在 Compose 文件中,某些服务可能被分配了 profile(例如 middleware, frontend, backend 等),只有匹配 profile 的服务才会被启动。

使用 --profile \'*\' 意味着:不管服务属于哪个 profile,都包含在本次操作中。

✅  up

启动服务。

如果容器不存在,则创建并启动;

如果容器已存在,则重新启动它(除非有其他选项控制行为)。

✅  -d

Detached mode:后台运行容器(不把日志输出到当前终端)。

类似于 nohup 或 &,让服务在后台运行。

服务启动之后,coze-elasticsearch-setup、coze-minio-setup、coze-mysql-setup-init-sql、coze-mysql-setup-schema 这几个容器处于退出状态(exit 0),是正常现象。启动失败常见问题可参考常见问题。

部署并启动服务。 首次部署并启动 Coze Studio 需要拉取镜像、构建本地镜像,可能耗时较久,请耐心等待。部署过程中,你会看到以下日志信息。如果看到提示 \"Container coze-server Started\",表示 Coze Studio 服务已成功启动。

 ​​​​​​​六、访问

 通过浏览器访问 http://localhost:8888/ 即可打开 Coze Studio。