Lähe põhisisu juurde
Eesti— Vali keel
Menüü

MCP sündmused helikõnedes

Õppetund 12 / 16 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. MCP heliagendis
  2. MCP tööriista konfigureerimine
  3. Tööriistade avastamine
  4. MCP tööriistakutsed
  5. Kuidas see erineb tavalisest funktsioonikutsest
  6. MCP sündmuste haldamine oma rakenduses
  7. Peamised punktid

MCP heliagendis

Model Context Protocol (MCP) võimaldab sinu heliagendil ühenduda väliste tööriistaserveritega standardiseeritud protokolli kaudu. Kui konfigureerid oma seansis MCP tööriista, edastab Voice Agent API iga MCP-serveriga suhtlemise sammu kohta spetsiifilisi sündmusi.

MCP tööriista konfigureerimine

MCP-serveri lubamiseks oma heliseansis lisa see tööriistade loendisse:

{
  "type": "session.update",
  "session": {
    "tools": [
      {
        "type": "mcp",
        "server_url": "https://mon-serveur-mcp.exemple.com/sse",
        "server_label": "Internal CRM"
      }
    ]
  }
}

Väli server_url viitab sinu MCP-serverile ja server_label on loetav nimi, mis identifitseerib serverit logides.

Tööriistade avastamine

Kui agent ühendub MCP-serveriga, hangib see esmalt saadaolevate tööriistade loendi. Seda etappi tähistavad kolm sündmust.

mcp_list_tools.in_progress

{
  "type": "mcp_list_tools.in_progress",
  "server_label": "Internal CRM"
}

MCP-serverilt päritakse selle tööriistade loendit.

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"
    }
  ]
}

Tööriistade loend hangiti edukalt. Heliagent saab neid nüüd vestluses kasutada.

mcp_list_tools.failed

{
  "type": "mcp_list_tools.failed",
  "server_label": "Internal CRM",
  "error": {
    "message": "Connection timeout"
  }
}

Ühendus MCP-serveriga ebaõnnestus. Agent jätkab vestlust ilma nende tööriistadeta.

MCP tööriistakutsed

Kui agent otsustab vestluse käigus kasutada MCP tööriista, edastatakse täiendavaid sündmusi.

response.mcp_call_arguments.delta / .done

Nagu tavaliste funktsioonikutsete sündmuste puhul, edastavad need kutse argumente voogedastusena:

{
  "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

Need sündmused jälgivad kutse täitmist MCP-serveris:

{
  "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"
  }
}

Kuidas see erineb tavalisest funktsioonikutsest

MCP tööriistad töötavad serveripoolselt xAI taristu kaudu, nii et sul pole vaja täitmist ise hallata. See on peamine erinevus tavapärasest funktsioonikutsest, kus sinu rakendus peab funktsiooni käivitama ja tulemuse tagasi saatma.

AspektFunktsioonikutseMCP
TäitmineSinu rakendusKauge MCP-server
TulemusSaadad selle tagasiAutomaatne
LatentsusSõltub sinu koodistSõltub MCP-serverist
KonfiguratsioonKohalik JSON skeemMCP-serveri URL

MCP sündmuste haldamine oma rakenduses

Siin on näide MCP sündmuste täielikust käitlejast:

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;
  }
});

Peamised punktid

  • MCP tööriistad võimaldavad heliagendil töötada väliste serveritega standardiseeritud protokolli kaudu
  • Tööriistade avastamine toimub automaatselt mcp_list_tools sündmuste kaudu
  • MCP kutsed töötavad serveripoolselt, erinevalt tavalisest funktsioonikutsest
  • Iga kutse läbib kolm võimalikku olekut: in_progress, seejärel completed või failed
  • Käitle MCP ühendusvigu graatsiliselt: agent saab jätkata ka ilma nende tööriistadeta