Salt la conținutul principal
Română— Alege o limbă
Meniu

Evenimente MCP în conversațiile vocale

Lecția 12 din 16 Actualizată 30 iulie 2026 Dezvoltator
Pe această pagină
  1. MCP în Agentul Vocal
  2. Configurarea unui instrument MCP
  3. Descoperirea instrumentelor
  4. Apeluri de instrumente MCP
  5. Diferențele față de apelarea obișnuită a funcțiilor
  6. Gestionarea evenimentelor MCP în aplicația dumneavoastră
  7. Puncte cheie

MCP în Agentul Vocal

Protocolul Model Context (MCP) permite agentului vocal să se conecteze la servere de instrumente externe printr-un protocol standardizat. Atunci când configurați un instrument MCP în sesiunea dumneavoastră, API-ul Voice Agent emite evenimente specifice pentru fiecare etapă a interacțiunii cu serverul MCP.

Configurarea unui instrument MCP

Pentru a activa un server MCP în sesiunea vocală, adăugați-l la lista de instrumente:

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

Câmpul server_url indică serverul MCP, iar server_label este un nume lizibil care identifică serverul în jurnale.

Descoperirea instrumentelor

Atunci când agentul se conectează la serverul MCP, acesta preia mai întâi lista instrumentelor disponibile. Trei evenimente marchează această fază.

mcp_list_tools.in_progress

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

Serverul MCP este interogat pentru lista sa de instrumente.

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

Lista de instrumente a fost preluată cu succes. Agentul vocal le poate utiliza acum în conversație.

mcp_list_tools.failed

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

Conexiunea la serverul MCP a eșuat. Agentul va continua conversația fără aceste instrumente.

Apeluri de instrumente MCP

Atunci când agentul decide să utilizeze un instrument MCP în timpul conversației, sunt emise mai multe evenimente.

response.mcp_call_arguments.delta / .done

La fel ca evenimentele obișnuite de apelare a funcțiilor, acestea transmit în flux argumentele apelului:

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

Aceste evenimente urmăresc execuția apelului pe serverul 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"
  }
}

Diferențele față de apelarea obișnuită a funcțiilor

Instrumentele MCP rulează pe partea de server, prin infrastructura xAI, astfel încât nu trebuie să gestionați execuția dumneavoastră. Aceasta este principala diferență față de apelarea obișnuită a funcțiilor, unde aplicația dumneavoastră trebuie să execute funcția și să trimită înapoi rezultatul.

AspectApelare funcțiiMCP
ExecuțieAplicația dumneavoastrăServer MCP la distanță
RezultatÎl trimiteți dumneavoastrăAutomat
LatențăDepinde de codul dumneavoastrăDepinde de serverul MCP
ConfigurareSchemă JSON localăURL server MCP

Gestionarea evenimentelor MCP în aplicația dumneavoastră

Iată un exemplu de gestionar complet pentru evenimentele 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;
  }
});

Puncte cheie

  • Instrumentele MCP permit agentului vocal să lucreze cu servere externe printr-un protocol standardizat
  • Descoperirea instrumentelor are loc automat prin evenimentele mcp_list_tools
  • Apelurile MCP rulează pe partea de server, spre deosebire de apelarea obișnuită a funcțiilor
  • Fiecare apel parcurge trei stări posibile: in_progress, apoi completed sau failed
  • Gestionați cu grijă erorile de conexiune MCP: agentul poate continua fără aceste instrumente