概览
该仓库包含 Opik 服务器后端、Web 应用，以及追踪、数据集、实验、评估、提示词管理、在线评估和智能体优化相关组件。它与框架无关，可捕获 LLM 调用、对话、检索步骤、工具执行和嵌套智能体活动，并以追踪树形式呈现。评估功能包括基于代码的指标、数据集、实验，以及用于幻觉检测、内容审核和 RAG 评估的 LLM-as-a-judge 指标。
主要功能
- 对 LLM 调用、对话、检索步骤、工具执行和多步骤智能体的嵌套追踪
- 数据集、实验、基于代码的指标和 LLM-as-a-judge 评估
- 包括答案相关性和上下文精确度的 RAG 评估指标
- 幻觉检测和内容审核评估
- 提示词管理和 Prompt Playground
- 生产仪表板和在线评估规则
- 通过 Python SDK 或 UI 为追踪和 span 添加反馈评分
- 用于 CI/CD 评估的 PyTest 集成
- Agent Optimizer 和护栏功能
- Python、TypeScript 及通过 OpenTelemetry 使用的 Ruby 客户端支持，以及 REST API
- 托管与自托管部署选项
- Docker Compose 脚本和 Kubernetes/Helm 部署指导
要求、安装和快速入门
Python SDK 快速开始：`pip install opik` 或 `uv pip install opik`，随后运行 `opik configure`。本地自托管可克隆 `https://github.com/comet-ml/opik.git`，进入 `opik` 目录后在 Linux 或 macOS 上运行 `./opik.sh`。Windows 上运行 `powershell -ExecutionPolicy ByPass -c ".\\opik.ps1"`。脚本还提供 `--infra`、`--backend` 和 `--guardrails` 配置。Kubernetes 通过 Helm 的安装方式面向更大规模部署提供文档说明。也提供 Comet.com 托管选项。
用法
配置 Python SDK 后，从 `opik` 导入 `track`，并使用 `@track` 装饰函数。该函数及其嵌套调用会被记录为追踪。对于本地安装，README 表示启动后 Web 界面位于 `http://localhost:5173`。应用也可通过支持的集成、OpenTelemetry、其他客户端 SDK 或 REST API 记录数据。
模型兼容性与使用场景
Opik 被描述为框架无关，而非绑定单一模型。提供的 README 摘录明确列出涉及 Anthropic、Amazon Bedrock、BytePlus、Cloudflare Workers AI、Cohere、DeepSeek、Fireworks AI、Google Gemini、Groq 等框架或平台的集成。它还提及 Google ADK、AG2、Agno、Autogen、BeeAI、CrewAI、Dify、DSPy 和 Flowise AI 等集成。OpenAI 出现在仓库主题中，但提供的摘录未包含明确的 OpenAI 集成细节。仓库元数据未说明 MCP 支持。
许可证与风险说明
仓库元数据将许可证标识为 Apache-2.0。README 表示服务器、Web 应用以及核心可观测性和评估平台可在无需商业许可证的情况下自托管。部署或再分发前请审阅仓库许可证：https://api.github.com/licenses/apache-2.0
发布与维护
README 引导用户查看变更日志，并特别警告版本 1.7.0 包含重要更新和破坏性变更。仓库元数据报告默认分支为 `main`，最新提供的推送时间戳为 2026-08-03T09:50:41Z。仓库元数据未说明具体的当前发布版本。