Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Événements MCP dans les conversations vocales

Lezione 12 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. MCP dans l’agent vocal
  2. Configurer un outil MCP
  3. Découverte des outils
  4. Appels d’outils MCP
  5. Différences avec l’appel de fonction classique
  6. Gérer les événements MCP dans ton application
  7. Punti chiave

MCP dans l’agent vocal

Le protocole de contexte de modèle (MCP) permet à ton agent vocal de se connecter à des serveurs d’outils externes via un protocole standardisé. Lorsque tu configures un outil MCP dans ta session, l’API de l’agent vocal émet des événements spécifiques pour chaque étape de l’interaction avec le serveur MCP.

Configurer un outil MCP

Pour activer un serveur MCP dans ta session vocale, ajoute-le à la liste des outils :

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

Le champ server_url pointe vers ton serveur MCP, et server_label est un nom lisible qui identifie le serveur dans les journaux.

Découverte des outils

Lorsque l’agent se connecte au serveur MCP, il récupère d’abord la liste des outils disponibles. Trois événements marquent cette phase.

mcp_list_tools.in_progress

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

Le serveur MCP est interrogé pour obtenir sa liste d’outils.

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

La liste des outils a été récupérée avec succès. L’agent vocal peut désormais les utiliser dans la conversation.

mcp_list_tools.failed

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

La connexion au serveur MCP a échoué. L’agent poursuivra la conversation sans ces outils.

Appels d’outils MCP

Lorsque l’agent décide d’utiliser un outil MCP pendant la conversation, d’autres événements sont émis.

response.mcp_call_arguments.delta / .done

Comme pour les événements d’appel de fonction classiques, ceux-ci diffusent les arguments de l’appel en flux continu :

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

Ces événements suivent l’exécution de l’appel sur le serveur 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"
  }
}

Différences avec l’appel de fonction classique

Les outils MCP s’exécutent côté serveur, via l’infrastructure de xAI, tu n’as donc pas à gérer l’exécution toi-même. C’est la principale différence avec l’appel de fonction classique, où ton application doit exécuter la fonction et renvoyer le résultat.

AspectAppel de fonctionMCP
ExécutionTon applicationServeur MCP distant
RésultatTu le renvoiesAutomatique
LatenceDépend de ton codeDépend du serveur MCP
ConfigurationSchéma JSON localURL du serveur MCP

Gérer les événements MCP dans ton application

Voici un exemple de gestionnaire complet pour les événements 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;
  }
});

Punti chiave

  • Les outils MCP permettent à l’agent vocal de travailler avec des serveurs externes via un protocole standardisé
  • La découverte des outils se fait automatiquement grâce aux événements mcp_list_tools
  • Les appels MCP s’exécutent côté serveur, contrairement à l’appel de fonction classique
  • Chaque appel passe par trois états possibles : in_progress, puis completed ou failed
  • Gère les échecs de connexion MCP avec souplesse : l’agent peut continuer sans les outils