# Comet Opik

Субагент для GitHub Copilot, который подключает Opik через MCP: версионирует промпты, разбирает трейсы и метрики LLM-приложений.

- субагент · `type=agent` · GitHub Copilot · ★ 40451
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/agents/comet-opik.agent.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/agents/comet-opik

## Что делает

Агент работает как специалист по Comet Opik внутри репозитория. Он подключает клиент Opik к вашему коду, ведёт учёт промптов и их версий, разбивает телеметрию по проектам и разбирает трейсы, метрики и эксперименты. Бизнес-логику он не трогает — добавляет только импорты, трейсеры и middleware.

Внутри — MCP-сервер `opik`, который Copilot запускает командой `npx -y opik-mcp`. Для запуска нужен Node.js версии 20.11 или выше и `npx`. Ключ и рабочее пространство берутся из `~/.opik.config`, который создаёт `opik configure`, либо из переменных `COPILOT_MCP_OPIK_*`. Без рабочего ключа и настроенного конфига MCP-команды не отработают, поэтому сначала подтвердите один из этих путей.

Для инструментирования агент вызывает `opik-integration-docs` и идёт по восьми шагам: проверка языка, сканирование репозитория, выбор способа интеграции, разбор, согласование плана, внедрение, проверка пользователем и отладка. Промпты каталогизируются через `get-prompts`, `create-prompt` и `save-prompt-version`. После деплоя `list-traces` показывает покрытие, `get-trace-by-id` разбирает аномалии, а `get-metrics` проверяет задержку P95, стоимость запроса и долю успешных вызовов. История репозитория остаётся нетронутой: агент не делает `git init`, `git add` и `git commit`.

## Установка

### GitHub Copilot (родная платформа)

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

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/comet-opik.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/comet-opik.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

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

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

## Когда брать
- подключить Opik к LLM-приложению без правок бизнес-логики
- пронумеровать версии продакшн-промптов и связать их с деплоями
- разложить телеметрию по проектам и окружениям
- найти аномалию в трейсе после релиза
- сверить задержку P95 и стоимость запроса перед выкаткой

## Примеры запросов агенту
- Подключи Opik к этому сервису и покажи план интеграции
- Сохрани новую версию промпта из `prompts/chat.md` и опиши изменения
- Проверь трейсы после последнего деплоя и найди всплеск ошибок

## Похожие
- [opik](https://affpapa.org/nevibecode/skills/opik.md) — скилл · 528 установок
- [built-in-metrics](https://affpapa.org/nevibecode/skills/built-in-metrics.md) — скилл · 1800 установок
- [agent-observability-trace-rca](https://affpapa.org/nevibecode/skills/agent-observability-trace-rca.md) — скилл · 552 установки
- [future-agi-platform](https://affpapa.org/nevibecode/skills/future-agi-platform.md) — скилл · 308 установок
- [langfuse](https://affpapa.org/nevibecode/skills/langfuse-langfuse.md) — скилл · 19900 установок
- [app-observability](https://affpapa.org/nevibecode/skills/app-observability.md) — скилл · 4400 установок

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 949 карточек

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

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