Harness 与 Agent 工程 · Agent架构与协作 · 2025-08-22

深度评测智能体平台Coze Studio:附部署教程

字节跳动开源的Coze Studio智能体平台评测与部署指南,为企业AI应用提供新选择。

核心内容:

  1. Coze Studio的核心优势与功能亮点分析
  2. 平台当前存在的四大改进空间
  3. 详细部署教程与实战应用建议

7 月底字节跳动的 Coze-Studio 正式开源,算是 AI 智能体领域的一个大事件。这个月终于有时间在内网环境进行了部署和评测,希望能为团队的企业知识库和 AI 应用建设提供多一个选项。

其实,我们厂的知识库系统一直是自研的。没有直接采用市面上的开源方案,主要是基于几点考虑:

Coze空间 的开源版本让我能以更低的成本体验一个大厂能展现的功能完整的智能体平台。以下把我的评测和部署记录分享给大家。

个人评测

值得称赞的亮点

    1. 智能体功能完整:平台整体设计成熟,涵盖了智能体开发所需的大部分核心功能,超出了我们对一个初开源项目的预期,与maxkb,dify 相比个人觉得更完整和灵活,很有特点。
    1. 文件解析体验佳:知识库的文件解析模块支持分块内容和原文预览的对照查看,对于调试和优化分块效果非常友好。

有待改进的细节

    1. 模型管理略显原始:缺乏图形化的大模型管理模块,仍需在后台通过修改 YAML 配置文件来接入新模型,这对运维不够友好。
    1. 分块策略不够灵活:目前支持固定长度、分隔符和按段落拆分,但缺少自定义分段策略(如通过 Webhook 接入)。实际业务中的文档结构复杂,简单规则往往难以理想分割。
    1. 缺少开箱即用的 Chat 界面:智能体发布后,仅能通过 API/SDK 集成,不提供可嵌入的前端聊天界面。相比之下,Dify、MaxKB 等项目都提供了这一功能,便于快速集成。
    1. 提示词优化功能缺失:提示词管理目前全靠手动编写和调试。如果能集成类似 prompt-optimizer 这样的开源优化工具,会极大提升创建效率。

Coze Studio 的功能说明

智能体

平台的核心功能在上面图中都体现了,设计得非常周全:

知识库

支持三种类型的知识库,适应不同场景:

    1. 表格知识库:导入 Excel 文件,生成结构化数据。
    1. 文本知识库:支持 PDF、DOCX 等格式,通过分块建立向量索引。
    1. 图片知识库:导入图片,支持人工标注或智能打标。

提示词管理

支持 Markdown 格式的可视化编辑,并可将调试好的提示词保存到库中,方便团队复用。

数据库

这是一个亮眼功能,Coze 支持低代码方式操作数据库。用户可在界面定义 MySQL 表结构,智能体便能直接对其进行读写,相当于内置了一个 text2sql 方案。

在智能体中将数据库表作为记忆

Coze Studio 的物理架构

Coze Studio 的物理架构图,展示各个部署角色之间的关系。

配置管理层消息队列层数据存储层应用服务层负载均衡层coze-web (Nginx)coze-server (Go后端)MySQL 8.4.5Redis 8.0Elasticsearch 8.18.0Milvus v2.5.10MinIONSQ LookupdNSQ DaemonNSQ Adminetcd 3.5

前端服务层

应用服务层

数据存储层

消息队列层

配置管理层

Coze Studio 的部署说明

docker-compose 部署的文件列表

➜ coze git:(master) ✗ tree -L 3.├── backend│ └── conf│ ├── model│ ├── plugin│ └── prompt├── nginx│ ├── conf.d│ │ └── default.conf│ ├── ssl│ └── nginx.conf├── volumes│ ├── elasticsearch│ │ ├── es_index_schema│ │ ├── analysis-smartcn.zip│ │ ├── elasticsearch.yml│ │ └── setup_es.sh│ ├── etcd│ │ └── etcd.conf.yml│ ├── minio│ │ ├── default_icon│ │ └── official_plugin_icon│ ├── mysql│ │ ├── schema.sql│ │ └── sql_init.sql│ └── rocketmq│ └── broker.conf├── docker-compose.yml├── example.env.env└── readme.md

备注:elasticsearch,kafka,mysql 这几个服务我之前有部署,所以没有包括在 docker-compose 里面部署

docker-compose 配置

minio 和 coze-server 是用 coze-web(nginx) 代理的,具体见 nginx/default.conf

