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

Навыки агента Google Ads API – это переносимые автономные модули знаний, инструкций и рабочих процессов, связанных с Google Ads API. Навыки агента Google Ads API работают с ИИ-помощниками, которые поддерживают открытый стандарт Agent Skills, включая 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.

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