AG-UI integratie met Agent Framework

.NET-integratie

De .NET-integratie maakt een MAF AIAgent beschikbaar als een AG-UI HTTP-eindpunt. De hostingadapter converteert de antwoordstroom van de agent naar AG-UI gebeurtenissen; kernagentgedrag, zoals het uitvoeren en goedkeuren van hulpprogramma's, blijft onderdeel van MAF.

Gebruik de .NET-integratie om het volgende te doen:

• Stream agenttekst via Server-Sent Events (SSE).
• Geef backend- en frontend-toolaanroepen weer als AG-UI-gebeurtenissen.
• Verzend goedkeuringsaanvragen van het MAF-hulpprogramma naar de client en retourneer de beslissing.
• Wissel clienttoestand, momentopnamen van de toestand en delta's, en doorgestuurde eigenschappen uit.
• Permanente gehoste sessies hervatten met behulp van de AG-UI threadId.
• Stel naar agenten geconverteerde workflows beschikbaar via hetzelfde eindpunt.

AG-UI clients bepalen hoe tekst, hulpprogramma's, goedkeuring en status-gebeurtenissen moeten worden weergegeven.

Architecture

Het C#-hostingpakket voegt een ASP.NET Core-eindpunt toe rond een gewone MAF-agent:

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

MapAGUIServer past de AG-UI aanvraag aan MAF-berichten en uitvoeringsopties aan. Vervolgens wordt het streaming-antwoord van de agent geconverteerd naar AG-UI gebeurtenissen met behulp van de AG-UI .NET SDK.

Installation

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

Volgende stappen 

Gerelateerde bronnen

• Overzicht van Agent Framework
• AG-UI-protocoldocumentatie
• Microsoft Agent Framework-opslagplaats

AG-UI versus Direct Agentgebruik

Hoewel u agents rechtstreeks in uw toepassing kunt uitvoeren met behulp van Agent Framework run en run(..., stream=True) methoden, biedt AG-UI extra mogelijkheden:

Overzicht van architectuur

De AG-UI-integratie maakt gebruik van een schone, modulaire architectuur:

┌─────────────────┐
│  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.)   │
└─────────────────────────┘

Belangrijke onderdelen

• FastAPI-eindpunt: HTTP-eindpunt dat SSE-streaming verwerkt, configureerbare keepalive-opmerkingen en aanvraagroutering
• AgentFrameworkAgent: Lichtgewicht wrapper waarmee Agent Framework-agents worden aangepast aan AG-UI protocol
• Orchestrators: verschillende uitvoeringsstromen verwerken (standaard, human-in-the-loop, statusbeheer)
• Event Bridge: Converteert Agent Framework-gebeurtenissen naar AG-UI protocol-gebeurtenissen
• Berichtadapters: Bidirectionele conversie tussen AG-UI en Agent Framework-berichtindelingen
• Bevestigingsstrategieën: Uitbreidbare strategieën voor domeinspecifieke bevestigingsberichten

Hoe Agent Framework wordt omgezet in AG-UI

Inzicht in hoe de concepten van Agent Framework zijn toegewezen aan AG-UI helpt u bij het bouwen van effectieve integraties:

Installation

Installeer het AG-UI-integratiepakket:

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

Hiermee worden zowel het core agentframework als AG-UI integratieonderdelen geïnstalleerd.

Volgende stappen

Ga als volgende aan de slag met AG-UI-integratie:

1. Aan de slag: uw eerste AG-UI-server en -client bouwen
2. Rendering van back-end tools: functiehulpmiddelen toevoegen aan uw agents
3. Werkstromen: Werkstromen met meerdere agents beschikbaar maken via AG-UI
4. Human-in-the-Loop: Goedkeuringswerkstromen implementeren
5. Compatibiliteit met MCP-apps: MCP-apps gebruiken met uw AG-UI-eindpunt
6. Statusbeheer: status synchroniseren tussen client en server

Aanvullende bronnen

• Documentatie voor Agent Framework
• Documentatie voor AG-UI Protocol
• AG-UI Dojo-app - Voorbeeldtoepassing die de integratie van Agent Framework demonstreert
• CopilotKit MAF-integratie - CopilotKit React-frontends verbinden met AG-UI back-ends
• GitHub-opslagplaats voor Agent Framework

Go ondersteunt AG-UI door provider/aguiprovider voor zowel servers als clients.

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)
}