Μετάβαση στο κύριο περιεχόμενο
Ελληνικά— Επιλέξτε γλώσσα
Μενού

Συμβάντα MCP σε συνομιλίες φωνής

Μάθημα 12 / 16 Ενημερώθηκε 30 Ιουλίου 2026 Για developers
Σε αυτήν τη σελίδα
  1. Το πρωτόκολλο MCP στον Πράκτορα Φωνής
  2. Διαμόρφωση ενός εργαλείου MCP
  3. Ανακάλυψη εργαλείων
  4. Κλήσεις εργαλείων MCP
  5. Πώς διαφέρει από την κανονική κλήση συναρτήσεων
  6. Διαχείριση συμβάντων MCP στην εφαρμογή σας
  7. Βασικά σημεία

Το πρωτόκολλο 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
ΔιαμόρφωσηΤοπικό σχήμα JSONURL διακομιστή 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 με σωστό τρόπο: ο πράκτορας μπορεί να συνεχίσει χωρίς τα εργαλεία