Habilidades del agente de la API de Data Manager

Las habilidades de agentes de la API de Data Manager son módulos portátiles y autónomos de conocimiento, instrucciones y flujos de trabajo específicos de la API de Data Manager. Las habilidades de agentes de la API de Data Manager funcionan con asistentes de IA que admiten el estándar abierto de habilidades de agentes, incluidos Google Antigravity y Claude Code.

Estas habilidades de agentes están diseñadas para ayudar a los asistentes de IA a comprender las prácticas recomendadas de la API de Data Manager, configurar herramientas y ejecutar flujos de trabajo con mayor precisión y un menor costo de tokens.

Habilidades disponibles

El equipo de la API de Data Manager proporciona un conjunto de habilidades para compilar con la API de Data Manager:

Habilidad Descripción
data-manager-api-setup Guía a los desarrolladores a través de los pasos de instalación y autenticación de la biblioteca cliente para configurar la API de Data Manager.
data-manager-api-event-ingestion Ayuda a implementar la ingesta de eventos y conversiones para los productos de Google con la API de Data Manager.
data-manager-api-audience-ingestion Ayuda a crear listas de usuarios y administrar datos de público con la API de Data Manager para casos de uso como Segmentación por clientes.

Comenzar

Instala las habilidades de agentes adecuadas para tu entorno de desarrollo.

Instala las habilidades de agentes de la API de Data Manager

En la mayoría de los casos, las habilidades de agentes de la API de Data Manager se pueden instalar en tu editor preferido con un solo comando:

Antigravity

Ejecuta el siguiente comando en el directorio de tu proyecto:

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

Cursor

Puedes instalar las habilidades de agentes de la API de Data Manager directamente agregando el extremo del repositorio de GitHub de la habilidad (por ejemplo, https://github.com/google/skills) en la configuración de tu editor en reglas personalizadas. Para obtener más detalles, consulta la documentación de Cursor sobre la instalación de habilidades desde GitHub.

También puedes instalar las habilidades con NPX:

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

Otros agentes

Para otros asistentes de IA que admiten el estándar abierto de habilidades de agentes, puedes instalar las habilidades con NPX:

npx skills add google/skills/skills/ads

Actualiza las habilidades de agentes de la API de Data Manager

Puedes obtener todas las actualizaciones disponibles y liberar espacio de las habilidades desactualizadas ejecutando el comando update:

npx skills update --all

Usa las habilidades de agentes de la API de Data Manager

Los asistentes de IA están diseñados para usar habilidades automáticamente cuando detectan que la descripción de una habilidad coincide con tu solicitud actual. Las habilidades instaladas de forma global permanecen inactivas en proyectos no relacionados, a menos que el contexto de tu instrucción coincida con las tareas de la API de Data Manager.

Las habilidades también se pueden invocar manualmente en el chat del agente. En muchos agentes, puedes usar la tecla / para abrir una lista de habilidades instaladas.

Componentes principales de una habilidad

Cada habilidad de agente es un paquete especializado que proporciona al asistente de IA los siguientes componentes:

  • Instrucciones especializadas: Orientación detallada para tu asistente de IA sobre cómo realizar tareas específicas, como configurar el acceso a la API, dar formato a los datos del usuario y aplicarles hash, y, también, implementar flujos de trabajo de ingesta.
  • Prácticas recomendadas: Recomendaciones de integración estándar definidas por el equipo de la API de Data Manager.
  • Documentación de referencia: Guías de configuración de la biblioteca cliente, asignaciones de campos de migración y muestras de código incluidas en las habilidades para proporcionar al asistente referencias precisas y actualizadas.

Beneficios de usar habilidades

Las habilidades de agentes amplían las capacidades de un asistente con conocimiento especializado a pedido sin la sobrecarga de cargar instrucciones voluminosas en cada conversación.

Reducción de los costos de los tokens

Las integraciones de IA convencionales suelen cargar grandes cantidades de documentación por adelantado, lo que consume una cantidad significativa de tokens y aumenta los costos de la sesión. Las habilidades de agentes usan la divulgación progresiva para minimizar esta sobrecarga:

  • Inicialmente, el asistente de IA solo verifica el nombre y la descripción de la habilidad para ver si es relevante para tu solicitud.
  • Las instrucciones y las referencias completas de la habilidad solo se agregan a la ventana de contexto activa cuando el asistente determina que son necesarias para tu tarea específica, lo que ahorra espacio de contexto.

Implementación guiada por IA

En lugar de buscar manualmente en la documentación, puedes describir tu intención en lenguaje natural. Las habilidades guían a tu asistente de IA para ayudarte con las tareas de la API de Data Manager, como las siguientes:

  • Escribe una secuencia de comandos de Python para ingerir conversiones sin conexión de Google Ads con la API de Data Manager.
  • Migra este código de Google Ads OfflineUserDataJobService para Segmentación por clientes a la API de Data Manager.
  • ¿Cómo recupero el estado de procesamiento de una solicitud de ingesta de eventos de la API de Data Manager?

Próximos pasos

Anterior
Instala una biblioteca cliente