Habilidades del agente de la API de Google Ads

Las habilidades de agentes de la API de Google Ads son módulos portátiles y autónomos de conocimiento, instrucciones y flujos de trabajo específicos de la API de Google Ads. Las habilidades de agentes de la API de Google Ads 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 Google Ads, configurar herramientas y ejecutar flujos de trabajo con mayor precisión y un menor costo de tokens. Para obtener una lista de las habilidades disponibles, consulta Habilidades disponibles.

Comenzar

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

Instala las habilidades de agentes de la API de Google Ads

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

Antigravity

Las habilidades de agentes de la API de Google Ads se incluyen como uno de los paquetes de integración de Build with Google para Antigravity. Puedes habilitar este paquete para el acceso a nivel global en dos puntos:

  • Durante la incorporación: Selecciona la casilla de verificación de la pila de la API de Google Ads.
  • En Configuración:
    1. Navega a Configuración > Personalizaciones.
    2. En Build with Google Plugins, haz clic en Customize y, luego, en Download para la integración de la API de Google Ads.

Si prefieres el acceso a nivel del proyecto, ejecuta el siguiente comando en el directorio de tu proyecto:

npx skills add google/skills --agent=antigravity

Claude Code 

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

Codex 

npx skills add google/skills

Cursor

Puedes instalar las habilidades de agentes de la API de Google Ads 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 las reglas de 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

Actualiza las habilidades de agentes de la API de Google Ads

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

Antigravity

El editor administra y actualiza automáticamente las integraciones habilitadas a través de Build with Google.

Si instalaste las habilidades de agentes con el comando npx, puedes obtener todas las actualizaciones disponibles ejecutando el comando update:

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

Cursor 

npx skills update --all

Otros agentes

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

npx skills update --all

Usa las habilidades de agentes de la API de Google Ads

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 Google Ads.

También se pueden invocar habilidades de forma manual escribiendo / en el chat del agente y buscando el nombre de la habilidad.

Componentes principales de una habilidad

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

  • Instrucciones especializadas: Instrucciones detalladas que se insertan en la ventana de contexto para guiar al asistente en la generación de consultas de GAQL, la configuración de credenciales de OAuth y el manejo de códigos de error comunes.
  • Prácticas recomendadas: Recomendaciones estándar de rendimiento, seguridad e integración definidas por el equipo de DevRel de la API de Google Ads.
  • Secuencias de comandos de automatización: Secuencias de comandos ejecutables (como para la validación del entorno o la configuración del espacio de trabajo) incluidas en los paquetes de habilidades para ejecutar tareas de forma local.

Beneficios de usar habilidades

Las habilidades de agentes extienden 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 pertinente 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 realizar tareas como las siguientes:

  • Genera una consulta de GAQL para recuperar las métricas de rendimiento de la campaña de mi cuenta.
  • Escribe una secuencia de comandos de Python con bibliotecas cliente para crear una campaña nueva.
  • Recupera las conversiones de la campaña y los datos de diagnóstico con la API de Google Ads.

Para obtener una lista completa de las habilidades disponibles, consulta Habilidades disponibles.

Usa habilidades junto con el servidor de MCP de la API de Google Ads

Las habilidades de agentes están diseñadas para complementar el servidor de Protocolo de contexto del modelo (MCP) de la API de Google Ads:

  • Servidor de MCP de la API de Google Ads: Está diseñado para flujos de trabajo de desarrollo asistidos por IA, lo que permite que los asistentes de IA interactúen con tus recursos de la API de Google Ads, campañas y métricas de forma programática.
  • Habilidades de agentes de la API de Google Ads: Proporcionan instrucciones y prácticas recomendadas que guían a un asistente para realizar tareas a través de una divulgación progresiva y eficiente en cuanto a tokens. Le indican al agente cómo usar herramientas como el servidor de MCP y las bibliotecas cliente de manera eficaz.

Habilidades disponibles

El equipo de la API de Google Ads proporciona un conjunto de habilidades para compilar con la API de Google Ads:

Habilidad Descripción
google-ads-api-mcp-setup Ayuda a configurar el servidor de Protocolo de contexto del modelo (MCP) de la API de Google Ads, lo que simplifica la autenticación y la configuración en entornos locales.
google-ads-api-quickstart Te guía para configurar tu entorno de desarrollador, configurar credenciales y realizar tu primera llamada a la API de Google Ads.

Próximos pasos