MCP-Ereignisse in Sprachgesprächen
Auf dieser Seite
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.
| Aspekt | Funktion-Aufruf | MCP |
|---|---|---|
| Ausführung | Ihre Anwendung | Entfernter MCP-Server |
| Ergebnis | Sie senden es zurück | Automatisch |
| Latenz | Hängt von Ihrem Code ab | Hängt vom MCP-Server ab |
| Konfiguration | Lokales JSON-Schema | MCP-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 voncompletedoderfailed. - Handhaben Sie Verbindungsfehler für MCP angemessen: Der Agent kann ohne die Tools weiterarbeiten.