Навыки работы с API-агентом для управления данными

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

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

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

Команда разработчиков API Data Manager предоставляет набор инструментов для создания приложений с использованием API Data Manager:

Навык Описание
data-manager-api-setup В этом руководстве разработчики пошагово описаны этапы установки клиентской библиотеки и аутентификации для настройки API Data Manager.
data-manager-api-event-ingestion Оказывает помощь во внедрении системы сбора данных о событиях и конверсиях для продуктов Google с использованием API Data Manager.
data-manager-api-audience-ingestion Помогает создавать списки пользователей и управлять данными об аудитории с помощью API Data Manager для таких сценариев использования, как сопоставление клиентов.

Начать

Установите необходимые для вашей среды разработки навыки агента.

Установите навыки агента API Data Manager.

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

Антигравитация

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

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

Кодекс Клода

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Кодекс

npx skills add google/skills/skills/ads

Курсор

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

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

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

npx skills add google/skills/skills/ads

Обновить навыки агента API Data Manager

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

Антигравитация

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

npx skills update --all

Кодекс Клода

claude plugin update google-ads@skills

Кодекс

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

npx skills update --all

Курсор

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

npx skills update --all

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

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

npx skills update --all

Используйте навыки агента API Data Manager.

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

Навыки также можно активировать вручную в чате агента. Для многих агентов можно использовать клавишу / для открытия списка установленных навыков.

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

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

  • Специализированные инструкции : Подробные указания для вашего ИИ-помощника о том, как выполнять конкретные задачи, такие как настройка доступа к API, форматирование и хеширование пользовательских данных, а также реализация рабочих процессов загрузки данных.
  • Рекомендации по лучшим практикам : Стандартные рекомендации по интеграции, определенные командой разработчиков API Data Manager.
  • Справочная документация : руководства по настройке клиентской библиотеки, сопоставление полей миграции и примеры кода, включенные в набор навыков, обеспечат помощника точными и актуальными справочными материалами.

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

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

Сниженная стоимость токенов

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

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

Реализация с использованием ИИ

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

  • Напишите скрипт на Python для обработки данных об офлайн-конверсиях из Google Ads с использованием API Data Manager.
  • Перенесите этот код Google Ads OfflineUserDataJobService для сопоставления клиентов в API Data Manager.
  • Как получить статус обработки запроса на получение событий через API Data Manager?

Следующие шаги