AG-UI
CopilotKit · Programación
AG-UI es un protocolo para agentes, abierto y basado en eventos, creado por CopilotKit, que conecta agentes de IA con apps frontend y transmite estado y acciones en tiempo real.
Acerca de AG-UI
What Is AG-UI
AG-UI es un protocolo, no una app que se instala. Su nombre completo es Agent User Interaction Protocol (protocolo de interacción agente-usuario), y define un lenguaje común que se coloca entre un agente backend y la interfaz que usa una persona. Las dos partes intercambian mensajes, estado y llamadas a herramientas sin código de pegamento para cada combinación.
El problema que resuelve es fácil de describir. Los agentes trabajan durante mucho tiempo, deciden por su cuenta y mezclan texto, voz y llamadas a herramientas en una misma sesión. Los endpoints clásicos REST o GraphQL dan por hecho que entra una petición y sale una respuesta ordenada. Los agentes interactivos como Cursor o Devin ya trabajan al lado de una persona en tiempo real, y ese estilo rompe el modelo antiguo.
El límite principal está en el alcance. AG-UI cubre solo la conexión entre agente e interfaz. No dice nada sobre cómo llegan los agentes a las herramientas ni cómo hablan entre ellos, así que lo combinas con otras piezas de la pila.
Getting Started
- Revisa la documentación oficial en ag-ui.com y elige un framework compatible, como LangChain, CrewAI o una conexión directa a un modelo.
- Registra tu endpoint del agente como HttpAgent en el runtime del frontend para que el cliente sepa dónde enviar la entrada y escuchar eventos.
- Añade las piezas de UI que necesites, como chat con streaming, estado compartido o un paso de aprobación. Usa las implementaciones de referencia como punto de partida.
- Ejecuta las demos de AG-UI Dojo para ver cada función en una app real y después lleva esos mismos eventos a tu producto.
Información del producto
Un vistazo rápido a los precios, las plataformas compatibles y el rendimiento de AG-UI.
Ideal para
Los usuarios, tareas y casos de uso en los que esta herramienta encaja mejor.
Usuarios
- Desarrolladores frontend
- Equipos full-stack y de plataforma
- Product managers técnicos
Tareas
- Transmitir respuestas del agente a una app web
- Sincronizar el estado entre agente e interfaz
- Añadir aprobación humana
Casos de uso
- Un asistente de soporte que redacta respuestas
- Un compañero de programación dentro de un IDE o una herramienta web
- Un agente de investigación o datos de varios pasos
Funciones clave
Streaming de eventos en tiempo real
AG-UI mantiene un canal vivo entre el agente y la interfaz, así los tokens, las llamadas a herramientas y el estado llegan a medida que ocurren. Las ejecuciones admiten cancelar y reanudar, algo que importa cuando una petición dura minutos y no segundos. La conexión va sobre HTTP y WebSockets estándar, así que encaja en la pila web que ya usas.
Estado compartido
El protocolo define un almacén tipado que tanto el agente como la app pueden leer y actualizar. Los cambios vuelven como diferencias con resolución de conflictos, así la interfaz refleja el trabajo del agente sin recargas completas. Los modos de solo lectura y de lectura-escritura te dejan decidir cuánto control tiene cada parte.
UI generativa
Los agentes devuelven componentes que la app renderiza, desde widgets tipados estables hasta un pequeño árbol declarativo que el frontend valida antes de montarlo. Así un agente da forma a lo que ve el usuario, como un formulario o un gráfico, en lugar de solo mandar texto. La app conserva siempre el control final sobre lo que se muestra.
Control humano en el bucle (human in the loop)
Puedes interrumpir una ejecución para pausar, aprobar, editar, reintentar o escalar un paso. El estado sobrevive a la pausa, así el agente sigue donde lo dejó cuando la persona responde. Esta es la pieza que hace útiles a los agentes para cualquier cosa con consecuencias reales.
Integraciones agnósticas del framework
AG-UI nació del trabajo de CopilotKit con LangChain y CrewAI, y trae integraciones para esos frameworks más una ruta directa al modelo. Cualquier backend que emita el flujo de eventos correcto puede conectarse, ya corra en Python, en JavaScript u otro lenguaje. Junto a MCP y A2A, AG-UI es uno de los protocolos agenticos que hoy definen cómo encajan los sistemas de agentes, y te deja escribir la lógica de UI una vez y apuntarla a distintos agentes.
Ventajas y desventajas
Ventajas
- Abre una única conexión estándar, así un frontend habla con varios backends de agentes sin cableado a medida.
- Está pensado para la realidad de los agentes: ejecuciones largas, trabajo en streaming y salida mixta de texto y herramientas.
- Ofrece bloques claros para estado compartido, UI generativa y revisión humana, todos usables por separado.
- La documentación y las demos en vivo de AG-UI Dojo aterrizan el modelo de eventos enseguida.
- Va sobre HTTP y WebSockets, así que encaja en la infraestructura web que ya tienes.
Desventajas
- Cubre solo la capa agente-interfaz, así que sigues necesitando MCP o A2A para herramientas y trabajo entre agentes.
- Da por hecho un público de desarrolladores; no hay una vía sin código para quienes no programan.
- Adoptarlo implica aprender los tipos de eventos y los formatos de mensaje antes de publicar la primera función.
- Está muy ligado al conjunto de herramientas de CopilotKit, así que los equipos de fuera encuentran menos piezas listas.
Preguntas frecuentes
AG-UI estandariza cómo se conectan los agentes de IA con las aplicaciones de cara al usuario. Transporta respuestas en streaming, estado compartido, llamadas a herramientas y pasos de aprobación entre un agente backend y una app frontend, para que los desarrolladores no construyan su propio cableado para cada framework.
Contenido relacionado
Explora herramientas, habilidades y artículos relacionados con AG-UI.
Alternativas a AG-UI
Forefront
Forefront · ProgramaciónForefront es una plataforma web para construir con IA de código abierto. Te deja ajustar los principales modelos de lenguaje de código abierto con tus propios datos, evaluar cómo rinden y ejecutarlos a través de una API o exportarlos para alojarlos tú mismo. Los desarrolladores que quieren la comodidad de una plataforma cerrada pero insisten en ser dueños de sus modelos y sus datos son el público objetivo.
Startkit
StartKit.AI · ProgramaciónStartkit es un boilerplate para crear productos de SaaS con IA y wrappers de IA. Piénsalo como un boilerplate para startups de IA con las partes aburridas ya conectadas: autenticación, pagos con Stripe y Lemon Squeezy, límites de uso, correo transaccional y un kit de inicio de API de IA que habla con OpenAI, Anthropic, Groq o Llama. Clonas el repositorio, pones tu precio y te dedicas a la parte del producto por la que la gente paga de verdad. Está hecho con Next.js sobre React y Tailwind, así que buena parte del código boilerplate ya te resulta familiar.
Testim
Tricentis · ProgramaciónTestim es una plataforma de automatización de pruebas impulsada por IA para crear y ejecutar pruebas de extremo a extremo en aplicaciones web, móviles y Salesforce. Se apoya en el aprendizaje automático para mantener las pruebas estables cuando cambia una interfaz, así que los equipos dedican menos tiempo a reparar selectores rotos. No está nada mal para una herramienta de pruebas automatizadas que puedes empezar a usar hoy mismo. Creas pruebas grabando acciones en un navegador y luego añades JavaScript cuando necesitas más control. Es una opción sólida para equipos de QA con mucho trabajo.