Événements MCP dans les conversations vocales
In questa pagina
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.
| Aspect | Appel de fonction | MCP |
|---|---|---|
| Exécution | Ton application | Serveur MCP distant |
| Résultat | Tu le renvoies | Automatique |
| Latence | Dépend de ton code | Dépend du serveur MCP |
| Configuration | Schéma JSON local | URL 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, puiscompletedoufailed - Gère les échecs de connexion MCP avec souplesse : l’agent peut continuer sans les outils