Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

MCP įvykiai balso pokalbiuose

Paskaita 12 iš 16 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. MCP balso agente
  2. MCP įrankio konfigūravimas
  3. Įrankių atradimas
  4. MCP įrankių kvietimai
  5. Kuo tai skiriasi nuo įprasto funkcijų kvietimo
  6. MCP įvykių valdymas tavo programėlėje
  7. Svarbiausi punktai

MCP balso agente

Modelio konteksto protokolas (MCP) leidžia tavo balso agentui jungtis prie išorinių įrankių serverių naudojant standartizuotą protokolą. Kai sesijoje sukonfigūruoji MCP įrankį, balso agento API generuoja specifinius įvykius kiekvienam sąveikos su MCP serveriu etapui.

MCP įrankio konfigūravimas

Norėdamas įgalinti MCP serverį savo balso sesijoje, pridėk jį prie įrankių sąrašo:

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

Laukas server_url nurodo tavo MCP serverį, o server_label yra skaitomas pavadinimas, identifikuojantis serverį žurnaluose.

Įrankių atradimas

Kai agentas prisijungia prie MCP serverio, jis pirmiausia gauna galimų įrankių sąrašą. Šį etapą žymi trys įvykiai.

mcp_list_tools.in_progress

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

MCP serveris yra užklausiamas dėl savo įrankių sąrašo.

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

Įrankių sąrašas sėkmingai gautas. Dabar balso agentas gali juos naudoti pokalbyje.

mcp_list_tools.failed

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

Ryšys su MCP serveriu nepavyko. Agentas tęs pokalbį be šių įrankių.

MCP įrankių kvietimai

Kai agentas pokalbio metu nusprendžia naudoti MCP įrankį, generuojami papildomi įvykiai.

response.mcp_call_arguments.delta / .done

Kaip ir įprastų funkcijų kvietimo įvykių atveju, šie įvykiai perduoda kvietimo argumentus srautu:

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

Šie įvykiai stebi kvietimo vykdymą MCP serveryje:

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

Kuo tai skiriasi nuo įprasto funkcijų kvietimo

MCP įrankiai vykdomi serverio pusėje per xAI infrastruktūrą, todėl tau nereikia pačiam valdyti jų vykdymo. Tai pagrindinis skirtumas nuo įprasto funkcijų kvietimo, kai tavo programėlė turi vykdyti funkciją ir grąžinti rezultatą.

AspektasFunkcijų kvietimasMCP
VykdymasTavo programėlėNutolęs MCP serveris
RezultatasSiunčiats jį atgalAutomatinis
VėlavimasPriklauso nuo tavo kodoPriklauso nuo MCP serverio
KonfigūravimasVietinė JSON schemaMCP serverio URL

MCP įvykių valdymas tavo programėlėje

Štai pilnas MCP įvykių tvarkyklės pavyzdys:

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

Svarbiausi punktai

  • MCP įrankiai leidžia balso agentui dirbti su išoriniais serveriais naudodami standartizuotą protokolą
  • Įrankių atradimas vyksta automatiškai per mcp_list_tools įvykius
  • MCP kvietimai vykdomi serverio pusėje, skirtingai nei įprastas funkcijų kvietimas
  • Kiekvienas kvietimas pereina per tris galimas būsenas: in_progress, tada completed arba failed
  • MCP ryšio klaidas tvarkykite tinkamai: agentas gali tęsti darbą be šių įrankių