七千二百袋水泥
七千二百袋水泥
Published on 2025-09-21 / 1 Visits

CozeStudio开源版详细部署指南:手把手教你在NAS上搭建本地AI Agent开发环境

Coze Studio 是一款集成化的一站式 AI Agent 开发平台,其核心引擎现已完全开源。它不仅提供多种最新大语言模型与工具,还支持多样化的开发模式与框架,为开发者打造从开发到部署的全流程 AI Agent 高效开发体验。


功能概览

Coze Studio 提供以下核心功能模块:

模块名称功能描述
模型服务支持管理模型列表,可接入 OpenAI、火山方舟等多种在线或离线模型服务
智能体搭建支持编排、发布与管理智能体,可配置工作流与知识库等资源
应用搭建支持创建与发布应用,并通过工作流实现业务逻辑搭建
工作流搭建提供工作流的创建、修改、发布与删除功能
开发资源支持插件、知识库、数据库、提示词等资源的创建与管理
API 与 SDK提供 OpenAPI 支持创建会话与发起对话,可通过 Chat SDK 将智能体或应用集成至自有系统

Image


系统环境要求

在安装 Coze Studio 前,请确保您的设备满足如下最低配置:

  • CPU:2 核心及以上
  • 内存:4 GB 及以上
  • 需提前安装并启动 Docker 及 Docker Compose

准备工作:获取火山方舟API密钥

本教程以接入豆包模型为例,演示如何获取火山引擎的 API Key。如使用其他平台模型,可跳过本部分并按实际需求操作。

首先访问火山引擎控制台并登录账号(支持手机号注册):
https://console.volcengine.com/

Image

在左侧导航栏中找到「火山方舟」服务入口:

Image

进入「API Key 管理」,创建一个新的密钥:

Image

设置密钥名称(可自定义),完成创建:

Image

记录生成的 API Key,后续配置中将用到:

Image

接下来创建模型推理接入点:

Image

填写接入点名称,选择模型(如 Doubao-Seed-1.6,后续可调整):

Image

完成实名认证(按页面提示填写相关信息):

Image

点击开通接入:

Image

设置完成后可进行对话测试,验证接入是否正常:

Image

调用成功后会显示完整模型名称,例如:doubao-seed-1-6-250615

Image


安装部署步骤

本教程以飞牛系统为例演示安装流程,其它 NAS 系统操作类似。

首先访问 Coze Studio 项目地址下载源码:
https://github.com/coze-dev/coze-studio

Image

解压下载的ZIP压缩包(建议在电脑端操作,便于后续修改):

Image

进入模型模板配置目录:backend/conf/model/template

Image

提示
Coze Studio 支持多种模型的API调用,包括火山方舟(ark)、Claude、DeepSeek、Gemini、Ollama、OpenAI、通义千问(qwen)等。如需完全本地运行,需自行部署相应模型平台。

从模板目录复制所需模型的配置文件,粘贴至配置目录:

Image

编辑模板文件,如配置多个模型需确保ID不重复:

Image

查找 conn_config 部分,通常需填写 api_keymodel 参数。如调用第三方平台,还需修改 base_url

Image

示例:调用 ark_doubao-seed-1.6 模型的配置模板

Image

示例:调用 ollama 模型的配置模板

Image

进入 Docker 配置目录,复制 .env.example 文件并重命名为 .env

Image

提示
项目会占用多个端口,如遇冲突可自行修改配置文件(建议先暂停其它应用,体验后再调整)。

Image

创建 coze-studio 文件夹,将所有文件上传至 NAS:

Image

提示
仅上传文件无法完成部署,还需通过 SSH 连接并执行构建命令。

Image

使用 SSH 工具连接 NAS,执行以下命令构建项目:

sudo -i  
cd /vol1/1000/docker/coze-studio/docker  
docker compose --project-name coze-studio --profile "*" up -d

Image

返回 Docker 管理界面,可查看已创建的项目(支持后续启动/停止管理):

Image

提示
服务启动后,coze-minio-setupcoze-mysql-setup-init-sqlcoze-mysql-setup-schema 等容器显示为退出状态(exit 0)属正常现象。

Image


使用教程

在浏览器中输入 http://NAS的IP:8888 访问 Coze Studio 界面:

Image

首先注册一个新账号:

Image

成功登录后进入主面板:

Image

创建一个智能体,测试模型API是否正常调用:

Image

按提示填写基本信息:

Image

可看到之前配置的两个平台服务均已就绪:

Image

测试模型调用,响应正常:

Image

工作流功能也支持正常使用:

Image

资源库支持上传文档作为知识库使用:

Image

探索页面提供多种 MCP 插件:

Image

内置模板目前数量较少:

Image

部分模板设计颇具趣味,例如调用先前配置的 Doubao-Seed-1.6 模型:

Image


总结与体验

笔者此前较多使用 Dify,对 Coze 也有一定了解,但因之前不支持本地部署,未能将其作为主力工具。如今开源版发布,第一时间在NAS上进行了部署体验。Coze Studio 整体操作流畅,响应迅速,上手门槛较低。但目前提供的插件与模板数量较少(官方在线版本更为丰富),甚至缺少网页搜索等基础插件,期待后续版本能持续优化。

综合推荐指数:⭐⭐⭐⭐(国内较有影响力的开源项目)
用户体验评价:⭐⭐⭐⭐(响应速度快,操作简便)
部署难度评级:⭐⭐⭐(中等难度)