Punteo — AG-UI Gateway: Interfaz Web para Agentes ADK en Cloud Run

Idea central

Toda la documentación de AG-UI muestra agentes corriendo localmente. Nadie muestra cómo conectar una UI de producción a agentes A2A remotos en Cloud Run. Tú construyes ese puente en vivo.

Estructura del video (borrador)

1. HOOK — El gap que nadie documenta (0:00 - 1:30)

Mostrar la UI funcionando: campo de texto, “Build IDP for my app”, respuestas de los 7 agentes apareciendo en tiempo real con componentes visuales
“Eso son mis 7 agentes en Cloud Run. Con una interfaz web real. Y la documentación oficial no te explica cómo hacerlo.”

2. CONTEXTO — De terminal a UI (1:30 - 4:00)

Video 2: los agentes están en Cloud Run, la interface era terminal
El problema: terminal funciona para devs, no para usuarios reales
“Hoy construimos el Gateway que conecta una UI al sistema.”

3. CONCEPTO — El mapa de protocolos (4:00 - 10:00)

A2A: agente ↔ agente (ya lo tenemos)
AG-UI: frontend ↔ backend del agente (esto construimos hoy)
A2UI: formato que describe los componentes UI que genera el agente (futuro)
Mostrar el diagrama completo del stack

4. EL GAP — Por qué la doc oficial no alcanza (10:00 - 15:00)

Mostrar la doc oficial de AG-UI: agente local en el mismo proceso
“Mi caso es diferente: 7 agentes independientes en Cloud Run”
El componente que falta: el Gateway con RemoteA2aAgent

Mostrar la arquitectura completa:

Next.js + CopilotKit → Gateway FastAPI → 7 agentes Cloud Run

5. BUILD — Construir el Gateway (15:00 - 35:00)

Crear el servicio FastAPI Gateway
Instalar ag_ui_adk + configurar RemoteA2aAgent apuntando a las 7 URLs
Resolver la autenticación IAM entre Gateway y Cloud Run
Deploy del Gateway en Cloud Run

6. BUILD — Frontend (35:00 - 42:00)

npx copilotkit@latest create -f adk
Conectar al Gateway
Mostrar los componentes reactivos de cada agente respondiendo

7. DEMO EN VIVO (42:00 - 47:00)

Tarea completa desde la UI
Los 7 agentes respondiendo con sus componentes visuales en tiempo real
“Esto es lo que nadie te muestra en los tutoriales”

8. CIERRE (47:00 - 49:00)

El stack completo de la trilogía: Docker → Cloud Run → UI productiva
Teaser: MCP Server para que otros LLMs también puedan usarlos

Momento wow

Ver los 7 agentes activarse uno a uno en la UI con componentes visuales reales, mostrando que están en Cloud Run (no locales).

Decisiones técnicas pendientes

¿AG-UI con Next.js o con otro framework?
¿Mostrar solo el Gateway o también el frontend completo?
Auth IAM entre Gateway y Cloud Run — cómo resolverlo limpiamente
¿Usar A2UI para componentes declarativos o AG-UI puro?

Checklist sistema real

¿Hay un sistema funcionando como centro? → Sí, Gateway + 7 agentes en Cloud Run
¿El hook muestra el resultado primero? → Sí, UI completa funcionando
¿Hay momento wow concreto? → Sí, agentes activándose en UI en tiempo real
¿La audiencia lo buscaría? → Sí, interfaz productiva para agentes ADK
Título pendiente definir

Títulos candidatos

“AG-UI + ADK: La Interfaz que Nadie te Muestra para tus Agentes en Cloud Run”
“Interfaz Web para 7 Agentes ADK en Producción — AG-UI Gateway”
“De Terminal a UI Productiva: AG-UI con Agentes ADK en Cloud Run”

Bloqueantes

Video 2 (Cloud Run + A2A) publicado primero
Cuenta GCP activa