Comet-ML/Opik-MCP

List Opik entities with optional filters and pagination. Output is a pipe-delimited table with id, name, and a few entity-specific columns, plus a pagination footer when more pages exist. When filters apply, the first line echoes what was applied. Use read() to get full details on any specific item. Project-scoped types require their parent: - trace: project_id or project_name - span: project_id or project_name (searches spans across the project) - thread: project_id or project_name - agent_insights_issue: project_id or project_name (Diagnostics issues, open ones by default; columns: severity, status, total_occurrences, latest_count, last_seen) - test_suite_item: test_suite_id - prompt_version: prompt_id Workspace-wide types (project, experiment, prompt, test_suite) accept an optional name substring filter. trace, span, thread, experiment accept an OQL filters string and a sort; trace, span, thread also take a since/until window and free-text search.

Read any Opik entity by ID, name, or opik:// URI, with adaptive compression. Prefer a UUID for id — it's faster (single API call) and unambiguous. Name lookup is available for: project, experiment, prompt, test_suite — name lookup is slower (two API calls) and may return multiple matches, in which case the tool lists the candidates so you can retry with the correct ID. Special shapes: - trace: returns {trace, spans, spansTruncated} with up to 200 spans inlined. - prompt: returns {prompt, versions, versionsTruncated} with up to 100 versions. - thread: returns {thread, messages, messagesTruncated} — each message is one turn's trace input/output + a trace_id to read('trace', id). Needs project scope: pass a thread link/URI, or project_id/project_name. - agent_insights_issue: returns {issue, example_trace_ids, details, url, trace_url_template} — the Diagnostics issue with cause and suggested fix, the deduped ids of traces that exhibit it (open one with read('trace', id)), the per-day breakdown, the issue's Diagnostics page link, and a template for linking any example trace (both links omitted when the Opik URL or the session's workspace is unknown). Needs project scope like thread. - All others: the flat record from /v1/private/{entity}/{id}. Output is a one-line [read: …] header (entity_type, id, compression tier, returned tokens, full tokens) followed by compact JSON.

Загружает один агентный навык Opik - те же навыки, которые Opik публикует для кодинг-агентов. Используй его, когда нужного навыка ещё нет в контексте. КОГДА ВЫЗЫВАТЬ: перед тем как инструментировать, оценивать или отлаживать с Opik, когда соответствующий навык из списка ниже ещё НЕ загружен: в проекте нет локальной копии, и ничего не загружалось ранее в этой сессии. Если он уже есть, читай то, что есть, а не загружай заново. Сопоставь задачу пользователя с навыком: - opik: «почему мои трейсы не отображаются», «как добавить метаданные в спан», «как версионировать промпт» - любые запросы по SDK. Чтобы проинструментировать код, используй opik-instrument. - opik-diagnose: «что сломано в проде», «какие трейсы требуют внимания», «найди падающие или медленные трейсы», «проведи триаж моего агента». - opik-evaluate: пользователь хочет измерить или улучшить качество AI-продукта либо спрашивает про эвалы, джуджи или метрики оценки. - opik-explain: «почему этот трейс упал», «объясни этот трейс», «найди проблему в этом трейсе», «почему мой агент медленный или ошибается». - opik-instrument: «проинструментируй мой код», «добавь трейсинг Opik», «добавь наблюдаемость», «добавь трейсинг моему агенту». skill_name принимает любую из этих форм: - opik - сам навык - opik/references/tracing-python.md - один документ внутри навыка - opik://skills/opik/SKILL.md - тот же документ по его resource URI, как перечислено в resources/list Читаемые пути, с префиксом из имени навыка, как указано выше: - opik: SKILL.md, references/agent-patterns.md, references/best-practices.md, references/evaluation-datasets.md, references/evaluation-test-suites.md, references/integrations.md, references/observability.md, references/production.md, references/tracing-python.md, references/tracing-rest-api.md, references/tracing-typescript.md - opik-diagnose: SKILL.md - opik-evaluate: SKILL.md, references/error-analysis.md, references/eval-audit.md, references/evaluate-rag.md, references/generate-synthetic-data.md, references/validate-evaluator.md, references/write-judge-prompt.md - opik-explain: SKILL.md - opik-instrument:…

Return the JSON Schema, OAuth scope, and one validated example for a write operation's data payload, or — for list.trace / list.span / list.thread / list.experiment — the list tool's filterable fields with their operators and its sortable fields. Pure lookup — no backend call.

Создаёт, обновляет или аннотирует сущности Opik. Поле operation выбирает, какую пару сущность/действие вызвать; data содержит полезную нагрузку для этой операции (один объект или массив до 1000 для пакетной обработки). Операции: - trace.create: Регистрирует один trace (или пакет). Устанавливает родителя для spans/scores/comments. (пакет разрешён) - trace.update: Завершает или изменяет существующий trace по id. (пакет разрешён) - span.create: Регистрирует один span на существующем trace (или пакет); обязательно: trace_id (пакет разрешён) - score.create: Прикрепляет числовую оценку обратной связи к trace, span или thread; обязательно: target, target_id (пакет разрешён) - comment.create: Прикрепляет текстовый комментарий к trace, span или thread; обязательно: target, target_id - prompt_version.save: Сохраняет новую версию prompt. Создаёт prompt по имени, ели отсутствует; BE автоматически назначает commit, если он опущен. - test_suite.create: Создаёт тестовый набор Opik 2.0 (набор для оценки). Путь BE остаётся /v1/private/datasets для обратной совместимости; диспетчер вставляет type='evaluation_suite' в запрос. - test_suite_item.upsert: Выполняет upsert элементов в тестовый набор. Всегда передавайте конверт {test_suite_name|test_suite_id, items: [...]}; обязательно: test_suite_name, test_suite_id - experiment.create: Создаёт эксперимент в рамках тестового набора; обязательно: test_suite_name, test_suite_id - experiment_item.create: Прикрепляет строки trace и dataset_item к експерименту. Всегда конверт-массив; обязательно: experiment_id, test_suite_item_id, trace_id (пакет разрешён) - thread.close: Закрывает thread (помечает как неактивный/завершённый). Передайте thread_id + project (project_name или project_id). - thread.open: Открывает ранее закрытый thread (помечает как активный). Передайте thread_id + project (project_name или project_id). Примечания: - Форма data: объект для одиночного, массив для пакетной обраотки (где подерживается). Операции, всегда требующие конверта (test_suite_item.upsert, experiment_item.create), принимают свой список внутри конверта, а не на верхнем уровне. - dry_run=true: проверяет корректность и авторизацию, не вызывая бэкенд.