bigquery-agent-analytics-sdk — скилл для Claude Code: аналитика
Скилл для разбора телеметрии ИИ-агентов в BigQuery: восстановление трейсов, оценка через LLM-судью, поиск дрейфа поведения.
npx skills add reason-machines/data-skills --skill bigquery-agent-analytics-sdk -a claude-codeЧто делает bigquery-agent-analytics-sdk
Скилл ставит в проект Python-тулкит bigquery-agent-analytics. Он читает события агентов из BigQuery, собирает из них трейсы и рисует их как ASCII-DAG. Есть разбор семантики событий: старт агента, вызов инструмента, обращение к LLM, финал.
Внутри — клиент Client с методами get_trace, get_traces_for_session и выборкой по диапазону времени, менеджер вьюх ViewManager для разбивки событий по типам, оценщики SystemEvaluator и LLM-as-Judge, а также CLI bqaa с командами диагностики, оценки и построения Agent Context Graph. Периодическую материализацию графа можно повесить на расписание — команда создаёт Cloud Scheduler и Cloud Run.
Заранее нужен Python 3.10+, проект Google Cloud с включённым BigQuery и сами трейсы в BigQuery. Доступ настраивается через GOOGLE_APPLICATION_CREDENTIALS или gcloud auth application-default login. Без этого клиент не подключится к датасету, поэтому проверьте доступ до первого запуска.
Какие задачи решает
- собрать трейсы агента из событий BigQuery в один читаемый граф
- оценить ответы агента через LLM-судью по заданным критериям
- сравнить фактический путь выполнения с эталонным
- заметить дрейф в поведении агента за период
- вытащить решения агента из контекстного графа
Примеры запросов агенту
- покажи трейс trace-abc-123 и отрендери его как DAG
- запусти оценку llm-judge по критериям correctness и hallucination
- сравни траектории с эталонным путём plan,execute,verify
Как установить bigquery-agent-analytics-sdk
1Через Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill bigquery-agent-analytics-sdk -a claude-code2Вручную: положить файлы
~/.claude/skills/bigquery-agent-analytics-sdk/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/bigquery-agent-analytics-sdk/
1Через Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill bigquery-agent-analytics-sdk -a codex2Вручную: положить файлы
.agents/skills/bigquery-agent-analytics-sdk/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill bigquery-agent-analytics-sdk -a cursor2Вручную: положить файлы
.cursor/skills/bigquery-agent-analytics-sdk/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install reason-machines/data-skills bigquery-agent-analytics-sdk2Вручную: положить файлы
.github/skills/bigquery-agent-analytics-sdk/SKILL.md1Через Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill bigquery-agent-analytics-sdk -a gemini-cli2Командой платформы
gemini skills install https://github.com/reason-machines/data-skills --path skills/bigquery-agent-analytics-sdkВручную: положить файлы
.devin/skills/bigquery-agent-analytics-sdk/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add reason-machines/data-skills --skill bigquery-agent-analytics-sdk -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о bigquery-agent-analytics-sdk
Как установить bigquery-agent-analytics-sdk в Claude?
Выполните npx skills add reason-machines/data-skills --skill bigquery-agent-analytics-sdk -a claude-code. Скилл появится в ~/.claude/skills/bigquery-agent-analytics-sdk/SKILL.md.
Что делает bigquery-agent-analytics-sdk?
Разбирает телеметрию ИИ-агентов в BigQuery: восстанавливает трейсы, строит вьюхи по типам событий, запускает оценку и извлекает решения из контекстного графа.
Что нужно для работы скилла?
Python 3.10+, проект Google Cloud с BigQuery и трейсы агентов в BigQuery. Доступ настраивается через GOOGLE_APPLICATION_CREDENTIALS или gcloud auth application-default login.
