Habilidades de agentes de IA de la API de Google Ads

Las habilidades de agentes de IA 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. Estas habilidades funcionan con agentes de programación con IA que admiten el estándar abierto Agent Skills, incluidos Google Antigravity, Claude Code, Codex y Cursor.

Estas habilidades para agentes de IA ayudan a los agentes de programación de IA a comprender las prácticas recomendadas de la API de Google Ads, configurar las herramientas y ejecutar los 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 del agente de IA adecuadas para tu entorno de desarrollo.

Instala habilidades de agentes de IA de la API de Google Ads

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

Antigravity

Las habilidades de agente de IA 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 de proyecto, 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 del agente de IA 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 las reglas personalizadas. Para obtener más detalles, consulta la documentación de Cursor sobre cómo instalar habilidades desde GitHub.

También puedes instalar las habilidades con el comando npx (requiere Node.js):

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

Otros agentes

Para otros agentes de programación de IA que admiten el estándar abierto Agent Skills, puedes instalar las habilidades con el comando npx (requiere Node.js):

npx skills add google/skills/skills/ads

Actualiza las habilidades del agente de IA de la API de Google Ads

Puedes obtener todas las actualizaciones disponibles y limpiar 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 agente de IA con el comando npx, puedes obtener todas las actualizaciones disponibles ejecutando el comando update:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Cursor 

npx skills update --all

Otros agentes

Para otros agentes de programación de IA que admiten el estándar abierto Agent Skills, puedes actualizar todas las habilidades activas con el comando npx:

npx skills update --all

Usa las habilidades del agente de IA de la API de Google Ads

Los agentes de programación de IA usan 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 de forma manual ingresando / en el chat del agente de IA y buscando el nombre de la habilidad.

Componentes principales de una habilidad

Cada habilidad de agente de IA es un paquete especializado que proporciona al agente de IA de programación 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: Son recomendaciones estándar de rendimiento, seguridad y de 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 (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 los agentes de IA extienden las capacidades de un agente de programación de IA 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 de IA 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 las campañas de mi cuenta.
  • Escribir una secuencia de comandos de Python con bibliotecas cliente para crear una campaña nueva
  • Recupera las conversiones de las campañas 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 los agentes de IA complementan el servidor 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 de agentes de IA de la API de Google Ads: Proporcionan instrucciones de instrucciones y prácticas recomendadas que guían a un agente de programación de IA para que realice tareas a través de una divulgación progresiva y eficiente en cuanto a tokens. Le indican al agente de programación de IA 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-account-diagnostics Diagnostica problemas de rendimiento de la cuenta de Google Ads, como la pérdida de conversiones, el bajo volumen de clientes potenciales y el porcentaje de impresiones perdidas debido al ranking del anuncio, las ofertas o los presupuestos, con el servidor de MCP de la API de Google Ads.
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 desarrollador, configurar las credenciales y realizar tu primera llamada a la API de Google Ads.

Próximos pasos