综合介绍

Coze Studio 是字节跳动旗下AI智能体开发平台“Coze (扣子)”的开源版本。它是一个提供给开发者的一体化、全功能开发套件，旨在简化AI智能体（Agent）应用的创建、调试与部署过程。平台将开发过程中需要的核心技术，例如提示词工程（Prompt）、检索增强生成（RAG）、插件（Plugin）以及工作流（Workflow），都整合在了一起。这使得开发者可以把精力集中在应用的核心逻辑创新上，而不用过多地为底层技术实现分心。平台后端使用Go语言开发，前端基于React和TypeScript，整体采用了遵循领域驱动设计（DDD）原则的微服务架构。这种技术选型为开发者提供了一个高性能、高可扩展且易于定制的底层框架，可以用来构建和满足复杂的业务需求。通过Coze Studio提供的可视化工具，开发者能够以无代码或低代码的方式，快速将创意转变为现实。

功能列表

• 模型服务: 统一管理大语言模型列表，支持接入并管理多个模型服务，例如 OpenAI 和火山方舟（Volcengine Ark）等。
• 构建智能体: 支持创建、发布和管理AI智能体。可以为智能体配置工作流、知识库、长期记忆和插件等多种增强能力。
• 构建应用: 允许用户创建并发布应用，应用的核心业务逻辑通过可视化的工作流来设计和实现。
• 构建工作流: 提供可视化的画布编辑器，用户可以通过拖拽节点的方式创建、修改、发布和删除工作流，用于处理特定任务或实现复杂逻辑。
• 开发资源: 支持对开发过程中所需的各类资源进行创建和统一管理，具体包括：
  • 插件
  • 知识库
  • 数据库
  • 提示词（Prompts）
• API与SDK:
  • 提供用于创建对话、发起聊天等功能的 OpenAPI。
  • 提供 Chat SDK，方便将创建的智能体或应用以聊天窗口的形式集成到企业自己的网站或业务系统中。

使用帮助

Coze Studio 提供了一套完整的环境，让开发者可以进行私有化部署和使用。以下是部署平台和使用核心功能的详细流程。

环境要求与部署流程

在开始安装之前，请确保您的系统环境满足以下要求，并已安装好必要的软件。

1. 系统要求:

• CPU: 最低 2 核
• 内存: 最低 4 GB
• 软件: 必须预先安装 Docker 和 Docker Compose，并确保Docker服务已经正常启动。

2. 部署步骤:

整个部署过程主要分为获取代码、配置模型和启动服务三个阶段。

第一步：获取源代码使用 git 命令从GitHub克隆项目的源代码到您的本地计算机。

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

第二步：配置大语言模型Coze Studio 必须连接一个大语言模型才能正常工作。在部署前，您必须完成至少一个模型服务的配置，否则后续将无法创建智能体和应用。这里以配置火山方舟的 doubao-seed-1.6 模型为例进行说明。

• 进入项目根目录：

  cd coze-studio
  

• 复制模型配置文件模板。系统提供了一个模板文件，您需要复制它来创建自己的模型配置：

  cp backend/conf/model/template/model_template_ark_doubao-seed-1.6.yaml backend/conf/model/ark_doubao-seed-1.6.yaml
  

• 修改模型配置文件。使用文本编辑器打开刚刚创建的 backend/conf/model/ark_doubao-seed-1.6.yaml 文件，并修改其中的关键字段：
  • id: 模型在Coze Studio系统内的唯一ID。这个ID由开发者自己定义，必须是一个非零整数，且全局唯一。注意：模型上线后，请不要再修改此ID。
  • meta.conn_config.api_key: 您所使用模型服务的API Key。您需要从火山方舟或其他模型服务商处获取。
  • meta.conn_config.model: 您所使用模型服务的具体模型ID或接入点ID。例如，火山方舟模型的Endpoint ID。

第三步：部署并启动服务

