Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

MCP-händelser i röstsamtal

Lektion 12 av 16 Uppdaterad 30 juli 2026 Utvecklare
På denna sida
  1. MCP i Voice Agent
  2. Konfigurera ett MCP-verktyg
  3. Verktygsupptäckt
  4. MCP-verktygsanrop
  5. Hur det skiljer sig från vanliga funktionsanrop
  6. Hantera MCP-händelser i din app
  7. Viktiga punkter

MCP i Voice Agent

Model Context Protocol (MCP) låter din röstagent ansluta till externa verktygsservrar via ett standardiserat protokoll. När du konfigurerar ett MCP-verktyg i din session emitterar Voice Agent API specifika händelser för varje steg i interaktionen med MCP-servern.

Konfigurera ett MCP-verktyg

För att aktivera en MCP-server i din röstsession lägger du till den i listan över verktyg:

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

Fältet server_url pekar på din MCP-server och server_label är ett läsbart namn som identifierar servern i loggarna.

Verktygsupptäckt

När agenten ansluter till MCP-servern hämtar den först listan över tillgängliga verktyg. Tre händelser markerar denna fas.

mcp_list_tools.in_progress

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

MCP-servern frågas efter sin lista över verktyg.

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

Listan över verktyg har hämtats framgångsrikt. Röstagenten kan nu använda dem i samtalet.

mcp_list_tools.failed

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

Anslutningen till MCP-servern misslyckades. Agenten fortsätter samtalet utan dessa verktyg.

MCP-verktygsanrop

När agenten bestämmer sig för att använda ett MCP-verktyg under samtalet emitteras fler händelser.

response.mcp_call_arguments.delta / .done

Precis som vanliga händelser för funktionsanrop strömmar dessa anropets argument:

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

Dessa händelser spårar körningen av anropet på MCP-servern:

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

Hur det skiljer sig från vanliga funktionsanrop

MCP-verktyg körs på serversidan via xAIs infrastruktur, så du behöver inte hantera körningen själv. Det är den största skillnaden jämfört med vanliga funktionsanrop, där din app måste köra funktionen och skicka tillbaka resultatet.

AspektFunktionsanropMCP
KörningDin appFjärr-MCP-server
ResultatDu skickar tillbaka detAutomatiskt
LatensBeror på din kodBeror på MCP-servern
KonfigurationLokalt JSON-schemaMCP-server-URL

Hantera MCP-händelser i din app

Här är ett exempel på en komplett hanterare för MCP-händelser:

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

Viktiga punkter

  • MCP-verktyg låter röstagenten arbeta med externa servrar via ett standardiserat protokoll
  • Verktygsupptäckt sker automatiskt genom händelserna mcp_list_tools
  • MCP-anrop körs på serversidan, till skillnad från vanliga funktionsanrop
  • Varje anrop går igenom tre möjliga tillstånd: in_progress, följt av completed eller failed
  • Hantera MCP-anslutningsfel på ett robust sätt: agenten kan fortsätta utan verktygen