MCP-alkalmazások kompatibilitása AG-UI

Megjegyzés:

Hamarosan megjelenik az MCP Apps kompatibilitási dokumentációja a .NET AG-UI integrációhoz.

Az Agent Framework Python AG-UI-végpontok kompatibilisek az AG-UI-ökoszisztéma MCP Apps funkciójával. Az MCP Apps lehetővé teszi, hogy az előtérbeli alkalmazások mcp-alapú eszközöket és erőforrásokat ágyaznak be a AG-UI ügynök mellé – a Python oldalon nincs szükség módosításokra.

Architecture

Az MCP Apps-támogatást a CopilotKit TypeScript MCPAppsMiddleware (@ag-ui/mcp-apps-middleware) biztosítja, amely az előtér és az Agent Framework háttérrendszere között helyezkedik el:

┌─────────────────────────┐
│  Frontend               │
│  (CopilotKit / AG-UI)   │
└────────┬────────────────┘
         │
         ▼
┌─────────────────────────┐
│  CopilotKit Runtime /   │
│  Node.js Proxy          │
│  + MCPAppsMiddleware    │
└────────┬────────────────┘
         │ AG-UI protocol
         ▼
┌─────────────────────────┐
│  Agent Framework        │
│  FastAPI AG-UI Endpoint │
└─────────────────────────┘

A köztes szoftverréteg kezeli az MCP-eszközök felderítését, az iframe-alapú erőforrás-kérelmeket, valamint a ui/resourceUri megoldását. A Python AG-UI végpont szabványos AG-UI kéréseket fogad, és nem ismeri az MCP Apps réteget.

Nincs szükség Python oldali módosításokra

Az MCP Apps-integrációt teljes mértékben a TypeScript köztes szoftver kezeli. A meglévő add_agent_framework_fastapi_endpoint() beállítás úgy működik, ahogy van.

from agent_framework import Agent
from agent_framework.ag_ui import add_agent_framework_fastapi_endpoint
from fastapi import FastAPI

app = FastAPI()
agent = Agent(name="my-agent", instructions="...", client=chat_client)

# This endpoint is MCP Apps-compatible with no additional configuration
add_agent_framework_fastapi_endpoint(app, agent, "/")

Ez a megközelítés összhangban van azzal, hogy az MCP Apps hogyan működik az összes többi AG-UI Python integrációval – az MCP Apps réteg mindig a TypeScript köztes szoftverben van, nem pedig a Python háttérrendszerben.

A Köztes szoftver beállítása

Ha az MCP-alkalmazásokat az Agent Framework háttérrendszerével szeretné használni, állítson be egy CopilotKit futtatókörnyezetet vagy Node.js proxyt, amely tartalmazza a MCPAppsMiddleware-t, és a Python végpontra mutat.

// Example Node.js proxy configuration (TypeScript)
import { MCPAppsMiddleware } from "@ag-ui/mcp-apps-middleware";

const middleware = new MCPAppsMiddleware({
  agents: [
    {
      name: "my-agent",
      url: "http://localhost:8888/",  // Your MAF AG-UI endpoint
    },
  ],
  mcpApps: [
    // MCP app configurations
  ],
});

A teljes beállítási utasításokért tekintse meg a CopilotKit MCP Apps dokumentációját és a AG-UI MCP Apps dokumentációját.

Mi nincs a hatókörben?

A következők kifejezetten nem részei a Python AG-UI integrációnak:

  • Nem Python MCPAppsMiddleware: Az MCP Apps köztes szoftver csak TypeScript-rétegben fut.
  • Az iframe-alapú MCP-kérések FastAPI-kezelése nem történik meg: Az erőforrás-proxyt a Node.js köztes szoftver kezeli.
  • Nem Python-oldali ui/resourceUri felfedezés: Az erőforrás-URI feloldása egy köztes szoftveres megoldás kérdése.

Ha az alkalmazásnak nincs szüksége az MCP Apps köztes szoftverrétegére, az Ügynök-keretrendszer AG-UI végpontja közvetlenül bármely AG-UI-kompatibilis ügyféllel működik.

Következő lépések

Állapotkezelés

További források

  • Last updated on