MCP įvykiai balso pokalbiuose
Šiame puslapyje
MCP balso agente
Modelio konteksto protokolas (MCP) leidžia tavo balso agentui jungtis prie išorinių įrankių serverių naudojant standartizuotą protokolą. Kai sesijoje sukonfigūruoji MCP įrankį, balso agento API generuoja specifinius įvykius kiekvienam sąveikos su MCP serveriu etapui.
MCP įrankio konfigūravimas
Norėdamas įgalinti MCP serverį savo balso sesijoje, pridėk jį prie įrankių sąrašo:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Laukas server_url nurodo tavo MCP serverį, o server_label yra skaitomas pavadinimas, identifikuojantis serverį žurnaluose.
Įrankių atradimas
Kai agentas prisijungia prie MCP serverio, jis pirmiausia gauna galimų įrankių sąrašą. Šį etapą žymi trys įvykiai.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
MCP serveris yra užklausiamas dėl savo įrankių sąrašo.
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"
}
]
}
Įrankių sąrašas sėkmingai gautas. Dabar balso agentas gali juos naudoti pokalbyje.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Ryšys su MCP serveriu nepavyko. Agentas tęs pokalbį be šių įrankių.
MCP įrankių kvietimai
Kai agentas pokalbio metu nusprendžia naudoti MCP įrankį, generuojami papildomi įvykiai.
response.mcp_call_arguments.delta / .done
Kaip ir įprastų funkcijų kvietimo įvykių atveju, šie įvykiai perduoda kvietimo argumentus srautu:
{
"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
Šie įvykiai stebi kvietimo vykdymą MCP serveryje:
{
"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"
}
}
Kuo tai skiriasi nuo įprasto funkcijų kvietimo
MCP įrankiai vykdomi serverio pusėje per xAI infrastruktūrą, todėl tau nereikia pačiam valdyti jų vykdymo. Tai pagrindinis skirtumas nuo įprasto funkcijų kvietimo, kai tavo programėlė turi vykdyti funkciją ir grąžinti rezultatą.
| Aspektas | Funkcijų kvietimas | MCP |
|---|---|---|
| Vykdymas | Tavo programėlė | Nutolęs MCP serveris |
| Rezultatas | Siunčiats jį atgal | Automatinis |
| Vėlavimas | Priklauso nuo tavo kodo | Priklauso nuo MCP serverio |
| Konfigūravimas | Vietinė JSON schema | MCP serverio URL |
MCP įvykių valdymas tavo programėlėje
Štai pilnas MCP įvykių tvarkyklės pavyzdys:
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;
}
});
Svarbiausi punktai
- MCP įrankiai leidžia balso agentui dirbti su išoriniais serveriais naudodami standartizuotą protokolą
- Įrankių atradimas vyksta automatiškai per
mcp_list_toolsįvykius - MCP kvietimai vykdomi serverio pusėje, skirtingai nei įprastas funkcijų kvietimas
- Kiekvienas kvietimas pereina per tris galimas būsenas:
in_progress, tadacompletedarbafailed - MCP ryšio klaidas tvarkykite tinkamai: agentas gali tęsti darbą be šių įrankių