一、扣子开源了

字节跳动的扣子（coze）正式开源了。**开源地址：**https://github.com/coze-dev

其中两个比较重要的仓库：

• Coze Studio 一站式 AI Agent 开发工具：https://github.com/coze-dev/coze-studio
• Coze Loop 一个面向开发者，专注于 AI Agent 开发与运维的平台级解决方案：https://github.com/coze-dev/cozeloop

此次扣子的开源动作堪称“全盘托出”。两大核心组件均以Apache 2.0协议开放，允许免费商用，打破过往封闭生态的商业模。

1.1 扣子是啥？

扣子是字节跳动旗下的AI大模型智能体开发平台。根据官网描述，用户可以借助扣子提供的可视化设计与编排工具，通过零代码或低代码的方式，快速搭建出基于大模型的各类 AI 项目，比如智能体和应用。

智能体是基于对话的 AI 项目，它通过对话方式接收用户的输入，由大模型自动调用插件或工作流等方式执行用户指定的业务流程，并生成最终的回复。智能客服、虚拟伴侣、个人助理、英语外教都是智能体的典型应用场景。

应用是指利用大模型技术开发的应用程序。扣子中搭建的应用具备完整业务逻辑和可视化用户界面，是一个独立的 AI 项目。通过扣子开发的应用有明确的输入和输出，可以根据既定的业务逻辑和流程完成一系列简单或复杂的任务，例如 AI 搜索、翻译工具、饮食记录等。

与字节扣子同类的国内外产品还有：

• 阿里百炼
• 腾讯元器
• 百度千帆AppBuilder、文心AgentBuilder
• Dify.ai
• n8n.io

1.2 为啥开源 ？

开源扣子实则是字节构建AI Agent生态的基础设施投资。4月推出的扣子空间（Coze Space）已显露战略意图：它定位为“与AI Agent协同办公的最佳场所”，通过MCP协议整合工具链，将AI从辅助工具升级为执行主体。

此次开源的深层逻辑简单分析就是：

• 上层生态：通过扣子空间聚合MCP扩展，打造通用Agent平台
• 底层设施：开源Coze Studio/Loop建立开发标准，吸引生态开发者

这种“应用层封闭，基础层开放”的策略，与谷歌Android模式异曲同工。当开发者利用开源工具构建的Agent，最终可能通过扣子空间连接飞书等字节系产品，形成生态闭环。在OpenAI Operator、Anthropic Claude Workflows相继推出后，全球AI Agent开发标准尚未固化。此时开源，也是为参与后续AI Agent开发生态的定义权。

1.3 与我们有什么关系？

企业价值

1. 安全合规：敏感数据不出域，满足GDPR/等保要求，规避泄露风险。
2. 深度定制：基于私有数据微调，适配行业术语与业务流程，提升准确性。
3. 资产沉淀：模型、数据、经验转化为数字资产，构建技术壁垒。
4. 业务连续：自主运维保障服务稳定，规避第三方依赖风险。

个人价值

1. 隐私主权：敏感数据（健康/财务）本地处理，杜绝云端泄露。
2. 专属智能：定制个性化AI助手，融合私密知识库（如笔记/创作集）。
3. 技术自治：掌握模型优化全链路，无审查探索敏感话题。
4. 创新自由：零限制修改模型代码，试错开发个人AI应用。

二、本地私有化部署Coze Studio

2.1 什么是 Coze Studio

Coze Studio 是一站式 AI Agent 开发工具。提供各类最新大模型和工具、多种开发模式和框架，从开发到部署，为你提供最便捷的 AI Agent 开发环境。上万家企业、数百万开发者正在使 Coze Studio。

• 提供 AI Agent 开发所需的全部核心技术：Prompt、RAG、Plugin、Workflow，使得开发者可以聚焦创造 AI 核心价值。
• 开箱即用，用最低的成本开发最专业的 AI Agent：Coze Studio 为开发者提供了健全的应用模板和编排框架，你可以基于它们快速构建各种 AI Agent ，将创意变为现实。

Coze Studio 是字节跳动新一代 AI Agent 开发平台扣子（Coze）的开源版本。通过 Coze Studio 提供的可视化设计与编排工具，开发者可以通过零代码或低代码的方式，快速打造和调试智能体、应用和工作流，实现强大的 AI 应用开发和更多定制化业务逻辑，是构建低代码 AI 产品的理想选择。Coze Studio 致力于降低 AI Agent 开发与应用门槛，鼓励社区共建和分享交流，助你在 AI 领域进行更深层次的探索与实践。

Coze Studio 的后端采用 Golang 开发，前端使用 React + TypeScript，整体基于微服务架构并遵循领域驱动设计（DDD）原则构建。为开发者提供一个高性能、高扩展性、易于二次开发的底层框架，助力开发者应对复杂的业务需求。

