Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

MCP-tapahtumat äänikeskusteluissa

Oppitunti 12 / 16 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. MCP ääniagentissa
  2. MCP-työkalun määrittäminen
  3. Työkalujen etsintä
  4. MCP-työkalukutsut
  5. Miten tämä eroaa tavallisesta funktiokutsusta
  6. MCP-tapahtumien käsittely sovelluksessasi
  7. Keskeiset asiat

MCP ääniagentissa

Model Context Protocol (MCP) mahdollistaa ääniagenttisi yhdistämisen ulkoisiin työkalupalvelimiin standardoidun protokollan kautta. Kun määrität MCP-työkalun istuntoosi, Voice Agent API lähettää erityisiä tapahtumia jokaiselle MCP-palvelimen kanssa käydyn vuorovaikutuksen vaiheelle.

MCP-työkalun määrittäminen

Ottaaksesi MCP-palvelimen käyttöön ääni-istunnossasi, lisää se työkalujen luetteloon:

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

Kenttä server_url osoittaa MCP-palvelimesi sijaintiin, ja server_label on luettava nimi, joka tunnistaa palvelimen lokeissa.

Työkalujen etsintä

Kun agentti muodostaa yhteyden MCP-palvelimeen, se hakee ensin saatavilla olevien työkalujen luettelon. Kolme tapahtumaa merkitsee tätä vaihetta.

mcp_list_tools.in_progress

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

MCP-palvelimelta haetaan sen työkalujen luetteloa.

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

Työkalujen luettelo haettiin onnistuneesti. Ääniagentti voi nyt käyttää niitä keskustelussa.

mcp_list_tools.failed

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

Yhteys MCP-palvelimeen epäonnistui. Agentti jatkaa keskustelua ilman kyseisiä työkaluja.

MCP-työkalukutsut

Kun agentti päättää käyttää MCP-työkalua keskustelun aikana, lisää tapahtumia lähetetään.

response.mcp_call_arguments.delta / .done

Kuten tavallisissa funktiokutsutapahtumissa, nämä suoratoistavat kutsun argumentit:

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

Nämä tapahtumat seuraavat kutsun suorittamista MCP-palvelimella:

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

Miten tämä eroaa tavallisesta funktiokutsusta

MCP-työkalut suoritetaan palvelinpuolella xAI:n infrastruktuurin kautta, joten sinun ei tarvitse huolehtia suorittamisesta itse. Tämä on tärkein ero tavalliseen funktiokutsuun, jossa sovelluksesi täytyy suorittaa funktio ja lähettää tulos takaisin.

NäkökohtaFunktiokutsuMCP
SuoritusSovelluksesiEtä-MCP-palvelin
TulosLähetät sen takaisinAutomaattinen
ViiveRiippuu koodistasiRiippuu MCP-palvelimesta
MäärittelyPaikallinen JSON-skeemaMCP-palvelimen URL-osoite

MCP-tapahtumien käsittely sovelluksessasi

Tässä on esimerkki täydellisestä käsittelijästä MCP-tapahtumille:

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

Keskeiset asiat

  • MCP-työkalut mahdollistavat ääniagentin työskentelyn ulkoisten palvelimien kanssa standardoidun protokollan kautta
  • Työkalujen etsintä tapahtuu automaattisesti mcp_list_tools -tapahtumien kautta
  • MCP-kutsut suoritetaan palvelinpuolella, toisin kuin tavallisessa funktiokutsussa
  • Jokainen kutsu käy läpi kolme mahdollista tilaa: in_progress, jonka jälkeen joko completed tai failed
  • Käsittele MCP-yhteysvirheet hallitusti: agentti pystyy jatkamaan toimintaa ilman työkaluja