Навыки ИИ-агента Google Аналитики

Чтобы создавать интеграции для отчетов и управления ресурсами Google Аналитики с более высокой точностью и меньшими затратами токенов, добавьте в свой ИИ-агент для программирования навыки ИИ-агента Google Аналитики. Навыки ИИ-агента Google Аналитики предназначены для разработчиков, которые используют Google Analytics Data API и Google Analytics Admin API. Это переносимые автономные модули инструкций, рабочих процессов и ссылок на клиентские библиотеки.

Эти навыки ИИ-агентов работают с ИИ-агентами для программирования, которые поддерживают стандарт open Agent Skills, включая Google Antigravity, Claude Code, Codex и Cursor. Список опубликованных навыков приведен в разделе Доступные навыки.

Подготовка

Прежде чем устанавливать и запускать навыки ИИ-агента Google Аналитики, выполните следующие действия:

  • Установите ИИ-агента для программирования, который поддерживает стандарт open Agent Skills, например Google Antigravity, Claude Code, Codex или Cursor.
  • Установите Node.js, который включает команду npx для установки и обновления навыков из командной строки.
  • Создайте или выберите проект с доступом к ресурсу Google Аналитики при выполнении рабочих процессов API.

Начать

Устанавливайте, обновляйте и вызывайте навыки ИИ-агента Google Аналитики в своей среде разработки.

Как установить навыки ИИ-агента Google Аналитики

Установите набор навыков Google Аналитики в каталог проекта с помощью команды npx или настройте редактор напрямую:

Antigravity

Выполните следующую команду в каталоге проекта:

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

Выполните следующую команду в каталоге проекта:

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

Выполните следующую команду в каталоге проекта:

npx skills add google/skills/skills/analytics --agent=codex

Курсор

Добавьте URL хранилища навыков (https://github.com/google/skills) в настройки редактора в разделе специальных правил. Инструкции можно найти в документации Cursor по установке навыков из GitHub.

Вы также можете установить навыки в каталог проекта с помощью команды npx:

npx skills add google/skills/skills/analytics --agent=cursor

Другие агенты

Для других ИИ-агентов, поддерживающих открытый стандарт Agent Skills, выполните в каталоге проекта следующую команду:

npx skills add google/skills/skills/analytics

Как обновить навыки ИИ-агента Google Аналитики

Скачайте доступные обновления и удалите устаревшие навыки, выполнив следующую команду:

npx skills update --all

Как использовать навыки ИИ-агента Google Аналитики

ИИ-агенты для программирования загружают навыки автоматически, когда обнаруживают, что описание навыка соответствует вашему запросу. Глобально установленные навыки остаются неактивными в несвязанных проектах, если только ваш запрос не касается задач Google Аналитики.

Чтобы вызвать навык вручную в поддерживаемых ИИ-агентах для программирования, введите символ / в поле ввода чата и выберите навык по названию.

Основные компоненты навыка

Каждый навык ИИ-агента Google Аналитики предоставляет вашему ИИ-агенту для программирования следующие компоненты:

  • Специальные инструкции. Пошаговые инструкции по включению Google Аналитики API с помощью gcloud CLI, настройке Application Default Credentials (ADC), созданию запросов runReport и проверке совместимости полей.
  • Рекомендации. Выбор рекомендуемой версии API (конечные точки v1beta для общей стабильности и конечные точки v1alpha для функций Admin API с ранним доступом), создание строго типизированных запросов и рабочие процессы проверки схем.
  • Справочная документация. Руководства по установке клиентских библиотек для разных языков и примеры кода для Python, Java, Node.js, PHP, Go, .NET и Ruby в каталоге references/ каждого навыка.

Преимущества навыков ИИ-агентов

Навыки ИИ-агента расширяют возможности вашего ИИ-агента для программирования, предоставляя ему специализированные знания о Google Аналитике по запросу, без необходимости загружать большие наборы документации в каждый разговор.

Снижение стоимости токенов

Загрузка полной документации по API заранее расходует токены контекста и увеличивает стоимость сеанса. Навыки ИИ-агента используют постепенное раскрытие, чтобы минимизировать использование контекста:

  • При запуске агент ИИ-программирования читает только название и краткое описание каждого навыка, чтобы проверить, соответствует ли он вашему запросу.
  • Агент загружает полные инструкции SKILL.md и справочные файлы для конкретного языка в активное окно контекста, только когда это требуется для выполнения задачи.

Реализация с помощью ИИ

Опишите свою цель обычным языком, и установленные навыки помогут ИИ-агенту выполнить задачи по реализации Google Аналитики, например:

  • Включить Google Analytics Data API в проекте и написать скрипт Python, который запрашивает показатели activeUsers и sessions по параметрам city и date.
  • Проверь, совместим ли параметр itemName с показателями activeUsers и totalRevenue для моего ресурса Google Аналитики, используя метод checkCompatibility.
  • Получите список всех доступных сводок аккаунтов Google Аналитики и дочерних ресурсов в Node.js с помощью Google Analytics Admin API.
  • Настройте специальные параметры, потоки данных и секретные ключи Measurement Protocol для ресурса Google Аналитики.

Как использовать навыки вместе с MCP-сервером Google Аналитики

Навыки ИИ-агента Google Аналитики дополняют сервер Model Context Protocol (MCP) Google Аналитики.

  • Сервер MCP Google Аналитики. Подключает ИИ-агента для программирования напрямую к активным ресурсам Google Аналитики, чтобы агент мог проверять сводки по аккаунту, сведения о ресурсах, специальные параметры, специальные показатели и отчеты в реальном времени.
  • Навыки ИИ-агента Google Аналитики. Предоставляйте эффективные с точки зрения токенов инструкции и ссылки на клиентские библиотеки, которые будут направлять вашего ИИ-агента при включении API, настройке аутентификации ADC, проверке совместимости полей и написании кода приложения.

Доступные навыки

Google поддерживает следующие навыки ИИ-агента Google Аналитики в репозитории google/skills:

Навык Описание
google-analytics-data-api-basics Включает Google Analytics Data API (analyticsdata.googleapis.com) с помощью gcloud CLI, настраивает ADC с областью действия OAuth 2.0 analytics.readonly и устанавливает официальные клиентские библиотеки v1beta (Python, Java, PHP, Node.js, Go, .NET и Ruby). Помогает агенту создавать запросы runReport и проверять совместимость полей с помощью методов getMetadata и checkCompatibility.
google-analytics-admin-api-basics Включает Google Analytics Admin API (analyticsadmin.googleapis.com) с gcloud CLI, настраивает ADC с областями действия OAuth 2.0 analytics.readonly и analytics.edit и устанавливает официальные клиентские библиотеки v1beta и v1alpha (Python, Java, PHP, Node.js, Go, .NET и Ruby). Помогает агенту составлять сводки по аккаунтам и управлять ресурсами, потоками данных, специальными параметрами, специальными показателями, ключевыми событиями, секретными ключами Measurement Protocol и связями с другими продуктами.

Дальнейшие действия