Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

MCP-események hangalapú beszélgetésekben

12. lecke 16 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. MCP a Voice Agentben
  2. MCP-eszköz konfigurálása
  3. Eszközfelderítés
  4. MCP-eszközhívások
  5. Miben tér el a hagyományos függvényhívástól
  6. MCP-események kezelése az alkalmazásodban
  7. Főbb megállapítások

MCP a Voice Agentben

A Model Context Protocol (MCP) lehetővé teszi, hogy hangalapú ügynököd szabványosított protokollon keresztül külső eszközkiszolgálókhoz csatlakozzon. Amikor MCP-eszközt konfigurálsz a munkamenetedben, a Voice Agent API specifikus eseményeket bocsát ki az MCP-kiszolgálóval való interakció minden egyes lépéséről.

MCP-eszköz konfigurálása

MCP-kiszolgáló engedélyezéséhez a hangmunkamenetedben add hozzá azt az eszközök listájához:

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

A server_url mező az MCP-kiszolgálódra mutat, a server_label pedig egy olvasható név, amely azonosítja a kiszolgálót a naplókban.

Eszközfelderítés

Amikor az ügynök csatlakozik az MCP-kiszolgálóhoz, először lekéri az elérhető eszközök listáját. Három esemény jelzi ezt a fázist.

mcp_list_tools.in_progress

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

A rendszer éppen lekérdezi az MCP-kiszolgálót az eszközei listájáról.

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

Az eszközök listája sikeresen lekérésre került. A hangügynök mostantól használhatja ezeket a beszélgetés során.

mcp_list_tools.failed

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

Az MCP-kiszolgálóhoz való csatlakozás sikertelen volt. Az ügynök folytatja a beszélgetést ezen eszközök nélkül.

MCP-eszközhívások

Amikor az ügynök úgy dönt, hogy MCP-eszközt használ a beszélgetés során, további események keletkeznek.

response.mcp_call_arguments.delta / .done

A hagyományos függvényhívási eseményekhez hasonlóan ezek streamelik a hívás argumentumait:

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

Ezek az események követik nyomon a hívás végrehajtását az MCP-kiszolgálón:

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

Miben tér el a hagyományos függvényhívástól

Az MCP-eszközök kiszolgáló oldalon futnak az xAI infrastruktúráján keresztül, így neked nem kell kezelned a végrehajtást. Ez a fő különbség a hagyományos függvényhíváshoz képest, ahol az alkalmazásodnak kell futtatnia a függvényt és visszaküldenie az eredményt.

SzempontFüggvényhívásMCP
VégrehajtásA te alkalmazásodTávoli MCP-kiszolgáló
EredményTe küldöd visszaAutomatikus
KésleltetésA kódodtól függAz MCP-kiszolgálótól függ
KonfigurációHelyi JSON sémaMCP-kiszolgáló URL

MCP-események kezelése az alkalmazásodban

Íme egy példa egy teljes körű kezelőre az MCP-eseményekhez:

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

Főbb megállapítások

  • Az MCP-eszközök lehetővé teszik, hogy a hangügynök szabványosított protokollon keresztül dolgozzon külső kiszolgálókkal
  • Az eszközfelderítés automatikusan történik az mcp_list_tools eseményeken keresztül
  • Az MCP-hívások kiszolgáló oldalon futnak, ellentétben a hagyományos függvényhívással
  • Minden hívás három lehetséges állapoton megy keresztül: in_progress, majd completed vagy failed
  • Kezeld gracefully az MCP-kapcsolódási hibákat: az ügynök képes folytatni a munkát az eszközök nélkül is