Asistente no es un chatbot genérico. Es un sistema de control de misión especializado para la ingeniería publicitaria potenciada por IA, creado en los frameworks de agentes Google Antigravity y Claude Code (v4.0.0).
Panorama general: Resuelve la fricción de alto cumplimiento
El problema fundamental que resuelve este Asistente es la sobrecarga cognitiva y el trabajo repetitivo.
La API de Google Ads es una de las más potentes, pero también una de las más complejas, disponibles. Cuenta con un control de versiones estricto, un lenguaje de consulta único (GAQL), estructuras de búfer de protocolo profundamente anidadas y requisitos de seguridad rigurosos. Un desarrollador suele dedicar un porcentaje significativo de su tiempo a luchar contra la API depurando errores de gRPC, buscando compatibilidad de campos y corrigiendo problemas de linter en lugar de crear lógica empresarial real.
El Asistente resuelve esto en la versión 4.0.0 con la introducción de una arquitectura de complementos modulares potenciada por habilidades especializadas y respaldadas por pruebas, y comandos de barra integrados. Actúa como un middleware experto automatizado que controla el trabajo repetitivo de la validación de versiones, el descubrimiento de esquemas y el análisis con lint de código, lo que permite que el desarrollador opere a nivel de intent en lugar de sintaxis.
Basado en esquemas oficiales, no en conjeturas
Los modelos de lenguaje grandes estándar suelen tener dificultades con las APIs específicas del dominio porque dependen por completo de datos de entrenamiento generales, que se vuelven obsoletos rápidamente a medida que se lanzan nuevas versiones de la API.
El Asistente para desarrolladores de la API de Google Ads resuelve este problema combinando reglas arquitectónicas integradas de la API de Google Ads con la inspección dinámica y local del esquema de Protobuf:
- Validación determinista: En lugar de depender de la adivinación iterativa de LLM en varios viajes de ida y vuelta, el asistente ejecuta una canalización de validación local de 4 pasos que verifica la compatibilidad de campos, las relaciones de recursos, las reglas de cero impresiones y la segmentación de fechas en un solo paso.
- Búsquedas de esquemas precisas para la versión: Inspecciona las definiciones de recursos de Protobuf, los tipos de datos y los valores de enumeración directamente desde los esquemas oficiales de la API para la versión activa de la API, lo que evita las consultas repetitivas de metadatos remotos.
- Fundamentación oficial de la biblioteca cliente: La generación de código se basa directamente en las bibliotecas cliente oficiales de Google Ads en Python, Java, PHP, .NET y Ruby.
La analogía: El laboratorio especializado de investigación y diagnóstico
Imagina que el asistente es un laboratorio de investigación de alta tecnología para un cirujano.
- El cirujano (el desarrollador): Sabes exactamente qué operación se debe realizar (por ejemplo, "Necesito analizar el rendimiento de PMax").
- El equipo de laboratorio (la API): Estas son las potentes herramientas necesarias para realizar la cirugía, pero son sofisticadas y requieren una calibración exacta.
- El asistente de laboratorio (esta herramienta): Antes de tocar al paciente, el asistente de laboratorio usa habilidades especializadas y comandos integrados para hacer lo siguiente:
- Consultar los manuales: Verifica automáticamente los protocolos de API más recientes y, además, inspecciona las estructuras de recursos sobre la marcha (
inspect_object//inspect-object). - Probar las herramientas previamente: Ejecuta simulaciones deterministas en tus consultas con la validación de la API en vivo (
validate_gaql//validate-gaql) para detectar errores antes de que ocurran. - Esterilizar el entorno: Da formato a tu código y lo limpia con canalizaciones estrictas de linter (
rufflinting) para que no cause errores del sistema. - Supervisar los signos vitales: Observa las excepciones de la API y ejecuta flujos de trabajo de diagnóstico avanzados para operaciones complejas, como las conversiones sin conexión (
troubleshoot_conversions//troubleshoot-conversions). - Explicar conceptos: Explica conceptos complejos en lenguaje cotidiano con analogías del mundo real (
/explain,/step-by-step,/assistant-tutorial).
- Consultar los manuales: Verifica automáticamente los protocolos de API más recientes y, además, inspecciona las estructuras de recursos sobre la marcha (
Interconexión: El puente "primero la seguridad"
El Asistente funciona como un puente que conecta cuatro "mundos" distintos dentro de tu proyecto, que se rigen por contratos de control (AGENTS.md / CLAUDE.md):
- El contexto del usuario: Escucha tus objetivos de alto nivel y los traduce en una estrategia técnica.
- El espacio de trabajo local: Tiene "ojos y manos" en el directorio de tu proyecto. Puede leer código existente y escribir código nuevo para usarlo más adelante, manteniendo un aislamiento estricto.
- La API de Google Ads: Se conecta a la API en vivo para ejecutar informes de solo lectura y probar consultas en tu cuenta. Para la validación instantánea de campos, inspecciona directamente los esquemas de Protobuf locales.
- Los guardianes de seguridad: Está conectado para seguir protocolos estrictos. No te permitirá ejecutar una secuencia de comandos si no se realizó el linting, y no te permitirá enviar una consulta si no pasó una verificación de validación programática.
Qué hace realmente el Asistente
En términos sencillos, el asistente es tu protección y acelerador.
- Evita errores: Valida el código y las consultas con los esquemas activos de la API antes de la ejecución, y detiene los errores de sintaxis y compatibilidad antes de que lleguen a la API en vivo.
- Conoce el mapa: Comprende la geografía de la API de Google Ads, dónde se encuentran los datos y cómo consultarlos de manera eficiente.
- Automatiza las tareas aburridas: Escribe código de biblioteca cliente estándar, da formato a los informes en tablas de terminal limpias y controla la infraestructura de la biblioteca cliente.
- Soluciona problemas de flujos de trabajo complejos: Ejecuta diagnósticos detallados en las cargas de conversiones sin conexión, resuelve las jerarquías de cuentas de MCC y configura estructuras de campañas complejas, como los filtros de ficha de campaña de máximo rendimiento y las exclusiones de URL.
- Transmite informes ad hoc en vivo: Solicita datos de rendimiento en inglés sencillo, y el asistente crea, valida y ejecuta consultas de GAQL directamente en tu cuenta, transmite resultados con formato a tu terminal o los exporta a CSV.
- Se mantiene actualizado: Al inspeccionar los esquemas y la documentación de Protobuf locales para la versión activa de la API, te ayuda a evitar campos obsoletos y reglas desactualizadas.
El Asistente para desarrolladores de la API de Google Ads transforma una lucha de "desarrollador contra API" en una colaboración de "desarrollador + IA" que produce código seguro, idiomático y arquitectónicamente sólido.
Arquitectura y rendimiento (v4.0.0)
La versión 4.0.0 realiza la transición del asistente de una configuración de proyecto independiente a una arquitectura de complementos moderna y global:
- Cero sobrecarga de daemon: Las habilidades y los comandos de diagnóstico se ejecutan de forma efímera como procesos secundarios ligeros solo cuando se los llama, lo que reduce el uso de recursos del sistema a cero cuando está inactivo.
- Divulgación progresiva del contexto: Las reglas y los esquemas se cargan a pedido solo cuando son relevantes para tu tarea activa, lo que reduce significativamente el consumo de tokens y la latencia de las instrucciones.
- Reducción de la E/S de disco: La eliminación de archivos SDK innecesarios del árbol de complementos evita que los indexadores, los linters y los observadores de archivos del IDE analicen decenas de miles de archivos sin usar.
- Compatibilidad con host multiplataforma: Funciona sin problemas en los entornos de Google Antigravity y Claude Code con secuencias de comandos de instalación unificadas en Linux, macOS y Windows.
Próximos pasos
- Instala y configura el Asistente para desarrolladores de la API de Google Ads.
- Obtén información sobre las habilidades del agente de la API de Google Ads.
- Obtén información sobre el servidor de MCP de la API de Google Ads.