Премини към основното съдържание
Български— Изберете език
Меню

Събития на MCP в гласови разговори

Урок 12 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. MCP в гласовия агент
  2. Конфигуриране на MCP инструмент
  3. Откриване на инструменти
  4. Извиквания на MCP инструменти
  5. Разлики спрямо обикновеното извикване на функции
  6. Обработка на MCP събития във Вашето приложение
  7. Ключови изводи

MCP в гласовия агент

Протоколът за контекст на модела (MCP) позволява на Вашия гласов агент да се свързва с външни сървъри за инструменти чрез стандартизиран протокол. Когато конфигурирате MCP инструмент във Вашата сесия, API на гласовия агент излъчва специфични събития за всяка стъпка от взаимодействието със сървъра на MCP.

Конфигуриране на MCP инструмент

За да активирате MCP сървър във Вашата гласова сесия, добавете го към списъка с инструменти:

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

Полето server_url сочи към Вашия MCP сървър, а server_label е четимо име, което идентифицира сървъра в дневниците.

Откриване на инструменти

Когато агентът се свърже със сървъра на MCP, той първо извлича списъка с наличните инструменти. Три събития маркират тази фаза.

mcp_list_tools.in_progress

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

Сървърът на MCP се запитва за неговия списък с инструменти.

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

Списъкът с инструменти е извлечен успешно. Гласовият агент вече може да ги използва в разговора.

mcp_list_tools.failed

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

Връзката със сървъра на MCP е неуспешна. Агентът ще продължи разговора без тези инструменти.

Извиквания на MCP инструменти

Когато агентът реши да използва MCP инструмент по време на разговора, се излъчват допълнителни събития.

response.mcp_call_arguments.delta / .done

Подобно на обикновените събития за извикване на функции, те предават потоково аргументите на извикването:

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

Тези събития проследяват изпълнението на извикването на сървъра на 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"
  }
}

Разлики спрямо обикновеното извикване на функции

MCP инструментите се изпълняват от страната на сървъра, чрез инфраструктурата на xAI, така че не е необходимо сами да обработвате изпълнението. Това е основната разлика спрямо обикновеното извикване на функции, при което Вашето приложение трябва да изпълни функцията и да изпрати резултата обратно.

АспектИзвикване на функцииMCP
ИзпълнениеВашето приложениеОтдалечен MCP сървър
РезултатВие го изпращате обратноАвтоматично
ЛатентностЗависи от Вашия кодЗависи от MCP сървъра
КонфигурацияЛокална JSON схемаURL адрес на MCP сървъра

Обработка на MCP събития във Вашето приложение

Ето пример за пълен обработчик на 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;
  }
});

Ключови изводи

  • MCP инструментите позволяват на гласовия агент да работи с външни сървъри чрез стандартизиран протокол
  • Откриването на инструменти става автоматично чрез събитията mcp_list_tools
  • MCP извикванията се изпълняват от страната на сървъра, за разлика от обикновеното извикване на функции
  • Всяко извикване преминава през три възможни състояния: in_progress, след което completed или failed
  • Обработвайте грешките при връзка с MCP по подходящ начин: агентът може да продължи работа без инструментите