Monitorowanie

Monitorowanie w czasie rzeczywistym

Obserwuj rozmowy na żywo i wysyłaj polecenia sterujące podczas aktywnych połączeń

Monitorowanie w czasie rzeczywistym umożliwia obserwowanie rozmów agentów na żywo przez WebSocket oraz zdalne sterowanie aktywnymi połączeniami. Ta funkcja zapewnia wgląd w zdarzenia rozmowy w czasie rzeczywistym i pozwala interweniować za pomocą poleceń sterujących.

Ta funkcja jest dostępna tylko w planie Enterprise.

Omówienie

Sesje monitorowania przesyłają zdarzenia rozmowy w czasie rzeczywistym, w tym transkrypcje, odpowiedzi agenta i korekty. Możesz też wysyłać polecenia sterujące, by kończyć połączenia, przekazywać je na numery telefonów lub włączać przejęcie przez człowieka podczas aktywnych rozmów na czacie.

Endpoint WebSocket

Połącz się z rozmową na żywo przez endpoint monitorowania:

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

Zastąp {conversation_id} identyfikatorem rozmowy, którą chcesz monitorować.

Uwierzytelnianie

Uwierzytelnianie wymaga:

  • Uprawnienia klucza API: Twój klucz API musi mieć zakres ElevenLabs Agents Write
  • Dostęp do workspace: Musisz mieć dostęp EDITOR do workspace agenta
  • Format nagłówka: Dołącz klucz API w nagłówku xi-api-key

Przykład połączenia

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

Konfiguracja

Przed monitorowaniem rozmów włącz tę funkcję w ustawieniach agenta:

1

Przejdź do ustawień agenta

Otwórz stronę konfiguracji agenta w panelu.

2

Włącz monitorowanie

W panelu ustawień zaawansowanych włącz opcję „Monitoring”.

Przełącznik monitorowania w ustawieniach agenta

3

Wybierz zdarzenia

Wybierz zdarzenia, które chcesz monitorować. Pełną listę dostępnych zdarzeń znajdziesz w sekcji Client Events.

Nie można monitorować następujących zdarzeń: wyników VAD, metryk prawdopodobieństwa tury i pingów.

Rozmowa musi być aktywna, zanim będzie można się z nią połączyć w celu monitorowania. Nie możesz monitorować rozmowy, zanim się rozpocznie.

Polecenia sterujące

Wysyłaj polecenia JSON przez WebSocket, aby sterować rozmową:

Natychmiast zakończ aktywną rozmowę.

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

Przekaż połączenie na wskazany numer telefonu.

// Transfer to a phone number
ws.send(JSON.stringify({
  command_type: "transfer_to_number",
  parameters: {
    phone_number: "+1234567890"
  }
}));
Narzędzie systemowe transfer_to_number musi być już skonfigurowane w agencie.

Dodaj kontekst lub instrukcje do aktywnej rozmowy, aby agent mógł wykorzystać nowe informacje w odpowiedziach.

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

Przełącz z agenta AI na tryb operatora podczas rozmów na czacie.

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

Wyślij użytkownikowi wiadomość jako operator podczas rozmowy na czacie.

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

Przekaż kontrolę z operatora z powrotem agentowi AI.

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

Przypadki użycia

Monitorowanie w czasie rzeczywistym obsługuje kilka scenariuszy operacyjnych:

Kontrola jakości

Monitoruj rozmowy agentów w czasie rzeczywistym, aby zapewnić standardy jakości i wykrywać możliwości szkoleniowe.

Eskalacja do człowieka

Wykrywaj rozmowy wymagające interwencji człowieka i płynnie przejmuj je od agenta AI.

Panele analityczne

Twórz panele monitorowania w czasie rzeczywistym, które agregują metryki rozmów i wskaźniki wydajności.

Nadzór nad call center

Nadzoruj jednocześnie wiele rozmów agentów i interweniuj, gdy to konieczne.

Automatyczna interwencja

Wdrażaj automatyczne systemy, które analizują treść rozmów i wywołują działania na podstawie określonych warunków.

Szkolenia i coaching

Wykorzystuj rozmowy na żywo jako materiał szkoleniowy i przekazuj informacje zwrotne w czasie rzeczywistym, by poprawiać działanie agentów.

Ograniczenia

Zdarzenia monitorowania są wysyłane asynchronicznie względem rozmowy i mogą nie docierać w tej samej kolejności co główne zdarzenia rozmowy. Podczas przetwarzania zdarzeń nie polegaj na ich kolejności, aby odtworzyć dokładny czas rozmowy.

Endpoint monitorowania przesyła wyłącznie zdarzenia tekstowe i metadane. Surowe dane audio nie są uwzględniane w zdarzeniach monitorowania.

Podczas łączenia z aktywną rozmową dostępnych jest tylko około 100 ostatnich zdarzeń zapisanych w pamięci podręcznej. Wcześniejszych zdarzeń nie można pobrać.

Wyników VAD, metryk prawdopodobieństwa tury i zdarzeń ping nie można monitorować, gdy włączony jest niestandardowy wybór zdarzeń.

Musisz połączyć się po rozpoczęciu rozmowy. Endpointu monitorowania nie można użyć przed rozpoczęciem rozmowy.

Klucze API muszą mieć zakres ElevenLabs Agents Write, a ty musisz mieć dostęp EDITOR do workspace, aby monitorować rozmowy.

Powiązane materiały

Webhooki po rozmowie

Otrzymuj dane i analizę rozmowy po zakończeniu połączeń.

Analiza agenta

Skonfiguruj ocenę sukcesu i zbieranie danych dla rozmów.

Zdarzenia klienta

Poznaj zdarzenia otrzymywane w aplikacjach konwersacyjnych.

WebSocket API

Dowiedz się więcej o WebSocket API do rozmów w czasie rzeczywistym.