Zdarzenia MCP w rozmowach głosowych
Na tej stronie
MCP w Voice Agent
Model Context Protocol (MCP) pozwala Twojemu agentowi głosowemu łączyć się z zewnętrznymi serwerami narzędzi za pomocą standaryzowanego protokołu. Gdy skonfigurujesz narzędzie MCP w swojej sesji, Voice Agent API emituje określone zdarzenia dla każdego etapu interakcji z serwerem MCP.
Konfiguracja narzędzia MCP
Aby włączyć serwer MCP w sesji głosowej, dodaj go do listy narzędzi:
{
"type": "session.update",
"session": {
"tools": [
{
"type": "mcp",
"server_url": "https://mon-serveur-mcp.exemple.com/sse",
"server_label": "Internal CRM"
}
]
}
}
Pole server_url wskazuje Twój serwer MCP, a server_label to czytelna nazwa identyfikująca serwer w logach.
Wykrywanie narzędzi
Gdy agent łączy się z serwerem MCP, najpierw pobiera listę dostępnych narzędzi. Trzy zdarzenia oznaczają tę fazę.
mcp_list_tools.in_progress
{
"type": "mcp_list_tools.in_progress",
"server_label": "Internal CRM"
}
Serwer MCP jest odpytywany o listę swoich narzędzi.
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 narzędzi została pomyślnie pobrana. Agent głosowy może teraz używać ich w rozmowie.
mcp_list_tools.failed
{
"type": "mcp_list_tools.failed",
"server_label": "Internal CRM",
"error": {
"message": "Connection timeout"
}
}
Połączenie z serwerem MCP nie powiodło się. Agent będzie kontynuował rozmowę bez tych narzędzi.
Wywołania narzędzi MCP
Gdy agent zdecyduje się użyć narzędzia MCP podczas rozmowy, emitowanych jest więcej zdarzeń.
response.mcp_call_arguments.delta / .done
Podobnie jak w przypadku zwykłych zdarzeń wywoływania funkcji, zdarzenia te strumieniują argumenty wywołania:
{
"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
Zdarzenia te śledzą wykonanie wywołania na serwerze 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"
}
}
Różnice względem zwykłego wywoływania funkcji
Narzędzia MCP działają po stronie serwera, poprzez infrastrukturę xAI, więc nie musisz samodzielnie obsługiwać ich wykonania. To główna różnica w porównaniu ze zwykłym wywoływaniem funkcji, gdzie Twoja aplikacja musi uruchomić funkcję i odesłać wynik.
| Aspekt | Wywoływanie funkcji | MCP |
|---|---|---|
| Wykonanie | Twoja aplikacja | Zdalny serwer MCP |
| Wynik | Wysyłasz go z powrotem | Automatyczny |
| Opóźnienie | Zależy od Twojego kodu | Zależy od serwera MCP |
| Konfiguracja | Lokalny schemat JSON | Adres URL serwera MCP |
Obsługa zdarzeń MCP w aplikacji
Oto przykład kompletnego handlera dla zdarzeń 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;
}
});
Kluczowe wnioski
- Narzędzia MCP pozwalają agentowi głosowemu współpracować z zewnętrznymi serwerami poprzez standaryzowany protokół
- Wykrywanie narzędzi odbywa się automatycznie poprzez zdarzenia
mcp_list_tools - Wywołania MCP działają po stronie serwera, w przeciwieństwie do zwykłego wywoływania funkcji
- Każde wywołanie przechodzi przez trzy możliwe stany:
in_progress, a następniecompletedlubfailed - Obsługuj błędy połączenia MCP w sposób bezpieczny: agent może kontynuować działanie bez tych narzędzi