Udalosti MCP v hlasových konverzáciách
Na tejto strane
MCP v hlasovom agentovi
Protokol Model Context Protocol (MCP) umožňuje tvojmu hlasovému agentovi pripájať sa k externým serverom nástrojov prostredníctvom štandardizovaného protokolu. Keď v relácii nakonfiguruješ nástroj MCP, API hlasového agenta vysiela špecifické udalosti pre každý krok interakcie so serverom MCP.
Konfigurácia nástroja MCP
Ak chceš povoliť server MCP vo svojej hlasovej relácii, pridaj ho do zoznamu nástrojov:
{
"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 tvoj server MCP a server_label je čitateľný názov, ktorý identifikuje server v logoch.
Objavovanie nástrojov
Keď sa agent pripojí k serveru MCP, najprv získa zoznam dostupných nástrojov. Túto fázu označujú tri udalosti.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
Server MCP sa dopytuje na svoj zoznam nástrojov.
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"
}
]
}
Zoznam nástrojov sa úspešne získal. Hlasový agent ich teraz môže používať v konverzácii.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Pripojenie k serveru MCP zlyhalo. Agent bude v konverzácii pokračovať bez týchto nástrojov.
Volania nástrojov MCP
Keď sa agent počas konverzácie rozhodne použiť nástroj MCP, vysielajú sa ďalšie udalosti.
response.mcp_call_arguments.delta / .done
Rovnako ako bežné udalosti volania funkcií, tieto streamujú argumenty volania:
{
"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
Tieto udalosti sledujú vykonanie volania na serveri 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"
}
}
Rozdiely oproti bežnému volaniu funkcií
Nástroje MCP bežia na strane servera prostredníctvom infraštruktúry xAI, takže nemusíš sami riešiť ich vykonávanie. To je hlavný rozdiel oproti bežnému volaniu funkcií, kde tvoja aplikácia musí funkciu spustiť a poslať späť výsledok.
| Aspekt | Volanie funkcií | MCP |
|---|---|---|
| Vykonávanie | Tvoja aplikácia | Vzdialený server MCP |
| Výsledok | Pošleš ho späť | Automaticky |
| Latencia | Závisí od tvojho kódu | Závisí od servera MCP |
| Konfigurácia | Lokálna schéma JSON | URL servera MCP |
Spracovanie udalostí MCP v tvojej aplikácii
Tu je príklad kompletného obslužného programu pre udalosti 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;
}
});
Kľúčové poznatky
- Nástroje MCP umožňujú hlasovému agentovi pracovať s externými servermi prostredníctvom štandardizovaného protokolu
- Objavovanie nástrojov prebieha automaticky prostredníctvom udalostí
mcp_list_tools - Volania MCP bežia na strane servera, na rozdiel od bežného volania funkcií
- Každé volanie prejde tromi možnými stavmi:
in_progress, následnecompletedalebofailed - Chyby pripojenia MCP ošetruj elegantne: agent môže pokračovať aj bez týchto nástrojov