AIKraft/AI/Войти
AIKraft/Skills/google-agents-cli-observability

google-agents-cli-observability

Настройка трассировки, логирования и мониторинга для ADK-агентов через Cloud Trace, BigQuery и сторонние платформы (AgentOps, Phoenix). Пригодится для отладки, анализа производительности и аудита взаимодействия с LLM.

GOGoogle official Разработка ★ 6k

Что делает навык

Настройка трассировки, логирования и мониторинга для ADK-агентов через Cloud Trace, BigQuery и сторонние платформы (AgentOps, Phoenix). Позволяет отлаживать взаимодействие с LLM, анализировать производительность и проводить аудит запросов.

Когда применять

  • Отладка потока выполнения агента и вызовов инструментов с помощью распределенной трассировки Cloud Trace.
  • Анализ структуры событий агента и генеративных взаимодействий через BigQuery Agent Analytics.
  • Интеграция с внешними системами мониторинга, такими как AgentOps, Phoenix, MLflow, Weave, Freeplay.
  • Аудит приватности данных при логировании запросов и ответов (prompt-response logging).

Как работает

  1. Для использования Cloud Trace инфраструктура не требуется, трассировка работает автоматически через OpenTelemetry.
  2. Для логирования и аналитики запустить `agents-cli infra single-project --apply --project PROJECT_ID` для создания сервисного аккаунта, бакета GCS и датасета BigQuery.
  3. Выполнить развертывание агента командой `agents-cli deploy` (или `agents-cli deploy .`).
  4. При использовании Terraform-управляемой инфраструктуры сначала применить инфраструктуру, затем развернуть агента; при императивном развертывании вручную настроить IAM-роли и переменные окружения.

Примеры запросов агенту

Настрой трассировку и логирование для моего ADK-агента в проекте Google Cloud.
Как включить BigQuery Agent Analytics для моего агента?
Проверь, правильно ли настроено логирование запросов и ответов в GCS.

Что понадобится

  • Инструменты: agents-cli, Terraform.
  • Окружение: Google Cloud Project, Python (для GCS completion upload и BigQuery Agent Analytics plugin), Go (для BigQuery telemetry stack).

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «google-agents-cli-observability» из репозитория: # https://github.com/google/agents-cli
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r google-agents-cli-observability/ ~/.claude/skills/google-agents-cli-observability/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.