Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Dogodki MCP v glasovnih pogovorih

Lekcija 12 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. MCP v glasovnem agentu
  2. Konfiguracija orodja MCP
  3. Odkrivanje orodij
  4. Klici orodij MCP
  5. Razlike glede na običajno klicanje funkcij
  6. Obravnava dogodkov MCP v tvoji aplikaciji
  7. Ključne ugotovitve

MCP v glasovnem agentu

Protokol Model Context Protocol (MCP) omogoča tvojemu glasovnemu agentu povezavo z zunanjimi strežniki orodij prek standardiziranega protokola. Ko v seji konfiguriraš orodje MCP, API glasovnega agenta za vsak korak interakcije s strežnikom MCP oddaja specifične dogodke.

Konfiguracija orodja MCP

Če želiš v glasovni seji omogočiti strežnik MCP, ga dodaj na seznam orodij:

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

Polje server_url kaže na tvoj strežnik MCP, server_label pa je berljivo ime, ki strežnik identificira v dnevnikih.

Odkrivanje orodij

Ko se agent poveže s strežnikom MCP, najprej pridobi seznam razpoložljivih orodij. To fazo označujejo trije dogodki.

mcp_list_tools.in_progress

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

Strežnik MCP se poizveduje za seznam svojih orodij.

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 orodij je bil uspešno pridobljen. Glasovni agent jih lahko zdaj uporabi v pogovoru.

mcp_list_tools.failed

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

Povezava s strežnikom MCP ni uspela. Agent bo nadaljeval pogovor brez teh orodij.

Klici orodij MCP

Ko se agent med pogovorom odloči uporabiti orodje MCP, se oddajo dodatni dogodki.

response.mcp_call_arguments.delta / .done

Tako kot običajni dogodki klicanja funkcij tudi ti pretakajo argumente klica:

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

Ti dogodki sledijo izvajanju klica na strežniku 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"
  }
}

Razlike glede na običajno klicanje funkcij

Orodja MCP delujejo na strani strežnika prek infrastrukture xAI, zato ti ni treba samostojno upravljati izvajanja. To je glavna razlika glede na običajno klicanje funkcij, kjer mora tvoja aplikacija izvesti funkcijo in poslati rezultat nazaj.

VidikKlicanje funkcijMCP
IzvajanjeTvoja aplikacijaOddaljeni strežnik MCP
RezultatPošlješ ga nazajSamodejno
ZakasnitevOdvisna od tvoje kodeOdvisna od strežnika MCP
KonfiguracijaLokalna shema JSONURL strežnika MCP

Obravnava dogodkov MCP v tvoji aplikaciji

Tukaj je primer celovitega obravnavalca dogodkov 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;
  }
});

Ključne ugotovitve

  • Orodja MCP omogočajo glasovnemu agentu delo z zunanjimi strežniki prek standardiziranega protokola.
  • Odkrivanje orodij poteka samodejno prek dogodkov mcp_list_tools.
  • Klici MCP se izvajajo na strani strežnika, za razliko od običajnega klicanja funkcij.
  • Vsak klic preide skozi tri možna stanja: in_progress, nato completed ali failed.
  • Napake pri povezavi MCP obravnavaj ustrezno: agent lahko nadaljuje brez teh orodij.