Files
comet-ml--opik/readme_RU.md
T
wehub-resource-sync 5a558eb09e
TypeScript SDK Compatibility V1.x E2E Tests / Select Node version matrix (push) Has been cancelled
TypeScript SDK Compatibility V1.x E2E Tests / TypeScript SDK Compatibility V1.x E2E Tests Node ${{matrix.node_version}} (push) Has been cancelled
TypeScript SDK E2E Tests / TypeScript SDK E2E Tests Node ${{matrix.node_version}} (push) Has been cancelled
Opik Optimizer - E2E Tests / build-opik (push) Has been cancelled
TypeScript SDK Compatibility V1.x E2E Tests / build-opik (push) Has been cancelled
Python SDK E2E Tests / Select Python version matrix (push) Has been cancelled
Python SDK E2E Tests / Python SDK E2E Tests ${{matrix.python_version}} (push) Has been cancelled
Python SDK E2E Tests / build-opik (push) Has been cancelled
Python SDK Compatibility V1.x E2E Tests / Select Python version matrix (push) Has been cancelled
Python SDK Compatibility V1.x E2E Tests / Python SDK Compatibility V1.x E2E Tests ${{matrix.python_version}} (push) Has been cancelled
Python SDK Compatibility V1.x E2E Tests / build-opik (push) Has been cancelled
TypeScript SDK E2E Tests / Select Node version matrix (push) Has been cancelled
TypeScript SDK E2E Tests / build-opik (push) Has been cancelled
Opik Optimizer - E2E Tests / Opik Optimizer E2E Tests Python ${{matrix.python_version}} (push) Has been cancelled
Opik Optimizer - E2E Tests / Opik Optimizer Integration Smoke Tests (push) Has been cancelled
🐙 Code Quality / detect (push) Has been cancelled
🐙 Code Quality / lint (${{ matrix.leg.name }}) (push) Has been cancelled
🐙 Code Quality / summary (push) Has been cancelled
TypeScript SDK Library Integration Tests / Check Secrets (push) Has been cancelled
TypeScript SDK Library Integration Tests / opik-vercel (Vercel AI SDK / eve) (push) Has been cancelled
SDK Library Integration Tests Runner / Check Secrets (push) Has been cancelled
SDK Library Integration Tests Runner / Missed OpenAI API Key Warning (push) Has been cancelled
SDK Library Integration Tests Runner / Build (push) Has been cancelled
SDK Library Integration Tests Runner / openai_tests (push) Has been cancelled
SDK Library Integration Tests Runner / langchain_tests (push) Has been cancelled
SDK Library Integration Tests Runner / langchain_legacy_tests (push) Has been cancelled
SDK Library Integration Tests Runner / llama_index_tests (push) Has been cancelled
SDK Library Integration Tests Runner / anthropic_tests (push) Has been cancelled
SDK Library Integration Tests Runner / mistral_tests (push) Has been cancelled
SDK Library Integration Tests Runner / groq_tests (push) Has been cancelled
SDK Library Integration Tests Runner / aisuite_tests (push) Has been cancelled
SDK Library Integration Tests Runner / haystack_tests (push) Has been cancelled
SDK Library Integration Tests Runner / dspy_tests (push) Has been cancelled
SDK Library Integration Tests Runner / crewai_v0_tests (push) Has been cancelled
SDK Library Integration Tests Runner / crewai_v1_tests (push) Has been cancelled
SDK Library Integration Tests Runner / genai_tests (push) Has been cancelled
SDK Library Integration Tests Runner / adk_tests (push) Has been cancelled
SDK Library Integration Tests Runner / adk_legacy_1_3_0_tests (push) Has been cancelled
SDK Library Integration Tests Runner / evaluation_metrics_tests (push) Has been cancelled
SDK Library Integration Tests Runner / bedrock_tests (push) Has been cancelled
SDK Library Integration Tests Runner / litellm_tests (push) Has been cancelled
SDK Library Integration Tests Runner / harbor_tests (push) Has been cancelled
SDK Library Integration Tests Runner / Slack Notification (push) Has been cancelled
Lint Opik Helm Chart / render-equality (push) Has been cancelled
Opik Optimizer - Unit Tests / Opik Optimizer Unit Tests Python ${{matrix.python_version}} (push) Has been cancelled
Python BE E2E Tests / Python BE E2E (push) Has been cancelled
Python Backend Tests / run-python-backend-tests (push) Has been cancelled
Python SDK Unit Tests / Python SDK Unit Tests ${{matrix.python_version}} (push) Has been cancelled
Release Drafter / update_release_draft (push) Has been cancelled
SDK E2E Libraries Integration Tests / Check Secrets (push) Has been cancelled
SDK E2E Libraries Integration Tests / Missed OpenAI API Key Warning (push) Has been cancelled
SDK E2E Libraries Integration Tests / build-opik (push) Has been cancelled
SDK E2E Libraries Integration Tests / E2E Lib Integration Python ${{matrix.python_version}} (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-gemini) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-langchain) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-openai) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-otel) (push) Has been cancelled
TypeScript SDK Integration Build & Publish / build-and-publish (opik-vercel) (push) Has been cancelled
TypeScript SDK Build & Publish / build-and-publish (push) Has been cancelled
TypeScript SDK Unit Tests / Test on Node ${{ matrix.node-version }} (push) Has been cancelled
Backend Tests / discover-tests (push) Has been cancelled
Backend Tests / ${{ matrix.name }} (push) Has been cancelled
Build and Publish SDK / build-and-publish (push) Has been cancelled
Build Opik Docker Images / set-version (push) Has been cancelled
Build Opik Docker Images / build-backend (push) Has been cancelled
Build Opik Docker Images / build-sandbox-executor-python (push) Has been cancelled
Build Opik Docker Images / build-python-backend (push) Has been cancelled
Build Opik Docker Images / build-frontend (push) Has been cancelled
Build Opik Docker Images / create-git-tag (push) Has been cancelled
ClickHouse Migration Cluster Check / validate-clickhouse-migrations (push) Has been cancelled
Docs - Publish / run (push) Has been cancelled
E2E Tests - Post Merge (v2) / 🧪 E2E v2 Tests (${{ github.event.inputs.tier || 't1' }}) (push) Has been cancelled
E2E Tests - Post Merge (v2) / 📢 Slack Notification (push) Has been cancelled
Frontend Unit Tests / Test on Node 20 (push) Has been cancelled
Guardrails E2E Tests / Select Python version matrix (push) Has been cancelled
Guardrails E2E Tests / Guardrails E2E Tests ${{matrix.python_version}} (push) Has been cancelled
Guardrails E2E Tests / 📢 Slack Notification (push) Has been cancelled
Guardrails Backend Unit Tests / Guardrails Backend Unit Tests (push) Has been cancelled
Guardrails Backend Unit Tests / 📢 Slack Notification (push) Has been cancelled
Lint Opik Helm Chart / lint-helm-chart (Helm v3.21.0) (push) Has been cancelled
Lint Opik Helm Chart / lint-helm-chart (Helm v4.2.0) (push) Has been cancelled
Lint Opik Helm Chart / unittest-helm-chart (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:25:44 +08:00

39 KiB
Raw Blame History

Примечание: Этот файл был переведен автоматически. Улучшения перевода приветствуются!

Логотип Comet Opik
Опик

Наблюдение, оценка и оптимизация ИИ с открытым исходным кодом

Opik помогает вам создавать, тестировать и оптимизировать приложения генеративного искусственного интеллекта, которые будут работать лучше, от прототипа до производства. От чат-ботов RAG до помощников по написанию кода и сложных агентских систем — Opik обеспечивает комплексное отслеживание, оценку, а также автоматические подсказки и оптимизацию инструментов, чтобы исключить догадки при разработке ИИ.

Python SDK Лицензия Build

Веб-сайтСообщество SlackТвиттерЖурнал измененийДокументация


Скриншот платформы Opik (миниатюра)

🚀 Что такое Опик?

Opik (созданный Comet) — это платформа с открытым исходным кодом, предназначенная для оптимизации всего жизненного цикла приложений LLM. Это дает разработчикам возможность оценивать, тестировать, отслеживать и оптимизировать свои модели и агентные системы. Ключевые предложения включают в себя:

  • Комплексное наблюдение: глубокое отслеживание звонков LLM, регистрация разговоров и активности агентов.
  • Расширенная оценка: надежная оперативная оценка, LLM в качестве судьи и управление экспериментом.
  • Готовность к производству: масштабируемые панели мониторинга и онлайн-правила оценки для производства.
  • Оптимизатор агента Opik: специальный SDK и набор оптимизаторов для улучшения подсказок и агентов.
  • Opik Guardrails: функции, которые помогут вам реализовать безопасные и ответственные методы работы с искусственным интеллектом.

Ключевые возможности включают в себя:

  • Разработка и отслеживание:

  • Отслеживайте все вызовы и трассировки LLM с подробным контекстом во время разработки и производства (Quickstart).

  • Обширная интеграция сторонних разработчиков для удобства наблюдения: плавная интеграция с постоянно растущим списком платформ, встроенная поддержка многих крупнейших и самых популярных из них (включая недавние дополнения, такие как Google ADK, Autogen и Flowise AI). (Интеграции)

  • Аннотируйте трассировки и интервалы с помощью оценок обратной связи с помощью Python SDK или UI.

  • Экспериментируйте с подсказками и моделями на Площадке подсказок.

  • Оценка и тестирование:

  • Автоматизируйте оценку заявки на получение LLM с помощью Datasets и Эксперименты.

  • Используйте мощные показатели LLM в качестве судьи для сложных задач, таких как обнаружение галлюцинаций, модерация и оценка RAG (Ответить Релевантность, Контекст Точность).

  • Интегрируйте оценки в свой конвейер CI/CD с помощью нашей интеграции PyTest.

  • Мониторинг и оптимизация производства:

  • Регистрируйте большие объемы производственных трассировок: Opik рассчитан на масштабирование (более 40 млн трассировок в день).

  • Отслеживайте оценки отзывов, количество трассировок и использование токенов с течением времени на панели управления Opik.

  • Используйте Правила онлайн-оценки с показателями LLM-as-a-Judge для выявления производственных проблем.

  • Используйте Opik Agent Optimizer и Opik Guardrails для постоянного улучшения и защиты ваших приложений LLM в производстве.

Tip

Если вы ищете функции, которых сегодня нет в Opik, создайте новый Запрос на функцию 🚀


🛠️ Установка сервера Opik

Запустите свой сервер Opik за считанные минуты. Выберите вариант, который лучше всего соответствует вашим потребностям:

Вариант 1: Облако Comet.com (самый простой и рекомендуемый)

Получите доступ к Opik мгновенно, без какой-либо настройки. Идеально подходит для быстрого запуска и простого обслуживания.

👉 Создайте бесплатную учетную запись Comet

Вариант 2: Самостоятельное размещение Opik для полного контроля

Разверните Opik в своей среде. Выбирайте между Docker для локальных настроек или Kubernetes для масштабируемости.

Самостоятельный хостинг с Docker Compose (для локальной разработки и тестирования)

Это самый простой способ запустить локальный экземпляр 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 теперь поддерживают профили сервисов для разных сценариев разработки:

# 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

Используйте параметры --help или --info для устранения проблем. Dockerfiles теперь обеспечивает запуск контейнеров от имени пользователя без полномочий root для повышения безопасности. Когда все будет готово, вы можете посетить localhost:5173 в своем браузере! Подробные инструкции см. в Руководстве по локальному развертыванию.

Самостоятельный хостинг с Kubernetes и Helm (для масштабируемых развертываний)

Для производственных или крупномасштабных локальных развертываний Opik можно установить в кластере Kubernetes с помощью нашей диаграммы Helm. Нажмите на значок, чтобы просмотреть полное Руководство по установке Kubernetes с помощью Helm.

Kubernetes

Important

Изменения в версии 1.7.0: проверьте журнал изменений на наличие важных обновлений и критических изменений.

💻 Клиентский SDK Opik

Opik предоставляет набор клиентских библиотек и REST API для взаимодействия с сервером Opik. Сюда входят SDK для Python, TypeScript и Ruby (через OpenTelemetry), обеспечивающие плавную интеграцию в ваши рабочие процессы. Подробные ссылки на API и SDK см. в Справочной документации по клиенту Opik.

Python SDK: быстрое начало работы

Чтобы начать работу с Python SDK:

Установите пакет:

# install using pip
pip install opik

# or install with uv
uv pip install opik

Настройте SDK Python, выполнив команду opik configure, которая запросит у вас адрес сервера Opik (для автономных экземпляров) или ключ API и рабочую область (для Comet.com):

opik configure

Tip

Вы также можете вызвать opik.configure(use_local=True) из своего кода Python, чтобы настроить SDK для запуска на локальной локальной установке, или предоставить ключ API и сведения о рабочей области непосредственно для Comet.com. Дополнительные параметры конфигурации см. в документации Python SDK.

Теперь вы готовы начать регистрацию трассировок с помощью Python SDK.

📝 Регистрация трассировок с помощью интеграций

Самый простой способ регистрировать трассировки — использовать одну из наших прямых интеграций. Opik поддерживает широкий спектр платформ, включая недавние дополнения, такие как Google ADK, Autogen, AG2 и Flowise AI:

Интеграция Описание Документация
АДК Журнал трассировки для пакета разработки агента Google (ADK) Документация
АГ2 Журнал трассировки вызовов AG2 LLM Документация
AIлюкс Журнал трассировки вызовов aisuite LLM Документация
Агно Записывать в журнал вызовы инфраструктуры оркестрации агентов Agno Документация
Антропный Журнал трассировки вызовов Anthropic LLM Документация
Автоген Журнал трассировки для агентских рабочих процессов Autogen Документация
Коренная порода Журнал трассировки вызовов Amazon Bedrock LLM Документация
BeeAI (Python) Журнал трассировки вызовов среды агента BeeAI Python Документация
BeeAI (TypeScript) Журнал трассировки вызовов структуры агента BeeAI TypeScript Документация
БайтПлюс Журнал трассировки вызовов BytePlus LLM Документация
Рабочие Cloudflare AI Журнал трассировки вызовов AI Cloudflare Workers Документация
Согласовано Журнал трассировки вызовов Cohere LLM Документация
CrewAI Журнал трассировки вызовов CrewAI Документация
Курсор Журнал трассировки разговоров с курсором Документация
ДипСик Журнал трассировки вызовов DeepSeek LLM Документация
Диди Журнал трассировки запусков агента Dify Документация
ДСПИ Журнал трассировки запусков DSPy Документация
Фейерверк ИИ Журнал трассировки вызовов Fireworks AI LLM Документация
Флоуиз ИИ Журнал трассировки для визуального конструктора LLM Flowise AI Документация
Близнецы (Питон) Журнал отслеживания звонков Google Gemini LLM Документация
Близнецы (TypeScript) Журнал трассировки вызовов Google Gemini TypeScript SDK Документация
Грок Журнал отслеживания вызовов Groq LLM Документация
Ограждения Журнал трассировки проверок Guardrails AI Документация
стог сена Журнал трассировки вызовов Haystack Документация
гавань Журналы оценочных испытаний производительности Harbour Документация
Инструктор Записывайте журналы вызовов LLM, сделанных с помощью Instructor Документация
Лангчейн (Python) Журнал трассировки вызовов LangChain LLM Документация
Лангчейн (JS/TS) Журнал трассировки вызовов LangChain JavaScript/TypeScript Документация
Лангграф Журнал трассировки выполнения LangGraph Документация
Лангфлоу Трассировки журналов для визуального конструктора искусственного интеллекта Langflow Документация
ЛайтLLM Журнал трассировки вызовов модели LiteLLM Документация
Агенты LiveKit Журнал трассировки вызовов среды AI-агента LiveKit Agents Документация
ЛамаИндекс Журнал трассировки вызовов LlamaIndex LLM Документация
Мастра Журнал трассировки вызовов среды рабочих процессов Mastra AI Документация
Microsoft Agent Framework (Python) Журнал трассировки вызовов Microsoft Agent Framework Документация
Microsoft Agent Framework (.NET) Журнал трассировки вызовов Microsoft Agent Framework .NET Документация
Мистраль ИИ Журнал отслеживания вызовов Mistral AI LLM Документация
н8н Трассировки журналов выполнения рабочих процессов n8n Документация
Новита АИ Журнал отслеживания звонков Novita AI LLM Документация
Оллама Журнал отслеживания звонков Ollama LLM Документация
OpenAI (Python) Журнал трассировки вызовов OpenAI LLM Документация
OpenAI (JS/TS) Журнал трассировки вызовов OpenAI JavaScript/TypeScript Документация
Агенты OpenAI Журнал трассировки вызовов OpenAI Agents SDK Документация
OpenClaw Журнал трассировки запусков агентов OpenClaw Документация
OpenRouter Журнал трассировки вызовов OpenRouter LLM Документация
Открытая телеметрия Журнал трассировки вызовов, поддерживаемых OpenTelemetry Документация
OpenWebUI Журнал трассировки диалогов OpenWebUI Документация
Трубка Журнал трассировки вызовов голосового агента Pipecat в реальном времени Документация
Предибаза Журнал трассировки вызовов Predibase LLM Документация
Пидантический ИИ Журнал трассировки вызовов агента PydanticAI Документация
Раги Журнал трассировки оценок Ragas Документация
Семантическое ядро ​​ Журнал трассировки вызовов семантического ядра Microsoft Документация
Смолагенты Следы журналов для агентов Смолагентс Документация
Весенний ИИ Журнал трассировки вызовов среды Spring AI Документация
Агенты прядей Журнал трассировки вызовов агентов Strands Документация
Вместе ИИ Записывать в журнал звонки Together AI LLM Документация
Vercel AI SDK Журнал трассировки вызовов Vercel AI SDK Документация
ВольтАгент Журнал трассировки вызовов инфраструктуры агента VoltAgent Документация
ВатсонX Журнал трассировки вызовов IBM watsonx LLM Документация
xAI Грок Журнал трассировки вызовов xAI Grok LLM Документация

Tip

Если используемая вами платформа не указана выше, смело откройте вопрос или отправьте запрос на интеграцию.

Если вы не используете ни одну из вышеперечисленных платформ, вы также можете использовать декоратор функции 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"

Tip

Декоратор треков можно использовать в сочетании с любой из наших интеграций, а также для отслеживания вызовов вложенных функций.

🧑‍⚖️ LLM как метрика судьи

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 также включает в себя ряд готовых эвристических показателей, а также возможность создавать свои собственные. Подробную информацию об этом можно найти в документации по метрикам.

🔍 Оценка ваших заявок на получение степени LLM

Opik позволяет вам оценить ваше приложение LLM во время разработки через Datasets и Эксперименты. Панель мониторинга Opik предлагает расширенные диаграммы для экспериментов и улучшенную обработку больших кривых. Вы также можете запускать оценки в рамках своего конвейера CI/CD, используя нашу интеграцию PyTest.

Отметьте нас на GitHub

Если вы найдете Opik полезным, поставьте нам звезду! Ваша поддержка помогает нам расширять наше сообщество и продолжать совершенствовать продукт.

Диаграмма звездной истории

🤝 Вносим свой вклад

Есть много способов внести свой вклад в Opik:

Чтобы узнать больше о том, как внести свой вклад в Opik, ознакомьтесь с нашими рекомендациями по участию.