注意：此文件使用AI进行机器翻译。欢迎对翻译进行改进！

Opik 是面向 AI 智能体追踪、LLM 评估、提示管理和生产监控的开源 LLM 可观测性与评估平台。由 Comet 打造。采用 Apache-2.0 许可，可免费自托管完整平台，已获得 20,000+ 个 GitHub star。

官网 • Slack 社区 • Twitter • 更新日志 • 文档

_{最后更新：2026-07-17}

Opik 覆盖了 LLM 应用的完整生命周期，从开发阶段的第一条追踪到生产监控，服务于构建 LLM 应用和 AI 智能体的团队。核心能力包括：

• AI 智能体追踪与可观测性：对 LLM 调用、对话日志和智能体活动进行深度追踪，为多步骤智能体和工具调用提供完整的追踪树。
• LLM 评估：提供数据集、实验以及 LLM 作为评判者的指标，用于幻觉检测、内容审核和 RAG 评估。
• 提示与智能体优化：Opik Agent Optimizer SDK，用于改进提示和智能体。
• 生产就绪的监控：可扩展的仪表盘和在线评估规则。
• Opik Guardrails：帮助你实施安全且负责任的 AI 实践的功能。
• CI/CD 评估：PyTest 集成，可在每次提交时测试 LLM 流水线。

核心功能包括：

• 开发与追踪：

  • 在开发和生产环境中跟踪所有 LLM 调用和追踪，并附带详细上下文（快速开始）。
  • 丰富的第三方集成，便于实现可观测性：可无缝集成不断增长的框架列表，并原生支持其中许多最大和最流行的框架（包括近期新增的 Google ADK、Autogen 和 Flowise AI）。（集成）
  • 通过 Python SDK 或 UI 为追踪和 span 添加反馈评分注解。
  • 在提示 Playground 中试验提示和模型。

• 评估与测试：

  • 使用数据集和实验自动化你的 LLM 应用评估。
  • 利用强大的 LLM 作为评判者的指标处理复杂任务，例如幻觉检测、内容审核以及 RAG 评估（答案相关性、上下文精确度）。
  • 通过我们的 PyTest 集成将评估集成到你的 CI/CD 流水线中。

• 生产监控与优化：

  • 记录大量生产追踪：Opik 专为规模化设计（每天 4000 万+ 条追踪）。
  • 在 Opik 仪表盘中随时间监控反馈评分、追踪数量和 token 用量。
  • 利用带有 LLM 作为评判者指标的在线评估规则来识别生产问题。
  • 借助 Opik Agent Optimizer 和 Opik Guardrails，在生产环境中持续改进并保护你的 LLM 应用。

适用人群： 构建 LLM 驱动智能体的机器学习工程师、从原型走向生产的 AI 团队，以及需要可在自有环境中运行的开源、可自托管可观测性的工程团队。

为什么开源在这里很重要： Opik 采用 Apache-2.0 许可，可免费自托管：是完整平台，包含后端，而不仅仅是客户端 SDK。该仓库包含服务器后端、Web 应用、追踪、数据集、实验、评估、提示管理、在线评估和智能体优化等组件，全部采用 Apache-2.0 许可。你可以在自己的基础设施内运行 LLM 可观测性，数据不会离开你的环境，也无需进行企业销售洽谈。

安装 Python SDK 并进行配置：

pip install opik
opik configure

用 @track 装饰器包裹任意函数即可开始记录追踪：

from opik import track

@track
def my_function(input: str) -> str:
    return input

现在，每次对 my_function 的调用都会被记录到 Opik，包括嵌套调用，因此它适用于完整的智能体和流水线追踪，而不仅仅是单次 LLM 调用。有关 TypeScript SDK 和其他设置选项，请参阅快速开始指南。

让 Claude Code、Cursor、VS Code Copilot、Codex 或 opencode 直接在聊天中读取你的追踪、为输出打分并运行评估。一条命令即可完成设置，只需要 uv，无需安装 SDK：

uvx opik mcp configure

上面的徽章和下方的 add-mcp 备用命令面向 Opik Cloud；上面的命令同样适用于自托管部署。Opik Cloud 上的其他 MCP 客户端：npx add-mcp https://www.comet.com/opik/api/v1/mcp --name opik-mcp。详细说明、故障排除和常见问题请参阅 MCP 服务器指南。

Opik 与 LangSmith、Arize（Phoenix 和 Arize AX）、Weights & Biases（Weave）、Langfuse 和 Braintrust 一同竞争于 LLM 可观测性 / AI 智能体评估 这一领域。

团队为何选择 Opik： Opik 完整的可观测性、评估和优化平台采用 Apache-2.0 许可，可免费自托管。与那些自托管部署需要企业版计划的封闭平台不同，Opik 无需商业许可即可部署，而且它框架无关，不会将你锁定到单一的智能体生态系统中。有关自托管和许可在各替代方案之间的差异，请参阅上表。

Opik 采用 Apache 2.0 许可。其服务器、Web 应用以及核心的可观测性和评估功能均可在无需商业许可的情况下自托管。

