Przejdź do głównej treści
Polski— Wybierz język
Menu

Zdarzenia MCP w rozmowach głosowych

Lekcja 12 z 16 Zaktualizowano 30 lipca 2026 Programista
Na tej stronie
  1. MCP w Voice Agent
  2. Konfiguracja narzędzia MCP
  3. Wykrywanie narzędzi
  4. Wywołania narzędzi MCP
  5. Różnice względem zwykłego wywoływania funkcji
  6. Obsługa zdarzeń MCP w aplikacji
  7. Kluczowe wnioski

MCP w Voice Agent

Model Context Protocol (MCP) pozwala Twojemu agentowi głosowemu łączyć się z zewnętrznymi serwerami narzędzi za pomocą standaryzowanego protokołu. Gdy skonfigurujesz narzędzie MCP w swojej sesji, Voice Agent API emituje określone zdarzenia dla każdego etapu interakcji z serwerem MCP.

Konfiguracja narzędzia MCP

Aby włączyć serwer MCP w sesji głosowej, dodaj go do listy narzędzi:

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

Pole server_url wskazuje Twój serwer MCP, a server_label to czytelna nazwa identyfikująca serwer w logach.

Wykrywanie narzędzi

Gdy agent łączy się z serwerem MCP, najpierw pobiera listę dostępnych narzędzi. Trzy zdarzenia oznaczają tę fazę.

mcp_list_tools.in_progress

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

Serwer MCP jest odpytywany o listę swoich narzędzi.

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

Lista narzędzi została pomyślnie pobrana. Agent głosowy może teraz używać ich w rozmowie.

mcp_list_tools.failed

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

Połączenie z serwerem MCP nie powiodło się. Agent będzie kontynuował rozmowę bez tych narzędzi.

Wywołania narzędzi MCP

Gdy agent zdecyduje się użyć narzędzia MCP podczas rozmowy, emitowanych jest więcej zdarzeń.

response.mcp_call_arguments.delta / .done

Podobnie jak w przypadku zwykłych zdarzeń wywoływania funkcji, zdarzenia te strumieniują argumenty wywołania:

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

Zdarzenia te śledzą wykonanie wywołania na serwerze 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"
  }
}

Różnice względem zwykłego wywoływania funkcji

Narzędzia MCP działają po stronie serwera, poprzez infrastrukturę xAI, więc nie musisz samodzielnie obsługiwać ich wykonania. To główna różnica w porównaniu ze zwykłym wywoływaniem funkcji, gdzie Twoja aplikacja musi uruchomić funkcję i odesłać wynik.

AspektWywoływanie funkcjiMCP
WykonanieTwoja aplikacjaZdalny serwer MCP
WynikWysyłasz go z powrotemAutomatyczny
OpóźnienieZależy od Twojego koduZależy od serwera MCP
KonfiguracjaLokalny schemat JSONAdres URL serwera MCP

Obsługa zdarzeń MCP w aplikacji

Oto przykład kompletnego handlera dla zdarzeń 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;
  }
});

Kluczowe wnioski

  • Narzędzia MCP pozwalają agentowi głosowemu współpracować z zewnętrznymi serwerami poprzez standaryzowany protokół
  • Wykrywanie narzędzi odbywa się automatycznie poprzez zdarzenia mcp_list_tools
  • Wywołania MCP działają po stronie serwera, w przeciwieństwie do zwykłego wywoływania funkcji
  • Każde wywołanie przechodzi przez trzy możliwe stany: in_progress, a następnie completed lub failed
  • Obsługuj błędy połączenia MCP w sposób bezpieczny: agent może kontynuować działanie bez tych narzędzi