Habilidades del agente de la API de Google Ads

Las habilidades para 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 para agentes de la API de Google Ads funcionan con asistentes de IA que admiten el estándar abierto de habilidades para 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 para agentes adecuadas para tu entorno de desarrollo.

Instala habilidades para agentes de la API de Google Ads

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

Antigravity

Las habilidades para 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 integración: Selecciona la casilla de verificación de la pila de la API de Google Ads.
  • En Configuración, haz lo siguiente:
    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 del 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 para 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 sobre las reglas del cursor.

Otros agentes

En el caso de otros asistentes de IA que admitan el estándar abierto de Agent Skills, puedes instalar las habilidades con npx (requiere Node.js):

npx skills add google/skills

Actualiza las habilidades de los agentes de la API de Google Ads

Puedes obtener todas las actualizaciones disponibles y limpiar las habilidades desactualizadas si ejecutas el comando update:

Antigravity

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

Si instalaste habilidades para 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

En el caso de otros asistentes de IA que admitan el estándar abierto de Agent Skills, puedes actualizar todas las habilidades activas con npx:

npx skills update --all

Usa las habilidades para 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 puedes invocar habilidades manualmente 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: Son 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: Son secuencias de comandos ejecutables (por ejemplo, para la validación del entorno o la configuración del espacio de trabajo) que se incluyen en los paquetes de habilidades para ejecutar tareas de forma local.

Beneficios de usar habilidades

Las habilidades para agentes extienden las capacidades de un asistente con conocimientos especializados 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 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 datos de diagnóstico y conversiones de las campañas 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 para agentes están diseñadas para complementar el servidor de MCP del 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, campañas y métricas de la API de Google Ads de forma programática.
  • Habilidades para agentes de la API de Google Ads: Proporcionan instrucciones rápidas 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 crear con la API de Google Ads:

Habilidad Descripción
google-ads-api-mcp-setup Ayuda a configurar el servidor del 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 desarrollo, configurar credenciales y realizar tu primera llamada a la API de Google Ads.

Próximos pasos