Udostępnij za pośrednictwem

Zgodność aplikacji MCP z AG-UI

Uwaga / Notatka

Dokumentacja zgodności aplikacji MCP dla integracji .NET AG-UI będzie dostępna wkrótce.

Punkty końcowe platformy Agent Framework Python AG-UI są zgodne z funkcją ekosystemu AG-UI, MCP Apps. Aplikacje MCP umożliwiają aplikacjom frontonu osadzanie narzędzi i zasobów opartych na programie MCP wraz z agentem AG-UI — bez konieczności wprowadzania zmian po stronie Python.

Architecture

Obsługa aplikacji MCP jest zapewniana przez bibliotekę TypeScript MCPAppsMiddleware (@ag-ui/mcp-apps-middleware), która znajduje się między frontonem a zapleczem platformy Agent Framework:

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

Warstwa oprogramowania pośredniczącego obsługuje odnajdywanie narzędzi MCP, żądania zasobów przekazywanych przez pośrednika iframe oraz ui/resourceUri obsługę. Punkt końcowy interfejsu AG-UI w Pythonie odbiera standardowe żądania AG-UI i nie rozpoznaje warstwy aplikacji MCP.

Brak wymaganych zmian po stronie Python

Integracja aplikacji MCP jest w pełni obsługiwana przez oprogramowanie pośredniczące TypeScript. Twoja konfiguracja add_agent_framework_fastapi_endpoint() działa bez zmian.

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, "/")

Takie podejście jest zgodne ze sposobem współdziałania aplikacji MCP z wszystkimi innymi integracjami AG-UI w Pythonie — warstwa aplikacji MCP jest zawsze w warstwie pośredniej TypeScript, a nie w back-endzie Pythona.

Konfigurowanie oprogramowania pośredniczącego

Aby używać aplikacji MCP z zapleczem platformy Agent Framework, skonfiguruj środowisko uruchomieniowe CopilotKit lub serwer proxy Node.js zawierający MCPAppsMiddleware i wskazujący na Twój punkt końcowy w Pythonie.

// 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
  ],
});

Aby uzyskać pełne instrukcje dotyczące konfiguracji, zobacz dokumentację aplikacji MCP CopilotKit oraz dokumentacjęAG-UI MCP Apps.

Co nie znajduje się w zakresie

Poniżej przedstawiono elementy, które nie są częścią integracji Python AG-UI:

  • No Python MCPAppsMiddleware: Pośrednik MCP Apps działa tylko w warstwie TypeScript.
  • Brak obsługi żądań MCP proxyowanych przez iframe w FastAPI: Proxying zasobów jest realizowany przez oprogramowanie pośredniczące Node.js.
  • No Python-side ui/resourceUri discovery: Rozpoznawanie identyfikatora URI zasobów jest kwestią warstwy pośredniej.

Jeśli Twoja aplikacja nie potrzebuje warstwy pośredniej MCP Apps, końcowy punkt AG-UI platformy Agent Framework działa bezpośrednio z dowolnym klientem zgodnym z AG-UI.

Następne kroki

Zarządzanie stanem

Dodatkowe zasoby

  • Last updated on