MCP-események hangalapú beszélgetésekben
Ezen az oldalon
MCP a Voice Agentben
A Model Context Protocol (MCP) lehetővé teszi, hogy hangalapú ügynököd szabványosított protokollon keresztül külső eszközkiszolgálókhoz csatlakozzon. Amikor MCP-eszközt konfigurálsz a munkamenetedben, a Voice Agent API specifikus eseményeket bocsát ki az MCP-kiszolgálóval való interakció minden egyes lépéséről.
MCP-eszköz konfigurálása
MCP-kiszolgáló engedélyezéséhez a hangmunkamenetedben add hozzá azt az eszközök listájához:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
A server_url mező az MCP-kiszolgálódra mutat, a server_label pedig egy olvasható név, amely azonosítja a kiszolgálót a naplókban.
Eszközfelderítés
Amikor az ügynök csatlakozik az MCP-kiszolgálóhoz, először lekéri az elérhető eszközök listáját. Három esemény jelzi ezt a fázist.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
A rendszer éppen lekérdezi az MCP-kiszolgálót az eszközei listájáról.
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"
}
]
}
Az eszközök listája sikeresen lekérésre került. A hangügynök mostantól használhatja ezeket a beszélgetés során.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Az MCP-kiszolgálóhoz való csatlakozás sikertelen volt. Az ügynök folytatja a beszélgetést ezen eszközök nélkül.
MCP-eszközhívások
Amikor az ügynök úgy dönt, hogy MCP-eszközt használ a beszélgetés során, további események keletkeznek.
response.mcp_call_arguments.delta / .done
A hagyományos függvényhívási eseményekhez hasonlóan ezek streamelik a hívás argumentumait:
{
"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
Ezek az események követik nyomon a hívás végrehajtását az MCP-kiszolgálón:
{
"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"
}
}
Miben tér el a hagyományos függvényhívástól
Az MCP-eszközök kiszolgáló oldalon futnak az xAI infrastruktúráján keresztül, így neked nem kell kezelned a végrehajtást. Ez a fő különbség a hagyományos függvényhíváshoz képest, ahol az alkalmazásodnak kell futtatnia a függvényt és visszaküldenie az eredményt.
| Szempont | Függvényhívás | MCP |
|---|---|---|
| Végrehajtás | A te alkalmazásod | Távoli MCP-kiszolgáló |
| Eredmény | Te küldöd vissza | Automatikus |
| Késleltetés | A kódodtól függ | Az MCP-kiszolgálótól függ |
| Konfiguráció | Helyi JSON séma | MCP-kiszolgáló URL |
MCP-események kezelése az alkalmazásodban
Íme egy példa egy teljes körű kezelőre az MCP-eseményekhez:
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;
}
});
Főbb megállapítások
- Az MCP-eszközök lehetővé teszik, hogy a hangügynök szabványosított protokollon keresztül dolgozzon külső kiszolgálókkal
- Az eszközfelderítés automatikusan történik az
mcp_list_toolseseményeken keresztül - Az MCP-hívások kiszolgáló oldalon futnak, ellentétben a hagyományos függvényhívással
- Minden hívás három lehetséges állapoton megy keresztül:
in_progress, majdcompletedvagyfailed - Kezeld gracefully az MCP-kapcsolódási hibákat: az ügynök képes folytatni a munkát az eszközök nélkül is