Навыки ИИ-агента Google Ads API

Навыки ИИ-агента Google Ads API – это переносимые автономные модули знаний, инструкций и рабочих процессов, связанных с Google Ads API. Эти навыки работают с ИИ-агентами по программированию, которые поддерживают стандарт Agent Skills, включая Google Antigravity, Claude Code, Codex и Cursor.

Они помогут ИИ-агентам понимать, как лучше всего использовать Google Ads API, настраивать инструменты и выполнять рабочие процессы с большей точностью и меньшими затратами токенов. Список доступных навыков приведен в разделе Доступные навыки.

Начать

Установите навыки ИИ-агента, подходящие для вашей среды разработки.

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

В большинстве случаев вы можете установить навыки ИИ-агента Google Ads API в предпочитаемом редакторе с помощью одной команды:

Antigravity

Навыки ИИ-агента Google Ads API входят в один из пакетов интеграции Build with Google для Antigravity. Вы можете включить этот пакет для доступа на глобальном уровне в двух местах:

  • При регистрации. Установите флажок для стека Google Ads API.
  • В настройках
    1. Выберите Settings (Настройки) > Customizations (Настройки).
    2. В разделе Build with Google Plugins нажмите Customize (Настроить), а затем Download (Скачать) для интеграции Google Ads API.

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

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

Claude Code 

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

Codex 

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

Курсор

Вы можете установить навыки ИИ-агента Google Ads API напрямую, добавив конечную точку репозитория GitHub (например, https://github.com/google/skills) в настройках редактора в разделе специальных правил. Подробную информацию можно найти в документации Cursor по установке навыков из GitHub.

Вы также можете установить навыки с помощью команды npx (требуется Node.js):

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

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

Для других ИИ-агентов, поддерживающих открытый стандарт Agent Skills, вы можете установить навыки с помощью команды npx (требуется Node.js):

npx skills add google/skills/skills/ads

Как изменить навыки ИИ-агента Google Ads API

Чтобы получить все доступные обновления и удалить устаревшие навыки, выполните команду update:

Antigravity

Интеграции, включенные через Build with Google, управляются и обновляются редактором автоматически.

Если вы установили навыки ИИ-агента с помощью команды npx, то можете получить все доступные обновления, выполнив команду update:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Курсор 

npx skills update --all

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

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

npx skills update --all

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

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

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

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

Каждый навык ИИ-агента – это специализированный пакет, который предоставляет ИИ-агенту для программирования следующие компоненты:

  • Специализированные инструкции. Подробные инструкции, которые добавляются в окно контекста и помогают помощнику генерировать запросы GAQL, настраивать учетные данные OAuth и обрабатывать распространенные коды ошибок.
  • Рекомендации. Стандартные рекомендации по эффективности, безопасности и интеграции, разработанные командой Google Ads API DevRel.
  • Скрипты автоматизации. Исполняемые скрипты (например, для проверки среды или настройки рабочей области), включенные в пакеты навыков для выполнения задач на локальном устройстве.

Преимущества использования навыков

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

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

Обычно при интеграции ИИ загружается большой объем документации, что приводит к значительному расходу токенов и увеличению стоимости сеанса. Чтобы минимизировать эти издержки, навыки ИИ-агента используют постепенное раскрытие:

  • Сначала ИИ-помощник проверяет только название и описание навыка, чтобы определить, соответствует ли он вашему запросу.
  • Полные инструкции и справочные материалы добавляются в активное окно контекста, только когда помощник определяет, что они необходимы для выполнения конкретной задачи. Это позволяет экономить место в контексте.

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

Вместо того чтобы вручную искать информацию в документации, вы можете описать свое намерение на естественном языке. Навыки помогают ИИ-помощнику выполнять такие задачи, как:

  • Создай запрос GAQL, чтобы получить показатели эффективности кампании из моего аккаунта.
  • Напишите скрипт на Python, который создает кампанию с помощью клиентских библиотек.
  • Получение данных о конверсиях и диагностических данных кампании с помощью Google Ads API

Полный список доступных навыков приведен в разделе Доступные навыки.

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

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

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

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

Команда Google Ads API предлагает набор навыков для работы с Google Ads API:

Навык Описание
google-ads-api-account-diagnostics Диагностирует проблемы производительности аккаунта Google Рекламы, такие как потеря конверсий, низкий объем лидов и процент потерянных показов из-за рейтинга объявления, ставок или бюджетов, с помощью сервера MCP Google Ads API.
google-ads-api-mcp-setup Помогает настроить сервер протокола контекста модели (MCP) Google Ads API, упрощая аутентификацию и настройку в локальных средах.
google-ads-api-quickstart Пошаговые инструкции по настройке среды разработки, учетных данных и выполнению первого вызова Google Ads API.

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