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

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

Они помогут ИИ-помощникам понимать, как лучше всего использовать 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 (Плагины Build with Google) нажмите 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.

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