integración de AG-UI con Agent Framework

Integración de .NET

La integración .NET expone un MAF AIAgent como un punto de conexión HTTP de AG-UI. El adaptador de hospedaje convierte el flujo de respuesta del agente en eventos AG-UI; el comportamiento del agente principal, como la ejecución de herramientas y la aprobación, sigue siendo parte de MAF.

Use la integración de .NET para:

• Transmita texto del agente a través de eventos enviados por el servidor (SSE).
• Mostrar las llamadas de herramientas de backend y frontend como eventos AG-UI.
• Envíe solicitudes de aprobación de herramientas MAF al cliente y devuelva la decisión.
• Intercambiar el estado del cliente, las instantáneas de estado y los deltas, y las propiedades reenviadas.
• Reanude las sesiones hospedadas persistentes mediante el AG-UI threadId.
• Exponga flujos de trabajo convertidos a agentes a través del mismo punto de conexión.

Los clientes de AG-UI deciden cómo mostrar los eventos de texto, herramientas, aprobación y estado.

Architecture

El paquete de hospedaje de C# agrega un punto de conexión de ASP.NET Core alrededor de un agente MAF normal:

AG-UI client -- HTTP POST / SSE --> MapAGUIServer --> AIAgent

MapAGUIServer adapta la solicitud de AG-UI a los mensajes de MAF y las opciones de ejecución. A continuación, convierte la respuesta de streaming del agente en eventos de AG-UI mediante el SDK de AG-UI .NET.

Instalación

dotnet add package Microsoft.Agents.AI.Hosting.AGUI.AspNetCore --prerelease

Pasos siguientes

Recursos relacionados

• Introducción a Agent Framework
• Documentación del protocoloAG-UI
• Repositorio de Microsoft Agent Framework

AG-UI frente al uso del agente directo

Aunque puede ejecutar agentes directamente en su aplicación utilizando los métodos run y run(..., stream=True) del Marco de Agente, AG-UI proporciona capacidades adicionales.

Introducción a la arquitectura

La integración de AG-UI usa una arquitectura modular limpia:

┌─────────────────┐
│  Web Client     │
│  (Browser/App)  │
└────────┬────────┘
         │ HTTP POST + SSE
         ▼
┌─────────────────────────┐
│  FastAPI Endpoint       │
│  (add_agent_framework_  │
│   fastapi_endpoint)     │
└────────┬────────────────┘
         │
         ▼
┌─────────────────────────┐
│  AgentFrameworkAgent    │
│  (Protocol Wrapper)     │
└────────┬────────────────┘
         │
         ▼
┌─────────────────────────┐
│  Orchestrators          │
│  (Execution Flow Logic) │
└────────┬────────────────┘
         │
         ▼
┌─────────────────────────┐
│  Agent              │
│  (Agent Framework)      │
└────────┬────────────────┘
         │
         ▼
┌─────────────────────────┐
│  Chat Client            │
│  (Azure OpenAI, etc.)   │
└─────────────────────────┘

Componentes clave

• Punto de conexión fastAPI: punto de conexión HTTP que controla el streaming de SSE, comentarios keepalive configurables y enrutamiento de solicitudes
• AgentFrameworkAgent: contenedor ligero que adapta los agentes de Agent Framework al protocolo AG-UI
• Orquestadores: manejan diferentes flujos de ejecución (predeterminado, con intervención humana, gestión de estado)
• Puente de Eventos: convierte eventos de Agent Framework en eventos de protocolo de AG-UI
• Adaptadores de Mensajes: conversión bidireccional entre AG-UI y formatos de mensaje de Agent Framework
• Estrategias de confirmación: estrategias extensibles para mensajes de confirmación específicos del dominio

Cómo se traduce Agent Framework en AG-UI

Comprender cómo se asignan los conceptos de Agent Framework a AG-UI le ayuda a crear integraciones eficaces:

Instalación

Instale el paquete de integración de AG-UI:

pip install agent-framework-ag-ui --pre

Esto instala tanto el marco de trabajo del agente principal como los componentes de integración de AG-UI.

Pasos siguientes

Para empezar a trabajar con la integración de AG-UI:

1. Introducción: Compilación del primer servidor y cliente de AG-UI
2. Representación de herramientas de back-end: agregar herramientas de función a los agentes
3. Flujos de trabajo: exponer flujos de trabajo de varios agentes a través de AG-UI
4. Human-in-the-Loop: Implementación de flujos de trabajo de aprobación
5. Compatibilidad de Aplicaciones MCP: el uso de Aplicaciones MCP con el punto de conexión AG-UI
6. Administración de estado: sincronizar el estado entre el cliente y el servidor

Recursos adicionales

• Documentación de Agent Framework
• Documentación del protocoloAG-UI
• AG-UI Aplicación Dojo : aplicación de ejemplo que muestra la integración de Agent Framework
• Integración MAF de CopilotKit - Conectar interfaces frontales de CopilotKit React a interfaces traseras de AG-UI
• Repositorio de GitHub de Agent Framework

Go admite AG-UI a través de provider/aguiprovider tanto para servidores como para clientes.

import "github.com/microsoft/agent-framework-go/provider/aguiprovider"

mux := http.NewServeMux()
mux.Handle("/", aguiprovider.NewJSONHTTPHandler(myAgent, aguiprovider.HandlerConfig{}))

if err := http.ListenAndServe(":8888", mux); err != nil {
    log.Fatal(err)
}