可以。你可以按照文档中的自托管选项在本地或你自己的基础设施中部署 Opik。

支持。Opik 可捕获包含 LLM 调用、工具执行、检索步骤和其他智能体活动的多步骤追踪。

支持。Opik 支持数据集、实验、基于代码的指标、LLM 作为评判者的评估以及在线评估。

否。Opik 框架无关，支持其自有 SDK、OpenTelemetry 以及针对特定框架的集成。

几分钟内即可让你的 Opik 服务器运行起来。选择最适合你需求的方式：

无需任何设置即可立即访问 Opik。适合快速上手和省心维护。

👉 创建你的免费 Comet 账户

在你自己的环境中部署 Opik。可在用于本地设置的 Docker 与用于可扩展性的 Kubernetes 之间进行选择。

这是让本地 Opik 实例运行起来的最简单方式。请注意新的 ./opik.sh 安装脚本：

在 Linux 或 Mac 环境下：

# Clone the Opik repository
git clone https://github.com/comet-ml/opik.git

# Navigate to the repository
cd opik

# Start the Opik platform
./opik.sh

在 Windows 环境下：

# Clone the Opik repository
git clone https://github.com/comet-ml/opik.git

# Navigate to the repository
cd opik

# Start the Opik platform
powershell -ExecutionPolicy ByPass -c ".\\opik.ps1"

安装脚本选项

opik.sh 和 opik.ps1 脚本支持以下选项：

# Start full Opik suite (default behavior)
./opik.sh

# Start only infrastructure services (databases, caches etc.)
./opik.sh --infra

# Start infrastructure + backend services
./opik.sh --backend

# Enable guardrails with any profile
./opik.sh --guardrails # Guardrails with full Opik suite
./opik.sh --backend --guardrails # Guardrails with infrastructure + backend

# Build the containers from source before starting
./opik.sh --build

# Check that all containers are healthy
./opik.sh --verify

# Stop all containers
./opik.sh --stop

# Stop all containers and remove all Opik data volumes
# WARNING: ALL OPIK DATA WILL BE LOST
./opik.sh --clean

# Show all available options
./opik.sh --help

使用 --help 或 --info 选项来排查问题。Dockerfile 现已确保容器以非 root 用户运行，以增强安全性。一切启动并运行后，你现在就可以在浏览器中访问 localhost:5173 了！有关详细说明，请参阅本地部署指南。

对于生产环境或更大规模的自托管部署，可以使用我们的 Helm chart 将 Opik 安装到 Kubernetes 集群上。点击徽章查看完整的使用 Helm 的 Kubernetes 安装指南。

Opik 提供一套客户端库和一个 REST API 用于与 Opik 服务器交互。这包括面向 Python 和 TypeScript 的 SDK，以及第一方 OpenTelemetry 支持：任何具有 OpenTelemetry SDK 的语言（包括 Java、Ruby 和 .NET）都可以将追踪数据发送到 Opik。有关详细的 API 和 SDK 参考，请参阅 Opik 客户端参考文档。

要开始使用 Python SDK：

安装该软件包：

# install using pip
pip install opik

# or install with uv
uv pip install opik

运行 opik configure 命令配置 Python SDK，它会提示你输入 Opik 服务器地址（用于自托管实例）或你的 API 密钥和工作区（用于 Comet.com）：

opik configure

现在你已准备好使用 Python SDK 开始记录追踪了。

记录追踪最简单的方式是使用我们的某个直接集成。Opik 支持种类繁多的框架，包括近期新增的 Google ADK、Autogen、AG2 和 Flowise AI：

如果你没有使用上述任何框架，也可以使用 track 函数装饰器来记录追踪：

import opik

opik.configure(use_local=True) # Run locally

@opik.track
def my_llm_function(user_question: str) -> str:
    # Your LLM code here

    return "Hello"

Python Opik SDK 包含许多 LLM 作为评判者的指标，帮助你评估 LLM 应用。请在指标文档中了解更多。

要使用它们，只需导入相关指标并使用 score 函数：

from opik.evaluation.metrics import Hallucination

metric = Hallucination()
score = metric.score(
    input="What is the capital of France?",
    output="Paris",
    context=["France is a country in Europe."]
)
print(score)

Opik 还包含许多预构建的启发式指标，并支持创建你自己的指标。请在指标文档中了解更多。

Opik 允许你在开发阶段通过数据集和实验评估你的 LLM 应用。Opik 仪表盘为实验提供了增强的图表，并能更好地处理大型追踪。你还可以使用我们的 PyTest 集成将评估作为 CI/CD 流水线的一部分运行。

如果你觉得 Opik 有用，请考虑给我们点个 star！你的支持将帮助我们壮大社区并持续改进产品。

为 Opik 做贡献的方式有很多：

• 提交错误报告和功能请求
• 审阅文档并提交Pull Request 来改进它
• 谈论或撰写有关 Opik 的内容，并告诉我们
• 为热门功能请求投票以表达你的支持

要了解有关如何为 Opik 做贡献的更多信息，请参阅我们的贡献指南。