Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Avvenimenti MCP f'konversazzjonijiet bil-vuċi

Lezzjoni 12 / 16 Aġġornat 30 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. MCP fl-Aġent bil-Vuċi
  2. Ikkonfigura għodda MCP
  3. Skoperta tal-għodod
  4. Sejħiet ta’ għodod MCP
  5. Kif dan ivarja mis-sejħa regolari tal-funzjonijiet
  6. Immaniġġja avvenimenti MCP fl-app tiegħek
  7. Punti Ewlenin

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.

AspettSejħa tal-funzjonijietMCP
EżekuzzjoniL-app tiegħekServer MCP remot
RiżultatTibgħatu lura intAwtomatiku
LatenzaTiddependi fuq il-kodiċi tiegħekTiddependi fuq is-server MCP
KonfigurazzjoniSkema JSON lokaliURL 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ħad completed jew failed
  • Immaniġġja l-fallimenti tal-konnessjoni MCP b’mod xieraq: l-aġent jista’ jkompli mingħajr l-għodod