Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Události MCP v hlasových konverzacích

Lekce 12 z 16 Aktualizováno 30. července 2026 Vývojář
Na této stránce
  1. MCP v hlasovém agentovi
  2. Konfigurace nástroje MCP
  3. Objevování nástrojů
  4. Volání nástrojů MCP
  5. Rozdíly oproti běžnému volání funkcí
  6. Zpracování událostí MCP v aplikaci
  7. Klíčové poznatky

MCP v hlasovém agentovi

Protokol Model Context Protocol (MCP) umožňuje tvému hlasovému agentovi připojit se k externím serverům nástrojů prostřednictvím standardizovaného protokolu. Když v relaci nakonfiguruješ nástroj MCP, API hlasového agenta vysílá specifické události pro každý krok interakce se serverem MCP.

Konfigurace nástroje MCP

Chceš-li v hlasové relaci povolit server MCP, přidej jej do seznamu nástrojů:

{
  "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 tvůj server MCP a server_label je čitelný název, který server identifikuje v logách.

Objevování nástrojů

Když se agent připojí k serveru MCP, nejprve získá seznam dostupných nástrojů. Tuto fázi označují tři události.

mcp_list_tools.in_progress

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

Server MCP je dotazován na svůj seznam nástrojů.

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

Seznam nástrojů byl úspěšně získán. Hlasový agent je nyní může použít v konverzaci.

mcp_list_tools.failed

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

Připojení k serveru MCP selhalo. Agent bude v konverzaci pokračovat bez těchto nástrojů.

Volání nástrojů MCP

Když se agent během konverzace rozhodne použít nástroj MCP, jsou vysílány další události.

response.mcp_call_arguments.delta / .done

Stejně jako běžné události volání funkcí tyto události streamují argumenty volání:

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

Tyto události sledují provedení volání na serveru 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"
  }
}

Rozdíly oproti běžnému volání funkcí

Nástroje MCP běží na straně serveru prostřednictvím infrastruktury xAI, takže nemusíš řešit jejich provádění sám. To je hlavní rozdíl oproti běžnému volání funkcí, kde musí tvá aplikace funkci spustit a poslat výsledek zpět.

AspektVolání funkcíMCP
ProvedeníTvá aplikaceVzdálený server MCP
VýsledekPošleš jej zpětAutomaticky
LatenceZávisí na tvém kóduZávisí na serveru MCP
KonfiguraceMístní schéma JSONURL serveru MCP

Zpracování událostí MCP v aplikaci

Zde je příklad kompletního obslužného programu pro události 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;
  }
});

Klíčové poznatky

  • Nástroje MCP umožňují hlasovému agentovi pracovat s externími servery prostřednictvím standardizovaného protokolu
  • Objevování nástrojů probíhá automaticky prostřednictvím událostí mcp_list_tools
  • Volání MCP běží na straně serveru, na rozdíl od běžného volání funkcí
  • Každé volání prochází třemi možnými stavy: in_progress, následně completed nebo failed
  • Chyby připojení MCP zpracovávej elegantně: agent může pokračovat i bez těchto nástrojů