Avvenimenti MCP f'konversazzjonijiet bil-vuċi
F'din il-paġna
MCP fl-Aġent bil-Vuċi
Il-Protokoll tal-Kuntest tal-Mudell (MCP) jippermetti lill-aġent bil-vuċi tiegħek jikkonnettja ma’ servers ta’ għodod esterni permezz ta’ protokoll standardizzat. Meta tikkonfigura għodda MCP fis-sessjoni tiegħek, l-API tal-Aġent bil-Vuċi temetti avvenimenti speċifiċi għal kull pass tal-interazzjoni mas-server MCP.
Ikkonfigura għodda MCP
Biex tattivà server MCP fis-sessjoni bil-vuċi tiegħek, żidhu fil-lista tal-għodod:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Il-kamp server_url jipponta lejn is-server MCP tiegħek, u server_label huwa isem li jinqara faċilment li jidentifika s-server fil-logs.
Skoperta tal-għodod
Meta l-aġent jikkonnettja mas-server MCP, l-ewwel iġib il-lista tal-għodod disponibbli. Tliet avvenimenti jimmarkaw din il-fażi.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
Is-server MCP qed jiġi mistoqsi għal-lista tal-għodod tiegħu.
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"
}
]
}
Il-lista tal-għodod ġiet miġbura b’suċċess. L-aġent bil-vuċi issa jista’ jużahom fil-konversazzjoni.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Il-konnessjoni mas-server MCP falliet. L-aġent ikompli bil-konversazzjoni mingħajr dawn l-għodod.
Sejħiet ta’ għodod MCP
Meta l-aġent jiddeċiedi li juża għodda MCP matul il-konversazzjoni, jiġu emessi aktar avvenimenti.
response.mcp_call_arguments.delta / .done
Bħall-avvenimenti regolari tas-sejħa tal-funzjonijiet, dawn jixandru l-argumenti tas-sejħa:
{
"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
Dawn l-avvenimenti jsegwu l-eżekuzzjoni tas-sejħa fuq is-server 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"
}
}
Kif dan ivarja mis-sejħa regolari tal-funzjonijiet
L-għodod MCP jaħdmu fuq in-naħa tas-server, permezz tal-infrastruttura ta’ xAI, allura m’għandekx bżonn tittratta l-eżekuzzjoni int stess. Din hija d-differenza prinċipali mis-sejħa regolari tal-funzjonijiet, fejn l-app tiegħek irid iħaddem il-funzjoni u jibgħat lura r-riżultat.
| Aspett | Sejħa tal-funzjonijiet | MCP |
|---|---|---|
| Eżekuzzjoni | L-app tiegħek | Server MCP remot |
| Riżultat | Tibgħatu lura int | Awtomatiku |
| Latenza | Tiddependi fuq il-kodiċi tiegħek | Tiddependi fuq is-server MCP |
| Konfigurazzjoni | Skema JSON lokali | URL tas-server MCP |
Immaniġġja avvenimenti MCP fl-app tiegħek
Hawnhekk hemm eżempju ta’ immaniġġjar sħiħ għal avvenimenti 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;
}
});
Punti Ewlenin
- L-għodod MCP jħallu lill-aġent bil-vuċi jaħdem ma’ servers esterni permezz ta’ protokoll standardizzat
- L-iskoperta tal-għodod iseħħ awtomatikament permezz tal-avvenimenti
mcp_list_tools - Is-sejħiet MCP jaħdmu fuq in-naħa tas-server, b’differenza mis-sejħa regolari tal-funzjonijiet
- Kull sejħa tgħaddi minn tliet stati possibbli:
in_progress, imbagħadcompletedjewfailed - Immaniġġja l-fallimenti tal-konnessjoni MCP b’mod xieraq: l-aġent jista’ jkompli mingħajr l-għodod