Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Događaji MCP-a u glasovnim razgovorima

Lekcija 12 od 16 Ažurirano 30. srpnja 2026. Programer
Na ovoj stranici
  1. MCP u glasovnom agentu
  2. Konfiguracija MCP alata
  3. Otkrivanje alata
  4. Pozivi MCP alata
  5. Razlike u odnosu na uobičajeno pozivanje funkcija
  6. Rukovanje MCP događajima u tvojoj aplikaciji
  7. Ključne točke

MCP u glasovnom agentu

Protokol Model Context (MCP) omogućuje tvojem glasovnom agentu povezivanje s vanjskim poslužiteljima alata putem standardiziranog protokola. Kada konfiguriraš MCP alat u svojoj sesiji, Voice Agent API emitira specifične događaje za svaki korak interakcije s MCP poslužiteljem.

Konfiguracija MCP alata

Da bi omogućio/la MCP poslužitelj u svojoj glasovnoj sesiji, dodaj ga na popis alata:

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

Polje server_url pokazuje na tvoj MCP poslužitelj, a server_label je čitljivo ime koje identificira poslužitelj u zapisnicima.

Otkrivanje alata

Kada se agent poveže s MCP poslužiteljem, prvo dohvaća popis dostupnih alata. Tri događaja obilježavaju ovu fazu.

mcp_list_tools.in_progress

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

MCP poslužitelj se upituje za svoj popis alata.

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

Popis alata uspješno je dohvaćen. Glasovni agent sada ih može koristiti u razgovoru.

mcp_list_tools.failed

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

Veza s MCP poslužiteljem nije uspjela. Agent će nastaviti razgovor bez tih alata.

Pozivi MCP alata

Kada agent odluči koristiti MCP alat tijekom razgovora, emitira se još događaja.

response.mcp_call_arguments.delta / .done

Poput uobičajenih događaja pozivanja funkcija, ovi streamaju argumente poziva:

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

Ovi događaji prate izvršavanje poziva na MCP poslužitelju:

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

Razlike u odnosu na uobičajeno pozivanje funkcija

MCP alati se izvršavaju na strani poslužitelja, putem infrastrukture xAI-ja, tako da ne moraš sam/a rukovati izvršavanjem. To je glavna razlika u odnosu na uobičajeno pozivanje funkcija, gdje tvoja aplikacija mora pokrenuti funkciju i poslati rezultat natrag.

AspektPozivanje funkcijaMCP
IzvršavanjeTvoja aplikacijaUdaljeni MCP poslužitelj
RezultatŠalješ ga natragAutomatski
KašnjenjeOvisi o tvom koduOvisi o MCP poslužitelju
KonfiguracijaLokalna JSON shemaURL MCP poslužitelja

Rukovanje MCP događajima u tvojoj aplikaciji

Evo primjera potpunog rukovatelja za MCP događaje:

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

Ključne točke

  • MCP alati omogućuju glasovnom agentu rad s vanjskim poslužiteljima putem standardiziranog protokola
  • Otkrivanje alata događa se automatski kroz događaje mcp_list_tools
  • MCP pozivi se izvršavaju na strani poslužitelja, za razliku od uobičajenog pozivanja funkcija
  • Svaki poziv prolazi kroz tri moguća stanja: in_progress, zatim completed ili failed
  • Rukuj neuspjehom veze s MCP-om s pažnjom: agent može nastaviti rad bez tih alata