Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Udalosti MCP v hlasových konverzáciách

Lekcia 12 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. MCP v hlasovom agentovi
  2. Konfigurácia nástroja MCP
  3. Objavovanie nástrojov
  4. Volania nástrojov MCP
  5. Rozdiely oproti bežnému volaniu funkcií
  6. Spracovanie udalostí MCP v tvojej aplikácii
  7. Kľúčové poznatky

MCP v hlasovom agentovi

Protokol Model Context Protocol (MCP) umožňuje tvojmu hlasovému agentovi pripájať sa k externým serverom nástrojov prostredníctvom štandardizovaného protokolu. Keď v relácii nakonfiguruješ nástroj MCP, API hlasového agenta vysiela špecifické udalosti pre každý krok interakcie so serverom MCP.

Konfigurácia nástroja MCP

Ak chceš povoliť server MCP vo svojej hlasovej relácii, pridaj ho do zoznamu nástrojov:

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

Pole server_url odkazuje na tvoj server MCP a server_label je čitateľný názov, ktorý identifikuje server v logoch.

Objavovanie nástrojov

Keď sa agent pripojí k serveru MCP, najprv získa zoznam dostupných nástrojov. Túto fázu označujú tri udalosti.

mcp_list_tools.in_progress

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

Server MCP sa dopytuje na svoj zoznam nástrojov.

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

Zoznam nástrojov sa úspešne získal. Hlasový agent ich teraz môže používať v konverzácii.

mcp_list_tools.failed

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

Pripojenie k serveru MCP zlyhalo. Agent bude v konverzácii pokračovať bez týchto nástrojov.

Volania nástrojov MCP

Keď sa agent počas konverzácie rozhodne použiť nástroj MCP, vysielajú sa ďalšie udalosti.

response.mcp_call_arguments.delta / .done

Rovnako ako bežné udalosti volania funkcií, tieto streamujú argumenty volania:

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

Tieto udalosti sledujú vykonanie volania na serveri 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"
  }
}

Rozdiely oproti bežnému volaniu funkcií

Nástroje MCP bežia na strane servera prostredníctvom infraštruktúry xAI, takže nemusíš sami riešiť ich vykonávanie. To je hlavný rozdiel oproti bežnému volaniu funkcií, kde tvoja aplikácia musí funkciu spustiť a poslať späť výsledok.

AspektVolanie funkciíMCP
VykonávanieTvoja aplikáciaVzdialený server MCP
VýsledokPošleš ho späťAutomaticky
LatenciaZávisí od tvojho kóduZávisí od servera MCP
KonfiguráciaLokálna schéma JSONURL servera MCP

Spracovanie udalostí MCP v tvojej aplikácii

Tu je príklad kompletného obslužného programu pre udalosti 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;
  }
});

Kľúčové poznatky

  • Nástroje MCP umožňujú hlasovému agentovi pracovať s externými servermi prostredníctvom štandardizovaného protokolu
  • Objavovanie nástrojov prebieha automaticky prostredníctvom udalostí mcp_list_tools
  • Volania MCP bežia na strane servera, na rozdiel od bežného volania funkcií
  • Každé volanie prejde tromi možnými stavmi: in_progress, následne completed alebo failed
  • Chyby pripojenia MCP ošetruj elegantne: agent môže pokračovať aj bez týchto nástrojov