2.2 Coze Studio功能清单

功能模块	功能点
模型服务	管理模型列表，可接入OpenAI、火山方舟 等在线或离线模型服务
搭建智能体	* 编排、发布、管理智能体 * 支持配置工作流、知识库等资源
搭建应用	* 创建、发布应用 * 通过工作流搭建业务逻辑
搭建工作流	创建、修改、发布、删除工作流
开发资源	支持创建并管理以下资源： * 插件 * 知识库 * 数据库 * 提示词
API 与 SDK	* 创建会话、发起对话等 OpenAPI * 通过 Chat SDK 将智能体或应用集成到自己的应用

2.3 环境与资源准备

了解如何获取并部署 Coze Studio 开源版，快速构建项目、体验 Coze Studio 开源版。

2.3.1 环境要求

• 在安装 Coze Studio 之前，请确保您的机器满足以下最低系统要求： 2 Core | 4 GB。
• 提前安装 Docker、Docker Compose，并启动 Docker 服务。
• 为了方便查看项目源码，以及部署全流程需要提前安装Cursor。

以下我的电脑配置：

2.3.2 安装Docker

登录Docker官网：https://www.docker.com，下载Docker Desktop Installer.exe，下载完成后根据系统提示一路next即可。

安装完成后，在Docker.desktop界面点右下角Engine paused后边的运行按钮。

启动Docker后，可以看到下图中的界面，Containers是容器管理界面，Images是镜像管理界面。

配置国内镜像源：

{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://s4uv0fem.mirror.aliyuncs.com",
    "https://docker.1ms.run",
    "https://registry.dockermirror.com",
    "https://docker.m.daocloud.io",
    "https://docker.kubesre.xyz",
    "https://docker.mirrors.ustc.edu.cn",
    "https://docker.1panel.live",
    "https://docker.kejilion.pro",
    "https://dockercf.jsdelivr.fyi",
    "https://docker.jsdelivr.fyi",
    "https://dockertest.jsdelivr.fyi",
    "https://hub.littlediary.cn",
    "https://proxy.1panel.live",
    "https://docker.1panelproxy.com",
    "https://image.cloudlayer.icu",
    "https://docker.1panel.top",
    "https://docker.anye.in",
    "https://docker-0.unsee.tech",
    "https://hub.rat.dev",
    "https://hub3.nat.tf",
    "https://docker.1ms.run",
    "https://func.ink",
    "https://a.ussh.net",
    "https://docker.hlmirror.com",
    "https://lispy.org",
    "https://docker.yomansunter.com",
    "https://docker.xuanyuan.me",
    "https://docker.mybacc.com",
    "https://dytt.online",
    "https://docker.xiaogenban1993.com",
    "https://dockerpull.cn",
    "https://docker.zhai.cm",
    "https://dockerhub.websoft9.com",
    "https://dockerpull.pw",
    "https://docker-mirror.aigc2d.com",
    "https://docker.sunzishaokao.com",
    "https://docker.melikeme.cn"
  ]
}

2.3.3 安装Cursor

登录Cursor官网：https://cursor.com/cn，下载安装包。下载完成后根据系统提示一路next。

2.3.4 下载Coze Studio源码

登录Coze Studio开源地址：https://github.com/coze-dev/coze-studio，下载源码ZIP文件。解压到指定目录..../Coze-studio-main。

2.3.5 获取ModelArts模型token

1. 登录

登录ModelArts AI开发平台：https://www.huaweicloud.com/product/modelarts/studio.html，进入ModelArts Studio控制台。

控制台后面选择西南-贵阳一，左侧选择模型推理 > 在线推理，右侧在预置服务 > 免费服务中找到DeepSeek-V3-32K（NEW），点操作栏的领取额度，领取完后，点后边的调用说明。

2. 获取API地址和model参数

调用说明里选择OpenAI SDK页签，复制保存接口信息中的API地址、model参数。

3. 获取API Key

点API Key管理的超链入口，进入API Key管理界面配置API Key。

点右上角的创建API Key，对话框里任意编辑一下标签名称和描述，点确定。然后在下一个对话框中复制并保存密钥。

注意提示信息：请将此密钥保存在安全且可访问的地方。这是唯一一次可以查看密钥的机会。您以后将无法查看它。但您可以随时创建新的访问密钥。

4. 参数汇总

汇总下模型ModelArts-deepseek-v3模型关键参数：

• API地址：https://maas-cn-southwest-2.modelarts-maas.com/v1/infers/271c9332-4aa6-4ff5-95b3-0cf8bd94c394/v1
• model参数：DeepSeek-V3
• API Key：nK9HJqSkuVqndXw8jhR9UONEB1L5DYJsIW3IwteS8VS8pkiy54G-E-Ouc*********BsES1FdJ3xUw

