El equipo de .NET de Microsoft, en colaboración con CopilotKit, anunció un SDK oficial de .NET para el protocolo AG-UI, un estándar que define cómo los agentes de inteligencia artificial se comunican con aplicaciones e interfaces orientadas al usuario. El paquete se publicó en el repositorio de AG-UI junto con los paquetes de TypeScript y Python, y está disponible a través de NuGet bajo la licencia MIT.
El cambio práctico es que cualquier servicio de .NET ahora puede comunicarse directamente mediante AG-UI, sin depender de una implementación específica de un marco de agentes determinado. Además, la compatibilidad con AG-UI en Microsoft Agent Framework, conocido por sus siglas MAF, ahora se basa en los nuevos SDK.
¿Qué aporta el paquete?
AG-UI busca abordar un problema común en las aplicaciones de agentes de larga duración. Los agentes pueden enviar tokens gradualmente, invocar herramientas, delegar tareas a subagentes o cambiar el estado de la aplicación mientras procesan la solicitud. Sin un protocolo común, las interfaces frontales deben comprender formatos de eventos diferentes para cada marco de trabajo o servicio.
El protocolo convierte estas interacciones en eventos tipados, entre ellos RUN_STARTED, TEXT_MESSAGE_CONTENT, STATE_DELTA y RUN_FINISHED. El cliente decide cómo mostrarlos, ya sea en una aplicación web, un terminal, una aplicación móvil o plataformas de conversación como Slack y Teams.
Compatibilidad con servidor y cliente
El paquete incluye dos rutas complementarias. AGUI.Server convierte el agente en un punto final compatible con AG-UI, mientras que AGUI.Client permite que una aplicación de .NET se conecte a cualquier agente compatible con el protocolo. La integración se basa en IChatClient, la capa de abstracción específica para conversaciones dentro de Microsoft.Extensions.AI.
En el lado del servidor, la función ToChatRequestContext descompone la solicitud entrante de AG-UI en los mensajes y opciones que espera el cliente; después, AsAGUIEventStreamAsync convierte el flujo de respuesta en eventos del protocolo. Esta conversión también se encarga de crear los eventos de inicio y finalización de la ejecución, así como de cerrar los bloques de texto o razonamiento abiertos antes de pasar a otro mensaje o a otra invocación de herramienta.
Los usuarios de Microsoft Agent Framework pueden apoyarse en la integración con ASP.NET Core, que proporciona las funciones AddAGUIServer() y MapAGUIServer() para reducir el código de configuración del punto final.
Componentes del SDK y compatibilidad
El paquete consta de cinco componentes publicados a través de NuGet:
- AGUI.Abstractions: modelos del protocolo para eventos, mensajes, herramientas, estado e interrupciones.
- AGUI.Formatting: formato de los datos en la red, con compatibilidad con Server-Sent Events de forma predeterminada.
- AGUI.Protobuf: compatibilidad opcional con Protobuf que cubre un subconjunto de tipos de eventos.
- AGUI.Client: consumo de flujos de AG-UI.
- AGUI.Server: producción de flujos de AG-UI.
SSE sigue siendo el formato predeterminado y admite todos los tipos de eventos mencionados en el SDK, mientras que la compatibilidad con Protobuf se limita a un subconjunto.
¿Qué cambia para los usuarios de Agent Framework?
El modelo de programación básico no cambia para los usuarios actuales, y el formato de los eventos sigue siendo compatible, lo que significa que las interfaces frontales existentes pueden continuar funcionando con un servidor actualizado. Sin embargo, algunos nombres de interfaces han cambiado: AddAGUIServer() y MapAGUIServer() sustituyen a AddAGUI() y MapAGUI(), y los espacios de nombres y las clases se trasladaron a los paquetes AGUI.Client, AGUI.Server y AGUI.Abstractions.
El cliente admite el consumo de AG-UI desde .NET Framework 4.7.2 y posteriores, mientras que la exposición del punto final requiere una versión actual de .NET.
¿Por qué es importante este anuncio?
La versión proporciona a los servicios de .NET una vía unificada para trabajar con varias interfaces sin reconstruir la capa de transmisión de eventos para cada aplicación. También permite intercambiar roles entre componentes escritos en C#, Python y TypeScript, manteniendo la capa de integración basada en IChatClient. Esto resulta especialmente valioso para las organizaciones que desean conectar un solo agente con interfaces web, aplicaciones internas o distintos canales de conversación.
Sin embargo, el SDK no elimina la necesidad de crear el servidor ni de elegir cómo se mostrarán los eventos; se encarga del protocolo, mientras que la arquitectura web y el punto final siguen siendo responsabilidad de la aplicación. Además, la compatibilidad con Protobuf no abarca todos los eventos, por lo que SSE continúa siendo la opción predeterminada completa.