7 月底字节跳动的 Coze-Studio 正式开源,算是 AI 智能体领域的一个大事件。这个月终于有时间在内网环境进行了部署和评测,希望能为团队的企业知识库和 AI 应用建设提供多一个选项。
其实,我们厂的知识库系统一直是自研的。没有直接采用市面上的开源方案,主要是基于几点考虑:
- • 技术栈匹配优先:知识库属于应用层基础设施,不像 linux/k8s 底层系统那样标准统一。采用团队最熟悉的技术栈,才能保证长期的稳定维护和迭代(比如市面上的智能体大都是基于 python,coze 是基于 go,我们的技术栈是 jvm,就不太适合拿来即用)。
- • 可控性至关重要:作为企业核心设施,我们需要对问题的响应速度和系统的稳定性有绝对把控力,而开源项目的更新节奏和潜在 bug 风险有时难以控制。
- • 定制化需求高频:直接使用开源产品,遇到定制需求时需要开分支修改,很难合并回 master 分支,后续的二次开发和升级成本非常高。
Coze空间 的开源版本让我能以更低的成本体验一个大厂能展现的功能完整的智能体平台。以下把我的评测和部署记录分享给大家。
个人评测
值得称赞的亮点
-
- 智能体功能完整:平台整体设计成熟,涵盖了智能体开发所需的大部分核心功能,超出了我们对一个初开源项目的预期,与maxkb,dify 相比个人觉得更完整和灵活,很有特点。
-
- 文件解析体验佳:知识库的文件解析模块支持分块内容和原文预览的对照查看,对于调试和优化分块效果非常友好。
有待改进的细节
-
- 模型管理略显原始:缺乏图形化的大模型管理模块,仍需在后台通过修改 YAML 配置文件来接入新模型,这对运维不够友好。
-
- 分块策略不够灵活:目前支持固定长度、分隔符和按段落拆分,但缺少自定义分段策略(如通过 Webhook 接入)。实际业务中的文档结构复杂,简单规则往往难以理想分割。
-
- 缺少开箱即用的 Chat 界面:智能体发布后,仅能通过 API/SDK 集成,不提供可嵌入的前端聊天界面。相比之下,Dify、MaxKB 等项目都提供了这一功能,便于快速集成。
-
- 提示词优化功能缺失:提示词管理目前全靠手动编写和调试。如果能集成类似
prompt-optimizer这样的开源优化工具,会极大提升创建效率。
- 提示词优化功能缺失:提示词管理目前全靠手动编写和调试。如果能集成类似
Coze Studio 的功能说明
智能体
平台的核心功能在上面图中都体现了,设计得非常周全:
- • 自定义插件:目前并非基于标准的 Model Context Protocol(MCP),未来若能接入 MCP 生态,扩展性会更强。
- • 工作流编排:界面清爽,调试方便,易于构建复杂逻辑。
- • 知识库集成:智能体可直接读写知识库,增强回答能力。
- • 记忆与状态:通过变量和数据库管理对话状态和用户记忆。
- • 用户体验优化:支持设置开场白、对话建议、快捷指令和背景图片,细节到位。
知识库
支持三种类型的知识库,适应不同场景:
-
- 表格知识库:导入 Excel 文件,生成结构化数据。
-
- 文本知识库:支持 PDF、DOCX 等格式,通过分块建立向量索引。
-
- 图片知识库:导入图片,支持人工标注或智能打标。
提示词管理
支持 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-web: Nginx 反向代理服务器,处理静态资源和请求转发
应用服务层
- • coze-server: Go 后端服务,基于 Hertz 框架,提供 API 接口和业务逻辑
数据存储层
- • MySQL: 主数据库,存储业务数据
- • Redis: 缓存服务
- • Elasticsearch: 搜索引擎,支持 SmartCN 分析器
- • Milvus: 向量数据库,用于存储嵌入向量
- • MinIO: 对象存储服务
消息队列层
- • NSQ: 分布式消息队列系统,包含 lookupd、nsqd 和 admin 组件
配置管理层
- • etcd: 分布式配置管理和服务发现
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%),开通会员后阅读全文 —