Dogodki MCP v glasovnih pogovorih
Na tej strani
MCP v glasovnem agentu
Protokol Model Context Protocol (MCP) omogoča tvojemu glasovnemu agentu povezavo z zunanjimi strežniki orodij prek standardiziranega protokola. Ko v seji konfiguriraš orodje MCP, API glasovnega agenta za vsak korak interakcije s strežnikom MCP oddaja specifične dogodke.
Konfiguracija orodja MCP
Če želiš v glasovni seji omogočiti strežnik MCP, ga dodaj na seznam orodij:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Polje server_url kaže na tvoj strežnik MCP, server_label pa je berljivo ime, ki strežnik identificira v dnevnikih.
Odkrivanje orodij
Ko se agent poveže s strežnikom MCP, najprej pridobi seznam razpoložljivih orodij. To fazo označujejo trije dogodki.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
Strežnik MCP se poizveduje za seznam svojih orodij.
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 orodij je bil uspešno pridobljen. Glasovni agent jih lahko zdaj uporabi v pogovoru.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Povezava s strežnikom MCP ni uspela. Agent bo nadaljeval pogovor brez teh orodij.
Klici orodij MCP
Ko se agent med pogovorom odloči uporabiti orodje MCP, se oddajo dodatni dogodki.
response.mcp_call_arguments.delta / .done
Tako kot običajni dogodki klicanja funkcij tudi ti pretakajo argumente klica:
{
"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
Ti dogodki sledijo izvajanju klica na strežniku 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"
}
}
Razlike glede na običajno klicanje funkcij
Orodja MCP delujejo na strani strežnika prek infrastrukture xAI, zato ti ni treba samostojno upravljati izvajanja. To je glavna razlika glede na običajno klicanje funkcij, kjer mora tvoja aplikacija izvesti funkcijo in poslati rezultat nazaj.
| Vidik | Klicanje funkcij | MCP |
|---|---|---|
| Izvajanje | Tvoja aplikacija | Oddaljeni strežnik MCP |
| Rezultat | Pošlješ ga nazaj | Samodejno |
| Zakasnitev | Odvisna od tvoje kode | Odvisna od strežnika MCP |
| Konfiguracija | Lokalna shema JSON | URL strežnika MCP |
Obravnava dogodkov MCP v tvoji aplikaciji
Tukaj je primer celovitega obravnavalca dogodkov 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;
}
});
Ključne ugotovitve
- Orodja MCP omogočajo glasovnemu agentu delo z zunanjimi strežniki prek standardiziranega protokola.
- Odkrivanje orodij poteka samodejno prek dogodkov
mcp_list_tools. - Klici MCP se izvajajo na strani strežnika, za razliko od običajnega klicanja funkcij.
- Vsak klic preide skozi tri možna stanja:
in_progress, natocompletedalifailed. - Napake pri povezavi MCP obravnavaj ustrezno: agent lahko nadaljuje brez teh orodij.