coze-loop

一站式调试、评估、监控你的 AI Agent，让开发更高效

coze-loop 是一个面向 AI Agent 的全生命周期优化平台，旨在解决 Agent 开发中调试难、评估缺、监控弱的问题。它提供从开发、调试、评估到监控的一体化能力，支持主流框架如 LangChain、Eino 等，并集成 Coze 生态。核心功能包括：Agent 运行追踪与可视化、性能指标采集、场景化评估测试、以及生产环境监控告警。通过统一平台，开发者可以快速定位问题、量化 Agent 质量，并持续优化行为。项目基于 Go 构建，性能出色，适合大规模部署。

开源 free 基础设施

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 5744

维护状态活跃

是否开源是

定价模式 free

项目数据

分类基础设施

开发团队coze-dev

所属国家

官网地址

GitHubhttps://github.com/coze-dev/coze-loop

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自行部署使用，完全免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言Go

技术栈/模型agent,agent-evaluation,agent-observability,agentops,ai,coze,eino,evaluation,langchain,llm-observability,llmops,monitoring,observability,open-source,openai,playground,prompt-management

GitHub 星标★ 5744

30天Star增速

HF 下载量

上线时间2025-06-24 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数10

使用教程

难度：入门约 15 分钟部署方式：Docker 4 步

环境要求

已安装并启动 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

项目介绍

coze-loop 是基础设施领域的开源项目，由 coze-dev 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（5,744）位列前 8%，在基础设施分类的 1,130 个项目里位列前 12%。

近 44 天，它的 GitHub 星标从 5,683 增加到 5,744，净增 61。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。Apache-2.0 许可证，可自行部署使用，完全免费。

它主要面向的使用场景是：AIAgent开发调试，快速定位逻辑错误。同类可对比的替代方案包括 LangSmith、Langfuse、AgentOps。

上一篇：helicone

下一篇：cube-studio