Evenimente MCP în conversațiile vocale
Pe această pagină
MCP în Agentul Vocal
Protocolul Model Context (MCP) permite agentului vocal să se conecteze la servere de instrumente externe printr-un protocol standardizat. Atunci când configurați un instrument MCP în sesiunea dumneavoastră, API-ul Voice Agent emite evenimente specifice pentru fiecare etapă a interacțiunii cu serverul MCP.
Configurarea unui instrument MCP
Pentru a activa un server MCP în sesiunea vocală, adăugați-l la lista de instrumente:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Câmpul server_url indică serverul MCP, iar server_label este un nume lizibil care identifică serverul în jurnale.
Descoperirea instrumentelor
Atunci când agentul se conectează la serverul MCP, acesta preia mai întâi lista instrumentelor disponibile. Trei evenimente marchează această fază.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
Serverul MCP este interogat pentru lista sa de instrumente.
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"
}
]
}
Lista de instrumente a fost preluată cu succes. Agentul vocal le poate utiliza acum în conversație.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Conexiunea la serverul MCP a eșuat. Agentul va continua conversația fără aceste instrumente.
Apeluri de instrumente MCP
Atunci când agentul decide să utilizeze un instrument MCP în timpul conversației, sunt emise mai multe evenimente.
response.mcp_call_arguments.delta / .done
La fel ca evenimentele obișnuite de apelare a funcțiilor, acestea transmit în flux argumentele apelului:
{
"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
Aceste evenimente urmăresc execuția apelului pe serverul 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"
}
}
Diferențele față de apelarea obișnuită a funcțiilor
Instrumentele MCP rulează pe partea de server, prin infrastructura xAI, astfel încât nu trebuie să gestionați execuția dumneavoastră. Aceasta este principala diferență față de apelarea obișnuită a funcțiilor, unde aplicația dumneavoastră trebuie să execute funcția și să trimită înapoi rezultatul.
| Aspect | Apelare funcții | MCP |
|---|---|---|
| Execuție | Aplicația dumneavoastră | Server MCP la distanță |
| Rezultat | Îl trimiteți dumneavoastră | Automat |
| Latență | Depinde de codul dumneavoastră | Depinde de serverul MCP |
| Configurare | Schemă JSON locală | URL server MCP |
Gestionarea evenimentelor MCP în aplicația dumneavoastră
Iată un exemplu de gestionar complet pentru evenimentele 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;
}
});
Puncte cheie
- Instrumentele MCP permit agentului vocal să lucreze cu servere externe printr-un protocol standardizat
- Descoperirea instrumentelor are loc automat prin evenimentele
mcp_list_tools - Apelurile MCP rulează pe partea de server, spre deosebire de apelarea obișnuită a funcțiilor
- Fiecare apel parcurge trei stări posibile:
in_progress, apoicompletedsaufailed - Gestionați cu grijă erorile de conexiune MCP: agentul poate continua fără aceste instrumente