# opik

Справочник по Opik SDK 2.x для трассировки LLM, спанов, версионирования промптов и интеграций с фреймворками.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 528 установок · ★ 8
- Автор: comet-ml
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/comet-ml/opik-skills/tree/HEAD/skills/opik/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/opik

## Что делает

Скилл содержит документацию и сигнатуры вызовов для Python и TypeScript SDK Opik 2.x. Он подсказывает агенту четыре допустимых типа спанов: `general`, `llm`, `tool` и `guardrail`. Также внутри описаны готовые интеграции для OpenAI, Anthropic, LangChain, DSPy и CrewAI.

Справочник закрывает частые ошибки интеграций. Например, при работе с LiteLLM под декоратором `@opik.track` обязательно передавать `current_span_data` в метаданных, иначе трейсы оторвутся от родительского спана. В коде на Python после вызовов нужен `opik.flush_tracker()`.

Для чтения самого справочника подключение к серверу Opik не требуется. Если подключён MCP, скилл даёт синтаксис OQL-фильтров и вызовы для просмотра метрик проекта, ошибок и длительности за 7 или 30 дней.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/opik/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/opik/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/opik/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/opik/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install comet-ml/opik-skills opik
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/opik/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/comet-ml/opik-skills --path skills/opik
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/opik/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add comet-ml/opik-skills --skill opik -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/comet-ml/opik-skills/tree/HEAD/skills/opik/SKILL.md

## Когда брать
- найти правильный тип спана для вызова модели или инструмента
- настроить трекинг вызовов в Python и TypeScript
- связать трейсы LiteLLM с родительским спаном
- версионировать промпты с привязкой модели и температуры
- составить OQL-запрос для поиска медленных или упавших трейсов

## Примеры запросов агенту
- Покажи, как обернуть вызов OpenAI через трекер Opik в Python.
- Как правильно настроить thread_id для чат-сессии в Opik?
- Напиши OQL-фильтр для поиска трейсов с ошибками длительностью более 5 секунд.

## Похожие
- [Comet Opik](https://affpapa.org/nevibecode/agents/comet-opik.md) — субагент · ★ 40451
- [arize-link](https://affpapa.org/nevibecode/skills/arize-link.md) — скилл · 1100 установок
- [mastra](https://affpapa.org/nevibecode/skills/mastra.md) — скилл · 83000 установок
- [agent-observability-replay-trace](https://affpapa.org/nevibecode/skills/agent-observability-replay-trace.md) — скилл · 399 установок
- [agent-evaluation](https://affpapa.org/nevibecode/skills/mlflow-agent-evaluation.md) — скилл · 1100 установок
- [logfire-instrumentation](https://affpapa.org/nevibecode/skills/logfire-instrumentation.md) — скилл · 2300 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md