Echtzeitüberwachung | ElevenLabs Documentation

Die Echtzeitüberwachung ermöglicht die Live-Beobachtung von Agentenunterhaltungen über WebSocket sowie die Fernsteuerung aktiver Anrufe. Diese Funktion bietet Echtzeit-Einblick in Unterhaltungsereignisse und ermöglicht Eingriffe über Steuerbefehle.

Diese Funktion ist nur für Enterprise verfügbar.

Überblick

Überwachungssitzungen streamen Unterhaltungsereignisse in Echtzeit, einschließlich Transkripten, Agentenantworten und Korrekturen. Sie können auch Steuerbefehle senden, um Anrufe zu beenden, an Telefonnummern weiterzuleiten oder während aktiver Chatunterhaltungen die menschliche Übernahme zu aktivieren.

WebSocket-Endpunkt

Verbinden Sie sich über den Überwachungsendpunkt mit einer Live-Unterhaltung:

wss://api.elevenlabs.io/v1/convai/conversations/{conversation_id}/monitor

Ersetzen Sie {conversation_id} durch die ID der Unterhaltung, die Sie überwachen möchten.

Authentifizierung

Für die Authentifizierung ist Folgendes erforderlich:

API-Schlüsselberechtigungen: Ihr API-Schlüssel muss den Bereich ElevenLabs Agents Write haben
Workspace-Zugriff: Sie benötigen EDITOR-Zugriff auf den Workspace des Agenten
Header-Format: Übermitteln Sie Ihren API-Schlüssel über den Header xi-api-key

Beispielverbindung

const ws = new WebSocket('wss://api.elevenlabs.io/v1/convai/conversations/conv_123/monitor', {
  headers: {
    'xi-api-key': 'your_api_key_here',
  },
});

Konfiguration

Aktivieren Sie die Funktion in den Einstellungen Ihres Agenten, bevor Sie Unterhaltungen überwachen:

Zu den Agenteneinstellungen wechseln

Öffnen Sie die Konfigurationsseite Ihres Agenten im Dashboard.

Überwachung aktivieren

Aktivieren Sie im Bereich „Erweiterte Einstellungen“ die Option „Überwachung“.

Umschalter für die Überwachung in den Agenteneinstellungen

Ereignisse auswählen

Wählen Sie die Ereignisse aus, die Sie überwachen möchten. Eine vollständige Liste der verfügbaren Ereignisse finden Sie unter Client-Ereignisse.

Die folgenden Ereignisse können nicht überwacht werden: VAD-Scores, Metriken für die Zugwahrscheinlichkeit und Pings.

Die Unterhaltung muss aktiv sein, bevor Sie sich zur Überwachung verbinden können. Sie können eine Unterhaltung nicht überwachen, bevor sie beginnt.

Steuerbefehle

Senden Sie JSON-Befehle über WebSocket, um die Unterhaltung zu steuern:

Anruf beenden

Beendet die aktive Unterhaltung sofort.

// End the active conversation
ws.send(JSON.stringify({
  command_type: "end_call"
}));

An Telefonnummer weiterleiten

Leitet den Anruf an eine angegebene Telefonnummer weiter.

// Transfer to a phone number
ws.send(JSON.stringify({
  command_type: "transfer_to_number",
  parameters: {
    phone_number: "+1234567890"
  }
}));

Das Systemtool transfer_to_number muss bereits im Agenten konfiguriert sein.

Kontextaktualisierung in Echtzeit

Fügen Sie der aktiven Unterhaltung Kontext oder Anweisungen hinzu, damit der Agent die neuen Informationen in seinen Antworten verwenden kann.

// Send a contextual update to the agent
ws.send(JSON.stringify({
  command_type: "contextual_update",
  parameters: {
    contextual_update: "<your update text>"
  }
}));

Menschliche Übernahme aktivieren

Wechseln Sie bei Chatunterhaltungen vom KI-Agenten in den Modus für menschliche Operatoren.

// Enable human takeover
ws.send(JSON.stringify({
  command_type: "enable_human_takeover"
}));

Nachricht als Mensch senden

Senden Sie dem Nutzer in Chatunterhaltungen eine Nachricht als menschlicher Operator.

// Send a message as a human operator
ws.send(JSON.stringify({
  command_type: "send_human_message",
  parameters: {
    text: "How can I help you?"
  }
}));

Menschliche Übernahme deaktivieren

Geben Sie die Steuerung vom menschlichen Operator an den KI-Agenten zurück.

// Disable human takeover and return to AI
ws.send(JSON.stringify({
  command_type: "disable_human_takeover"
}));

Anwendungsfälle

Die Echtzeitüberwachung ermöglicht mehrere operative Szenarien:

Qualitätssicherung

Überwachen Sie Agentenunterhaltungen in Echtzeit, um Qualitätsstandards sicherzustellen und Schulungsmöglichkeiten zu erkennen.

Eskalation an Menschen

Erkennen Sie Unterhaltungen, die menschliche Intervention erfordern, und übernehmen Sie nahtlos vom KI-Agenten.

Analyse-Dashboards

Erstellen Sie Dashboards zur Echtzeitüberwachung, die Unterhaltungsmetriken und Leistungsindikatoren zusammenführen.

Callcenter-Aufsicht

Beaufsichtigen Sie mehrere Agentenunterhaltungen gleichzeitig und greifen Sie bei Bedarf ein.

Automatisierte Intervention

Implementieren Sie automatisierte Systeme, die Gesprächsinhalte analysieren und Aktionen auf Basis bestimmter Bedingungen auslösen.

Training und Coaching

Nutzen Sie Live-Unterhaltungen als Schulungsmaterial und geben Sie Echtzeit-Feedback, um die Leistung des Agenten zu verbessern.

Einschränkungen

Asynchrone Ereignisübermittlung

Überwachungsereignisse werden asynchron zur Unterhaltung gesendet und treffen möglicherweise nicht in derselben Reihenfolge wie die Kernereignisse der Unterhaltung ein. Verlassen Sie sich bei der Verarbeitung von Ereignissen nicht auf deren Reihenfolge, um das exakte Timing der Unterhaltung zu rekonstruieren.

Audiodaten nicht verfügbar

Der Überwachungsendpunkt streamt nur Textereignisse und Metadaten. Rohdaten von Audio sind in Überwachungsereignissen nicht enthalten.

Limit für historische Ereignisse

Beim Verbinden mit einer aktiven Unterhaltung sind nur ungefähr die letzten 100 Ereignisse im Cache gespeichert und verfügbar. Frühere Ereignisse können nicht abgerufen werden.

Einschränkungen bei der Ereignisfilterung

VAD-Scores, Metriken für die Zugwahrscheinlichkeit und Ping-Ereignisse können nicht überwacht werden, wenn eine benutzerdefinierte Ereignisauswahl aktiviert ist.

Zeitpunkt der Verbindung

Sie müssen sich verbinden, nachdem die Unterhaltung gestartet wurde. Der Überwachungsendpunkt kann nicht vor Beginn der Unterhaltung verwendet werden.

Erforderliche Berechtigungen

API-Schlüssel müssen den Bereich ElevenLabs Agents Write haben, und Sie benötigen EDITOR-Workspace-Zugriff, um Unterhaltungen zu überwachen.