Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

MCP-Ereignisse in Sprachgesprächen

Lektion 12 von 16 Aktualisiert am 30. Juli 2026 Entwickler
Auf dieser Seite
  1. MCP im Sprachagenten
  2. Ein MCP-Tool konfigurieren
  3. Tool-Erkennung
  4. MCP-Tool-Aufrufe
  5. Unterschiede zum regulären Funktion-Aufruf
  6. MCP-Ereignisse in Ihrer Anwendung verarbeiten
  7. Kernaussagen

MCP im Sprachagenten

Das Model Context Protocol (MCP) ermöglicht es Ihrem Sprachagenten, über ein standardisiertes Protokoll mit externen Tool-Servern zu verbinden. Wenn Sie ein MCP-Tool in Ihrer Sitzung konfigurieren, sendet die Voice Agent API für jeden Schritt der Interaktion mit dem MCP-Server spezifische Ereignisse aus.

Ein MCP-Tool konfigurieren

Um einen MCP-Server in Ihrer Sprachsession zu aktivieren, fügen Sie ihn zur Liste der Tools hinzu:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "mcp",
        "server_url": "https://mon-serveur-mcp.exemple.com/sse",
        "server_label": "Internal CRM"
      }
    ]
  }
}

Das Feld server_url verweist auf Ihren MCP-Server, und server_label ist ein lesbarer Name, der den Server in den Protokollen identifiziert.

Tool-Erkennung

Wenn der Agent sich mit dem MCP-Server verbindet, lädt er zunächst die Liste der verfügbaren Tools. Drei Ereignisse markieren diese Phase.

mcp_list_tools.in_progress

{
  "type": "mcp_list_tools.in_progress",
  "server_label": "Internal CRM"
}

Der MCP-Server wird nach seiner Tool-Liste abgefragt.

mcp_list_tools.completed

{
  "type": "mcp_list_tools.completed",
  "server_label": "Internal CRM",
  "tools": [
    {
      "name": "find_customer",
      "description": "Finds a customer by name or email"
    },
    {
      "name": "create_ticket",
      "description": "Creates a support ticket"
    }
  ]
}

Die Tool-Liste wurde erfolgreich abgerufen. Der Sprachagent kann sie nun im Gespräch verwenden.

mcp_list_tools.failed

{
  "type": "mcp_list_tools.failed",
  "server_label": "Internal CRM",
  "error": {
    "message": "Connection timeout"
  }
}

Die Verbindung zum MCP-Server ist fehlgeschlagen. Der Agent führt das Gespräch ohne diese Tools weiter.

MCP-Tool-Aufrufe

Wenn der Agent entscheidet, ein MCP-Tool während des Gesprächs zu verwenden, werden weitere Ereignisse gesendet.

response.mcp_call_arguments.delta / .done

Wie bei den regulären Funktion-Aufruf-Ereignissen streamen diese die Argumente des Aufrufs:

{
  "type": "response.mcp_call_arguments.delta",
  "delta": "{\"name\": \"Mil"
}
{
  "type": "response.mcp_call_arguments.done",
  "arguments": "{\"name\": \"Miller\"}"
}

response.mcp_call.in_progress / .completed / .failed

Diese Ereignisse verfolgen die Ausführung des Aufrufs auf dem MCP-Server:

{
  "type": "response.mcp_call.in_progress",
  "server_label": "Internal CRM",
  "tool_name": "find_customer"
}
{
  "type": "response.mcp_call.completed",
  "server_label": "Internal CRM",
  "tool_name": "find_customer",
  "result": "{\"id\": 42, \"name\": \"Miller\", \"email\": \"[email protected]\"}"
}
{
  "type": "response.mcp_call.failed",
  "server_label": "Internal CRM",
  "tool_name": "find_customer",
  "error": {
    "message": "Customer not found"
  }
}

Unterschiede zum regulären Funktion-Aufruf

MCP-Tools laufen auf der Server-Seite über die Infrastruktur von xAI, sodass Sie die Ausführung selbst nicht handhaben müssen. Das ist der Hauptunterschied zum regulären Funktion-Aufruf, bei dem Ihre Anwendung die Funktion ausführen und das Ergebnis zurücksenden muss.

AspektFunktion-AufrufMCP
AusführungIhre AnwendungEntfernter MCP-Server
ErgebnisSie senden es zurückAutomatisch
LatenzHängt von Ihrem Code abHängt vom MCP-Server ab
KonfigurationLokales JSON-SchemaMCP-Server-URL

MCP-Ereignisse in Ihrer Anwendung verarbeiten

Hier ist ein Beispiel für einen vollständigen Handler für MCP-Ereignisse:

ws.on("message", (data) => {
  const event = JSON.parse(data);

  switch (event.type) {
    case "mcp_list_tools.in_progress":
      console.log(`Connecting to MCP server: ${event.server_label}`);
      break;

    case "mcp_list_tools.completed":
      console.log(`Available tools: ${event.tools.length}`);
      break;

    case "mcp_list_tools.failed":
      console.error(`MCP error: ${event.error.message}`);
      break;

    case "response.mcp_call.in_progress":
      showToolIndicator(event.tool_name);
      break;

    case "response.mcp_call.completed":
      hideToolIndicator();
      break;

    case "response.mcp_call.failed":
      hideToolIndicator();
      showError(`Tool ${event.tool_name} unavailable`);
      break;
  }
});

Kernaussagen

  • MCP-Tools ermöglichen es dem Sprachagenten, über ein standardisiertes Protokoll mit externen Servern zu arbeiten.
  • Die Tool-Erkennung erfolgt automatisch über die mcp_list_tools-Ereignisse.
  • MCP-Aufrufe laufen auf der Server-Seite, im Gegensatz zum regulären Funktion-Aufruf.
  • Jeder Aufruf durchläuft drei mögliche Zustände: in_progress, gefolgt von completed oder failed.
  • Handhaben Sie Verbindungsfehler für MCP angemessen: Der Agent kann ohne die Tools weiterarbeiten.