Συμβάντα MCP σε συνομιλίες φωνής
Σε αυτήν τη σελίδα
Το πρωτόκολλο MCP στον Πράκτορα Φωνής
Το Πρωτόκολλο Πλαισίου Μοντέλου (Model Context Protocol - 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 με σωστό τρόπο: ο πράκτορας μπορεί να συνεχίσει χωρίς τα εργαλεία