MCP sündmused helikõnedes
Sellel lehel
MCP heliagendis
Model Context Protocol (MCP) võimaldab sinu heliagendil ühenduda väliste tööriistaserveritega standardiseeritud protokolli kaudu. Kui konfigureerid oma seansis MCP tööriista, edastab Voice Agent API iga MCP-serveriga suhtlemise sammu kohta spetsiifilisi sündmusi.
MCP tööriista konfigureerimine
MCP-serveri lubamiseks oma heliseansis lisa see tööriistade loendisse:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Väli server_url viitab sinu MCP-serverile ja server_label on loetav nimi, mis identifitseerib serverit logides.
Tööriistade avastamine
Kui agent ühendub MCP-serveriga, hangib see esmalt saadaolevate tööriistade loendi. Seda etappi tähistavad kolm sündmust.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
MCP-serverilt päritakse selle tööriistade loendit.
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"
}
]
}
Tööriistade loend hangiti edukalt. Heliagent saab neid nüüd vestluses kasutada.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Ühendus MCP-serveriga ebaõnnestus. Agent jätkab vestlust ilma nende tööriistadeta.
MCP tööriistakutsed
Kui agent otsustab vestluse käigus kasutada MCP tööriista, edastatakse täiendavaid sündmusi.
response.mcp_call_arguments.delta / .done
Nagu tavaliste funktsioonikutsete sündmuste puhul, edastavad need kutse argumente voogedastusena:
{
"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
Need sündmused jälgivad kutse täitmist MCP-serveris:
{
"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"
}
}
Kuidas see erineb tavalisest funktsioonikutsest
MCP tööriistad töötavad serveripoolselt xAI taristu kaudu, nii et sul pole vaja täitmist ise hallata. See on peamine erinevus tavapärasest funktsioonikutsest, kus sinu rakendus peab funktsiooni käivitama ja tulemuse tagasi saatma.
| Aspekt | Funktsioonikutse | MCP |
|---|---|---|
| Täitmine | Sinu rakendus | Kauge MCP-server |
| Tulemus | Saadad selle tagasi | Automaatne |
| Latentsus | Sõltub sinu koodist | Sõltub MCP-serverist |
| Konfiguratsioon | Kohalik JSON skeem | MCP-serveri URL |
MCP sündmuste haldamine oma rakenduses
Siin on näide MCP sündmuste täielikust käitlejast:
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;
}
});
Peamised punktid
- MCP tööriistad võimaldavad heliagendil töötada väliste serveritega standardiseeritud protokolli kaudu
- Tööriistade avastamine toimub automaatselt
mcp_list_toolssündmuste kaudu - MCP kutsed töötavad serveripoolselt, erinevalt tavalisest funktsioonikutsest
- Iga kutse läbib kolm võimalikku olekut:
in_progress, seejärelcompletedvõifailed - Käitle MCP ühendusvigu graatsiliselt: agent saab jätkata ka ilma nende tööriistadeta