2.3.6 获取DeepSeek模型参数

登录官方DeepSeek开放平台：https://platform.deepseek.com/top_up

1. 充值

2. 创建API Key，并复制保存。

3. 查看官方API文档

登录deepseek官方API文档地址：https://api-docs.deepseek.com/zh-cn/，通过官网文档我们可知base_url和model参数。

4. 参数汇总

汇总下模型deepseek模型关键参数：

base_url ： https://api.deepseek.com/v1

model参数：

​ deepseek-chat 模型指向 DeepSeek-V3-0324，** 通过指定 model='deepseek-chat' 调用。

​ deepseek-reasoner 模型指向 DeepSeek-R1-0528，** 通过指定 model='deepseek-reasoner' 调用。

api_key：sk-0cadb1aa************c494cc43aeec

2.4 部署Coze Studio

2.4.1 Cursor打开Coze Studio源码

在Cursor右上角File > Open Folder，打开上一步中解压到指定目录的Coze Studio源码。

2.4.2 配置文件.env

将Coze-studio-main/docker目录下的.env.example文件在源目录下复制并修改其名称为.env

2.4.3 配置模型文件

Coze Studio提供的大量大模型配置模板：doubao、openai、ollama、deepseek、gemini、qwen等，同时也支持第三方封装的大模型。本文中以Deepseek为例，分别讲解Deepseek与第三方封装模型ModelArts（deepseek）如何配置。

• Deepseek：需要花点小钱，充值购买tockens，优点是响应速度快；
• ModelArts（deepseek）：华为云免费资源200万免费token，缺点是响应速度慢。

将Coze-studio-main/backend/conf/model/template目录下的model_template_deepseek.yaml文件移动到Coze-studio-main/backend/conf/model目录下，并按自己需要重命名。本文中分别重命名为ModelArts_deepseek-V3.yaml和DeepSeek-V3.yaml。

model_template_deepseek.yaml配置文件关键参数说明：

• id：Coze Studio中的模型 ID，由开发者自行定义，必须是非 0 的整数，且全局唯一。模型上线后请勿修改模型 id 。本案例中设置为2005/2006，可根据自己的情况自行设定。
• name：模型平台展示名称，本案例中为方便区分，将其修改为DeepSeek-V3、ModelArts-DeepSeek-V3，可根据自己的情况自行设定。
• meta.conn_config.base_url：模型服务基础URL。
• meta.conn_config.api_key：模型服务的 API Key。
• meta.conn_config.model：模型服务的 model ID。

参考如下表格分别修改配置文件ModelArts_deepseek-V3.yaml和DeepSeek-V3.yaml

配置文件参数	ModelArts参数	deepseek参数
meta.conn_config.base_url	https://maas-cn-southwest-2.modelarts-maas.com/v1/infers/271c9332-4aa6-4ff5-95b3-0cf8bd94c394/v1	https://api.deepseek.com/v1
meta.conn_config.api_key	nK9HJqSkuVqndXw8jhR9UONEB1L5DYJsIW3IwteS8VS8pkiy54G-E-Ouc*********BsES1FdJ3xUw	sk-0cadb1aa************c494cc43aeec
meta.conn_config.model	DeepSeek-V3	model='deepseek-chat' or model='deepseek-reasoner'

2.4.4 拉取docker镜像，启动Coze Studio

在Cursor编辑器中点右上角的Toggle pannel，然后选择Terminal窗口，输入如下命令。

docker compose --profile '*' up -d

输入名命令后，Docker会优先从镜像库拉取coze-studio镜像到Coze-studio-main/docker目录下，然后启动容器，启动时间稍长（3-5分钟）。

启动完成后即可通过地址：http://localhost:8888/，访问Coze Studio。

2.5 登录Coze Studio，测试模型服务

访问Coze Studio，地址：http://localhost:8888/。

初次登录在输入账号（邮箱地址）、密码后点注册既可进入空间界面，后续再次登录输入初次设置的账号、密码点登录，进入空间界面。

点右上角创建，编辑智能体名称、功能介绍以及图标，然后确认创建。

在编排编辑界面，左侧根据自己需要设计人设与回复逻辑。中间可以设计插件、工作流、知识库、开场白及问题、背景图片等。是指完成后顶部分别选择之前设置的ModelArts-DeepSeek-V3和DeepSeek-V3两种模型，在右侧输入问题测试小助手问答。点击右上角发布，编辑发布记录，继续点右上角发布。

点右上角完成，完成小助手发布。发布完成后，小助手智能体将自动保存至个人空间界面供下次使用。