MCP-begivenheder i talesamtaler
På denne side
MCP i Voice Agent
Model Context Protocol (MCP) giver din taleagent mulighed for at forbinde til eksterne værktøjsservere via en standardiseret protokol. Når du konfigurerer et MCP-værktøj i din session, udsender Voice Agent API specifikke begivenheder for hvert trin i interaktionen med MCP-serveren.
Konfigurér et MCP-værktøj
For at aktivere en MCP-server i din talesession skal du tilføje den til listen over værktøjer:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Feltet server_url peger på din MCP-server, og server_label er et læsbart navn, der identificerer serveren i logfilerne.
Opdagelse af værktøjer
Når agenten forbinder til MCP-serveren, henter den først listen over tilgængelige værktøjer. Tre begivenheder markerer denne fase.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
MCP-serveren bliver forespurgt om sin liste over værktøjer.
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"
}
]
}
Listen over værktøjer blev hentet succesfuldt. Taleagenten kan nu bruge dem i samtalen.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Forbindelsen til MCP-serveren mislykkedes. Agenten fortsætter samtalen uden disse værktøjer.
MCP-værktøjskald
Når agenten beslutter at bruge et MCP-værktøj under samtalen, udsendes flere begivenheder.
response.mcp_call_arguments.delta / .done
Ligesom de almindelige begivenheder for funktionskald streamer disse kaldets argumenter:
{
"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
Disse begivenheder sporer udførelsen af kaldet på MCP-serveren:
{
"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"
}
}
Hvordan det adskiller sig fra almindeligt funktionskald
MCP-værktøjer kører på serversiden gennem xAIs infrastruktur, så du behøver ikke håndtere udførelsen selv. Det er den væsentligste forskel fra almindeligt funktionskald, hvor din app skal køre funktionen og sende resultatet tilbage.
| Aspekt | Funktionskald | MCP |
|---|---|---|
| Udførelse | Din app | Fjern-MCP-server |
| Resultat | Du sender det tilbage | Automatisk |
| Latens | Afhænger af din kode | Afhænger af MCP-serveren |
| Konfiguration | Lokalt JSON-skema | MCP-server-URL |
Håndtér MCP-begivenheder i din app
Her er et eksempel på en komplet håndterer til MCP-begivenheder:
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;
}
});
Vigtige pointer
- MCP-værktøjer lader taleagenten arbejde med eksterne servere via en standardiseret protokol
- Opdagelse af værktøjer sker automatisk gennem
mcp_list_tools-begivenhederne - MCP-kald kører på serversiden, i modsætning til almindeligt funktionskald
- Hvert kald gennemgår tre mulige tilstande:
in_progress, dereftercompletedellerfailed - Håndtér MCP-forbindelsesfejl elegant: agenten kan fortsætte uden værktøjerne