• 进入 docker 目录，并从模板文件复制一份环境变量文件：

  cd docker
  cp .env.example .env
  

• 使用 Docker Compose 命令启动所有服务。第一次启动时，系统需要从网络上拉取镜像并构建本地镜像，这个过程可能会花费一些时间，请耐心等待。

  docker compose --profile '*' up -d
  

当您在终端日志中看到 "Container coze-server Started" 的信息时，就代表Coze Studio服务已经成功启动。现在，您可以通过浏览器访问 http://localhost:7071 并开始使用了。

核心功能操作与开发指南

关于如何使用Coze Studio的各项功能来构建智能体和应用，您可以参考Coze商用版官方文档中心。请注意，开源版与商用版在部分功能上存在差异（例如，语气设定等高级功能仅限于商用版），但核心的构建流程是相同的。

• API参考: 开源版Coze Studio的API调用与商用版不同，仅支持个人访问令牌（PAT）进行认证。详细的API接口说明，请查阅项目的API Reference文档。
• 项目架构与二次开发: 如果您希望进行二次开发，可以查阅开发标准文档，了解项目的技术架构、核心组件以及如何进行代码开发和测试。

应用场景

1. 构建企业级在线客服企业可以将产品手册、解决方案和常见问答（FAQ）文档上传至知识库，创建一个专业的AI客服智能体。然后通过Chat SDK将其无缝集成到公司官网或App中，实现7x24小时自动化客户支持，有效降低人力成本。
2. 开发领域专家助手为特定专业领域（如法律、金融、医疗）构建一个专家助手。通过向知识库中添加大量的专业文献和资料，并配置网络搜索插件以获取最新信息，该智能体可以为专业人士提供信息查询、报告分析和草稿撰写等辅助。
3. 创建自动化内容生成工具设计一个多步骤的工作流，用于自动化内容创作。例如，输入一个主题，工作流可以自动执行以下步骤：调用搜索插件收集资料、调用大模型节点生成内容大纲、根据大纲扩展成文章初稿、最后再调用另一个插件进行语法检查。
4. 打造个性化的个人助理开发者可以为自己创建一个个人助理，集成日程管理、邮件读写、信息摘要等插件。通过与这个智能体对话，就可以用自然语言完成日常的办公任务，例如“帮我总结今天收到的重要邮件”或“查询下周去上海的机票”。

QA

1. Coze Studio与字节跳动的Coze平台（扣子）究竟有什么区别？Coze Studio是Coze平台的开源版本，它提供了Coze平台的核心功能，包括智能体构建、工作流、插件和知识库等，主要面向需要私有化部署和二次开发的开发者。商业版Coze平台则提供更丰富的功能（如模型微调、官方插件市场）和更稳定的托管服务，更适合个人用户或企业直接使用。此外，开源版的API仅支持个人访问令牌（PAT）认证。
2. 使用Coze Studio是否必须会编程？不是必须的。Coze Studio的核心理念是无代码和低代码。绝大部分功能，如创建智能体、配置知识库、设计工作流等，都可以通过拖拽式的图形化界面完成。但对于有编程基础的用户，平台也提供了代码节点（支持Python和Node.js），可以编写脚本来实现更复杂或高度自定义的业务逻辑。
3. 部署Coze Studio需要自己准备大语言模型吗？是的。Coze Studio本身是一个AI应用的开发和运行框架，不内置任何大语言模型。您需要自行从模型服务商（如OpenAI、Google、火山引擎等）获取模型的API访问权限，然后将API Key等信息配置到Coze Studio中，平台才能调用模型来执行任务。
4. Coze Studio项目是完全免费的吗？项目本身是基于Apache 2.0开源许可的，您可以免费下载、部署、使用和修改其源代码。但是，您在使用过程中会产生一些关联成本，主要是调用第三方大语言模型服务所产生的费用，这部分费用由相应的模型服务商收取。