Události MCP v hlasových konverzacích
Na této stránce
MCP v hlasovém agentovi
Protokol Model Context Protocol (MCP) umožňuje tvému hlasovému agentovi připojit se k externím serverům nástrojů prostřednictvím standardizovaného protokolu. Když v relaci nakonfiguruješ nástroj MCP, API hlasového agenta vysílá specifické události pro každý krok interakce se serverem MCP.
Konfigurace nástroje MCP
Chceš-li v hlasové relaci povolit server MCP, přidej jej do seznamu nástrojů:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Pole server_url odkazuje na tvůj server MCP a server_label je čitelný název, který server identifikuje v logách.
Objevování nástrojů
Když se agent připojí k serveru MCP, nejprve získá seznam dostupných nástrojů. Tuto fázi označují tři události.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
Server MCP je dotazován na svůj seznam nástrojů.
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"
}
]
}
Seznam nástrojů byl úspěšně získán. Hlasový agent je nyní může použít v konverzaci.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Připojení k serveru MCP selhalo. Agent bude v konverzaci pokračovat bez těchto nástrojů.
Volání nástrojů MCP
Když se agent během konverzace rozhodne použít nástroj MCP, jsou vysílány další události.
response.mcp_call_arguments.delta / .done
Stejně jako běžné události volání funkcí tyto události streamují argumenty volání:
{
"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
Tyto události sledují provedení volání na serveru MCP:
{
"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"
}
}
Rozdíly oproti běžnému volání funkcí
Nástroje MCP běží na straně serveru prostřednictvím infrastruktury xAI, takže nemusíš řešit jejich provádění sám. To je hlavní rozdíl oproti běžnému volání funkcí, kde musí tvá aplikace funkci spustit a poslat výsledek zpět.
| Aspekt | Volání funkcí | MCP |
|---|---|---|
| Provedení | Tvá aplikace | Vzdálený server MCP |
| Výsledek | Pošleš jej zpět | Automaticky |
| Latence | Závisí na tvém kódu | Závisí na serveru MCP |
| Konfigurace | Místní schéma JSON | URL serveru MCP |
Zpracování událostí MCP v aplikaci
Zde je příklad kompletního obslužného programu pro události MCP:
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;
}
});
Klíčové poznatky
- Nástroje MCP umožňují hlasovému agentovi pracovat s externími servery prostřednictvím standardizovaného protokolu
- Objevování nástrojů probíhá automaticky prostřednictvím událostí
mcp_list_tools - Volání MCP běží na straně serveru, na rozdíl od běžného volání funkcí
- Každé volání prochází třemi možnými stavy:
in_progress, následněcompletednebofailed - Chyby připojení MCP zpracovávej elegantně: agent může pokračovat i bez těchto nástrojů