Spring til hovedindhold
Dansk— Vælg et sprog
Menu

MCP-begivenheder i talesamtaler

Lektion 12 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. MCP i Voice Agent
  2. Konfigurér et MCP-værktøj
  3. Opdagelse af værktøjer
  4. MCP-værktøjskald
  5. Hvordan det adskiller sig fra almindeligt funktionskald
  6. Håndtér MCP-begivenheder i din app
  7. Vigtige pointer

MCP i Voice Agent

Model Context Protocol (MCP) giver din taleagent mulighed for at forbinde til eksterne værktøjsservere via en standardiseret protokol. Når du konfigurerer et MCP-værktøj i din session, udsender Voice Agent API specifikke begivenheder for hvert trin i interaktionen med MCP-serveren.

Konfigurér et MCP-værktøj

For at aktivere en MCP-server i din talesession skal du tilføje den til listen over værktøjer:

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

Feltet server_url peger på din MCP-server, og server_label er et læsbart navn, der identificerer serveren i logfilerne.

Opdagelse af værktøjer

Når agenten forbinder til MCP-serveren, henter den først listen over tilgængelige værktøjer. Tre begivenheder markerer denne fase.

mcp_list_tools.in_progress

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

MCP-serveren bliver forespurgt om sin liste over værktøjer.

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

Listen over værktøjer blev hentet succesfuldt. Taleagenten kan nu bruge dem i samtalen.

mcp_list_tools.failed

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

Forbindelsen til MCP-serveren mislykkedes. Agenten fortsætter samtalen uden disse værktøjer.

MCP-værktøjskald

Når agenten beslutter at bruge et MCP-værktøj under samtalen, udsendes flere begivenheder.

response.mcp_call_arguments.delta / .done

Ligesom de almindelige begivenheder for funktionskald streamer disse kaldets argumenter:

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

Disse begivenheder sporer udførelsen af kaldet på MCP-serveren:

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

Hvordan det adskiller sig fra almindeligt funktionskald

MCP-værktøjer kører på serversiden gennem xAIs infrastruktur, så du behøver ikke håndtere udførelsen selv. Det er den væsentligste forskel fra almindeligt funktionskald, hvor din app skal køre funktionen og sende resultatet tilbage.

AspektFunktionskaldMCP
UdførelseDin appFjern-MCP-server
ResultatDu sender det tilbageAutomatisk
LatensAfhænger af din kodeAfhænger af MCP-serveren
KonfigurationLokalt JSON-skemaMCP-server-URL

Håndtér MCP-begivenheder i din app

Her er et eksempel på en komplet håndterer til MCP-begivenheder:

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

Vigtige pointer

  • MCP-værktøjer lader taleagenten arbejde med eksterne servere via en standardiseret protokol
  • Opdagelse af værktøjer sker automatisk gennem mcp_list_tools-begivenhederne
  • MCP-kald kører på serversiden, i modsætning til almindeligt funktionskald
  • Hvert kald gennemgår tre mulige tilstande: in_progress, derefter completed eller failed
  • Håndtér MCP-forbindelsesfejl elegant: agenten kan fortsætte uden værktøjerne