name: coze-studiox-env-file:&env_file-coze.envservices:redis: image:bitnami/redis:8.0 container_name:coze-redis restart:always user:root privileged:true env_file:*env_file environment: -REDIS_AOF_ENABLED=${REDIS_AOF_ENABLED:-no} -REDIS_PORT_NUMBER=${REDIS_PORT_NUMBER:-6379} -REDIS_IO_THREADS=${REDIS_IO_THREADS:-4} -ALLOW_EMPTY_PASSWORD=${ALLOW_EMPTY_PASSWORD:-yes} ports: -'6379' volumes: -./data/bitnami/redis:/bitnami/redis/data:rw,Z command:> bash -c " /opt/bitnami/scripts/redis/setup.sh # Set proper permissions for data directories chown -R redis:redis /bitnami/redis/data chmod g+s /bitnami/redis/data exec/opt/bitnami/scripts/redis/entrypoint.sh/opt/bitnami/scripts/redis/run.sh " healthcheck: test: ['CMD', 'redis-cli', 'ping'] interval: 5s timeout: 10s retries: 10 start_period: 10s networks: - coze-network minio: image: minio/minio:RELEASE.2025-07-23T15-54-02Z container_name: coze-minio user: root privileged: true restart: always env_file: *env_file ports: - '9000' - '9001' volumes: - ./data/minio:/data - ./volumes/minio/default_icon/:/default_icon - ./volumes/minio/official_plugin_icon/:/official_plugin_icon environment: MINIO_ROOT_USER: ${MINIO_ROOT_USER:-minioadmin} MINIO_ROOT_PASSWORD: ${MINIO_ROOT_PASSWORD:-minioadmin123} MINIO_DEFAULT_BUCKETS: ${MINIO_BUCKET:-opencoze},${MINIO_DEFAULT_BUCKETS:-milvus} entrypoint: - /bin/sh - -c - | # Run initialization in background ( # Wait for MinIO to be ready until (/usr/bin/mc alias set localminio http://localhost:9000 $${MINIO_ROOT_USER} $${MINIO_ROOT_PASSWORD}) do echo "WaitingforMinIOtobeready..." sleep1 done # Create bucket and copy files /usr/bin/mcmb--ignore-existinglocalminio/$${STORAGE_BUCKET} /usr/bin/mccp--recursive/default_icon/localminio/$${STORAGE_BUCKET}/default_icon/ /usr/bin/mccp--recursive/official_plugin_icon/localminio/$${STORAGE_BUCKET}/official_plugin_icon/ echo"MinIO initialization complete." )& # Start minio server in foreground execminioserver/data--console-address":9001" healthcheck: test: [ 'CMD-SHELL', '/usr/bin/mc alias set health_check http://localhost:9000 ${MINIO_ROOT_USER} ${MINIO_ROOT_PASSWORD} && /usr/bin/mc ready health_check', ] interval:30s timeout:10s retries:3 start_period:30s networks: -coze-networketcd: image:bitnami/etcd:3.5 container_name:coze-etcd user:root restart:always privileged:true env_file:*env_file environment: -ETCD_AUTO_COMPACTION_MODE=revision -ETCD_AUTO_COMPACTION_RETENTION=1000 -ETCD_QUOTA_BACKEND_BYTES=4294967296 -ALLOW_NONE_AUTHENTICATION=yes ports: -'2379' -'2380' volumes: -./data/bitnami/etcd:/bitnami/etcd:rw,Z -./volumes/etcd/etcd.conf.yml:/opt/bitnami/etcd/conf/etcd.conf.yml:ro,Z command:> bash -c " /opt/bitnami/scripts/etcd/setup.sh # Set proper permissions for data and config directories chown -R etcd:etcd /bitnami/etcd chmod g+s /bitnami/etcd exec/opt/bitnami/scripts/etcd/entrypoint.sh/opt/bitnami/scripts/etcd/run.sh " healthcheck: test: ['CMD', 'etcdctl', 'endpoint', 'health'] interval: 5s timeout: 10s retries: 10 start_period: 10s networks: - coze-network# milvusdb/milvus:v2.5.10 milvus: container_name: coze-milvus image: milvusdb/milvus:2.2.0-20230427-9286d7a4 user: root privileged: true restart: always env_file: *env_file command: > bash -c " # Set proper permissions for data directories chown-Rroot:root/var/lib/milvus chmodg+s/var/lib/milvus execmilvusrunstandalone " security_opt: - seccomp:unconfined environment: ETCD_ENDPOINTS: etcd:2379 MINIO_ADDRESS: minio:9000 MINIO_BUCKET_NAME: ${MINIO_BUCKET:-milvus} MINIO_ACCESS_KEY_ID: ${MINIO_ROOT_USER:-minioadmin} MINIO_SECRET_ACCESS_KEY: ${MINIO_ROOT_PASSWORD:-minioadmin123} MINIO_USE_SSL: false LOG_LEVEL: debug volumes: - ./data/milvus:/var/lib/milvus:rw,Z healthcheck: test: ['CMD', 'curl', '-f', 'http://localhost:9091/healthz'] interval: 5s timeout: 10s retries: 10 start_period: 10s ports: - '19530' - '9091' depends_on: etcd: condition: service_healthy minio: condition: service_health…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/OpenSourceLLM/2025082252648.html