AG-UI ile MCP Uygulamaları Uyumluluğu

Uyarı

.NET AG-UI tümleştirmesi için MCP Apps uyumluluk belgeleri yakında sunulacaktır.

Agent Framework Python AG-UI uç noktaları, AG-UI ekosisteminin MCP Apps özelliğiyle uyumludur. MCP Uygulamaları, ön uç uygulamalarının AG-UI aracınıza MCP destekli araçlar ve kaynaklar eklemesine olanak tanır; Python tarafında değişiklik gerekmez.

Architecture

MCP Apps desteği, ön uç ile Agent Framework arka ucu arasında yer alan CopilotKit TypeScript MCPAppsMiddleware ()@ag-ui/mcp-apps-middleware tarafından sağlanır:

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

Ara yazılım katmanı MCP aracı bulmayı, iframe ile sunulan kaynak isteklerini ve ui/resourceUri çözümlemeyi işler. Python AG-UI uç noktanız standart AG-UI istekleri alır ve MCP Uygulamaları katmanının farkında değildir.

Python Tarafı Değişiklikleri Gerekli Değil

MCP Apps tümleştirmesi tamamen TypeScript ara yazılımı tarafından işlenir. Mevcut add_agent_framework_fastapi_endpoint() kurulumunuz hali hazırda çalışır.

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

Bu yaklaşım, MCP Uygulamalarının diğer tüm AG-UI Python tümleştirmeleriyle nasıl çalıştığıyla tutarlıdır; MCP Uygulamaları katmanı her zaman Python arka uçta değil TypeScript ara yazılımındadır.

Ara Yazılımı Ayarlama

MCP Uygulamalarını Agent Framework arka uç sisteminizde kullanmak için, MCPAppsMiddleware içeren bir CopilotKit Runtime veya Node.js ara sunucusu ayarlayın ve Python uç noktanıza işaret edin.

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

Tam kurulum yönergeleri için CopilotKit MCP Uygulamaları belgelerine ve AG-UI MCP Uygulamaları belgelerine bakın.

Kapsam Dışında Kalanlar

Python AG-UI tümleştirmesinin aşağıdaki bileşenleri parçası değildir:

  • No Python MCPAppsMiddleware: MCP Apps ara yazılımı yalnızca TypeScript katmanında çalışır.
  • Iframe aracılı MCP isteklerinin FastAPI tarafından işlenmesi yok: Kaynak proxy'si, Node.js ara yazılımı tarafından yönetilir.
  • Python tarafında ui/resourceUri keşif yok: Kaynak URI çözümlemesi ara yazılım sorunudur.

Uygulamanızın MCP Apps ara yazılım katmanına ihtiyacı yoksa, Agent Framework AG-UI uç noktanız doğrudan AG-UI uyumlu istemcilerle çalışır.

Sonraki Adımlar

Durum Yönetimi

Ek Kaynaklar

  • Last updated on