Događaji MCP-a u glasovnim razgovorima
Na ovoj stranici
MCP u glasovnom agentu
Protokol Model Context (MCP) omogućuje tvojem glasovnom agentu povezivanje s vanjskim poslužiteljima alata putem standardiziranog protokola. Kada konfiguriraš MCP alat u svojoj sesiji, Voice Agent API emitira specifične događaje za svaki korak interakcije s MCP poslužiteljem.
Konfiguracija MCP alata
Da bi omogućio/la MCP poslužitelj u svojoj glasovnoj sesiji, dodaj ga na popis alata:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Polje server_url pokazuje na tvoj MCP poslužitelj, a server_label je čitljivo ime koje identificira poslužitelj u zapisnicima.
Otkrivanje alata
Kada se agent poveže s MCP poslužiteljem, prvo dohvaća popis dostupnih alata. Tri događaja obilježavaju ovu fazu.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
MCP poslužitelj se upituje za svoj popis alata.
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"
}
]
}
Popis alata uspješno je dohvaćen. Glasovni agent sada ih može koristiti u razgovoru.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Veza s MCP poslužiteljem nije uspjela. Agent će nastaviti razgovor bez tih alata.
Pozivi MCP alata
Kada agent odluči koristiti MCP alat tijekom razgovora, emitira se još događaja.
response.mcp_call_arguments.delta / .done
Poput uobičajenih događaja pozivanja funkcija, ovi streamaju argumente poziva:
{
"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
Ovi događaji prate izvršavanje poziva na MCP poslužitelju:
{
"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 u odnosu na uobičajeno pozivanje funkcija
MCP alati se izvršavaju na strani poslužitelja, putem infrastrukture xAI-ja, tako da ne moraš sam/a rukovati izvršavanjem. To je glavna razlika u odnosu na uobičajeno pozivanje funkcija, gdje tvoja aplikacija mora pokrenuti funkciju i poslati rezultat natrag.
| Aspekt | Pozivanje funkcija | MCP |
|---|---|---|
| Izvršavanje | Tvoja aplikacija | Udaljeni MCP poslužitelj |
| Rezultat | Šalješ ga natrag | Automatski |
| Kašnjenje | Ovisi o tvom kodu | Ovisi o MCP poslužitelju |
| Konfiguracija | Lokalna JSON shema | URL MCP poslužitelja |
Rukovanje MCP događajima u tvojoj aplikaciji
Evo primjera potpunog rukovatelja za MCP događaje:
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 točke
- MCP alati omogućuju glasovnom agentu rad s vanjskim poslužiteljima putem standardiziranog protokola
- Otkrivanje alata događa se automatski kroz događaje
mcp_list_tools - MCP pozivi se izvršavaju na strani poslužitelja, za razliku od uobičajenog pozivanja funkcija
- Svaki poziv prolazi kroz tri moguća stanja:
in_progress, zatimcompletedilifailed - Rukuj neuspjehom veze s MCP-om s pažnjom: agent može nastaviti rad bez tih alata