
coze-loop
一站式调试、评估、监控你的 AI Agent,让开发更高效
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 5802
使用教程
环境要求
- 已安装并启动 Docker Engine(含 Docker Compose)
- 已安装 Git 与 make 命令
- 准备一个可用的大模型 API Key(README 以火山方舟为例)以及对应的模型接入点 Endpoint ID
- 机器可访问外网以拉取镜像与依赖
安装与启动步骤
-
1克隆项目源码
把 coze-loop 源码下载到本地并进入项目根目录,后续命令都在该目录下执行。
git clone https://github.com/coze-dev/coze-loop.git cd coze-loop -
2配置模型
编辑 release/deployment/docker-compose/conf/model_config.yaml,修改 api_key 与 model 两个字段,填入自己的密钥和模型 Endpoint ID,否则无法调用模型。
-
3启动服务
在 coze-loop 目录下用 Docker Compose 一键启动,默认以 development 模式运行,首次启动需拉取镜像耗时较长。
make compose-up -
4浏览器访问
服务启动后在浏览器打开 http://localhost:8082 即可进入 Coze Loop 开源版界面,开始创建和调试项目。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
api_key | 是 | 大模型服务的 API Key,README 以火山方舟为例 | sk-xxxxxxxxxxxxxxxx |
model | 是 | 模型接入点的 Endpoint ID,非模型名称本身 | ep-20240101120000-xxxxx |
如何确认成功
在浏览器打开 http://localhost:8082,能正常显示 Coze Loop 开源版页面即部署成功。
常见问题
Q:启动前需要准备什么?
A:必须先安装并启动 Docker Engine,否则 make compose-up 无法执行;同时要准备好模型 api_key 和 model Endpoint ID。
Q:不配置模型能启动吗?
A:README 明确要求先修改 model_config.yaml 中的 api_key 和 model 字段,不配置将无法正常调用模型能力。
Q:想部署到 Kubernetes 怎么办?
A:README 提供 Helm 方式:先执行 helm pull oci://docker.io/cozedev/coze-loop --version 1.0.0-helm 拉取 Chart,解压后配置模型与 ingress.yaml,再用 make helm-up 部署。
Q:如何确认 Helm 部署成功?
A:依次执行 make helm-pod 查看 Pod 状态,make helm-logf-app 和 make helm-logf-nginx 查看日志,app 与 nginx 均正常运行即为成功。
Q:公网部署安全吗?
A:README 提示公网部署前需评估风险并做防护,涉及账号注册功能、Coze Server 监听地址、SSRF 以及 API 横向越权等问题。
注意事项
- 默认以 development 模式启动,便于本地快速体验。
- 若要在公网环境部署,请先评估账号注册、监听地址、SSRF、越权等安全风险并采取防护措施。
- Helm 方式需预先准备 Kubernetes 集群、启用 Nginx Ingress 插件并安装 kubectl 与 Helm。
- Helm 部署后访问域名取决于集群分配的域名与地址,且修改 values.yaml 后需重新执行 make helm-up 生效。
核心亮点
- 提供从开发到监控的全生命周期管理,减少工具切换成本
- 支持 LangChain、Eino 等主流框架,集成 Coze 生态,兼容性强
- 基于 Go 实现,性能高,适合生产环境大规模使用
不足之处
- 文档/社区待观察
适用场景
- AI Agent 开发调试,快速定位逻辑错误
- Agent 上线前的质量评估与回归测试
- 生产环境 Agent 运行监控与告警
替代项目
LangSmith、Langfuse、AgentOps
上一篇:helicone
下一篇:cube-studio
同类项目推荐
memlayer
开源
三行代码给大模型装上持久记忆,让对话更懂你
Plug-and-play memory for LLMs in 3 lines of code. Add persistent, intelligent, human···
openvino
开源
把AI模型快速部署到英特尔硬件,推理提速数倍
OpenVINO™ is an open source toolkit for optimizing and deploying AI inference
codegate
开源
给 AI 代理加道安全闸,多开不串台
CodeGate: Security, Workspaces and Multiplexing for AI Agentic Frameworks
feature-store
开源
打通数据与模型,让特征复用不再重复造轮子
Using a feature store to connect the DataOps and MLOps workflows to enable collabora···
metabase
开源
让不懂 SQL 的同事也能轻松做数据分析,五分钟搭建团队 BI 看板
The easy-to-use open source Business Intelligence and Embedded Analytics tool that l···
tensorzero
开源
大模型上线后的监控调优全包办,出问题不再抓瞎
TensorZero is an open-source LLMOps platform that unifies an LLM gateway, observabil···
AsyncDiff
开源
把扩散模型去噪步骤并行化,生成图片速度翻倍
[NeurIPS 2024] AsyncDiff: Parallelizing Diffusion Models by Asynchronous Denoising
amd-r9700-vllm-toolboxes
开源
在 AMD R9700 上一键搭起 vLLM 推理服务
keda-gpu-scaler
开源
无需 Prometheus,让 K8s 上的 GPU 工作负载按真实使用量自动伸缩。
KEDA External gRPC Scaler for GPU workloads - native NVML metrics via DaemonSet, no ···