Hoppa till navigering
Övervaka

Övervakning i realtid

Övervaka direktsända samtal och skicka styrkommandon under aktiva samtal

Övervakning i realtid möjliggör direktsänd övervakning av agentsamtal via WebSocket och fjärrstyrning av aktiva samtal. Funktionen ger insyn i konversationshändelser i realtid och gör det möjligt att ingripa med styrkommandon.

Det här är en funktion endast för Enterprise.

Översikt

Övervakningssessioner strömmar konversationshändelser i realtid, inklusive transkriptioner, agentsvar och korrigeringar. Du kan också skicka styrkommandon för att avsluta samtal, överföra dem till telefonnummer eller aktivera mänskligt övertagande under aktiva chattkonversationer.

WebSocket-slutpunkt

Anslut till en direktsänd konversation med övervakningsslutpunkten:

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

Ersätt {conversation_id} med ID:t för konversationen du vill övervaka.

Autentisering

Autentisering kräver:

  • API-nyckelbehörigheter: Din API-nyckel måste ha omfattningen ElevenLabs Agents Write
  • Åtkomst till arbetsytan: Du måste ha EDITOR-åtkomst till agentens arbetsyta
  • Headerformat: Inkludera din API-nyckel via headern xi-api-key

Exempelanslutning

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

Konfiguration

Aktivera funktionen i agentens inställningar innan du övervakar konversationer:

1

Gå till agentinställningarna

Öppna agentens konfigurationssida i instrumentpanelen.

2

Aktivera övervakning

I panelen Avancerade inställningar aktiverar du alternativet ”Övervakning”.

Växlingsknapp för övervakning i agentinställningarna

3

Välj händelser

Välj vilka händelser du vill övervaka. Se Klienthändelser för en fullständig lista över tillgängliga händelser.

Följande händelser kan inte övervakas: VAD-poäng, turordningssannolikhetsmått och pingar.

Konversationen måste vara aktiv innan du kan ansluta för att övervaka den. Du kan inte övervaka en konversation innan den har startat.

Styrkommandon

Skicka JSON-kommandon via WebSocket för att styra konversationen:

Avsluta den aktiva konversationen omedelbart.

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

Överför samtalet till ett angivet telefonnummer.

// Transfer to a phone number
ws.send(JSON.stringify({
  command_type: "transfer_to_number",
  parameters: {
    phone_number: "+1234567890"
  }
}));
Systemverktyget transfer_to_number måste redan vara konfigurerat i agenten.

Lägg in kontext eller instruktioner i den aktiva konversationen så att agenten kan använda den nya informationen i sina svar.

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

Växla från AI-agent till läget för mänsklig operatör i chattkonversationer.

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

Skicka ett meddelande till användaren som mänsklig operatör i chattkonversationer.

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

Återför kontrollen från den mänskliga operatören till AI-agenten.

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

Användningsfall

Övervakning i realtid möjliggör flera operativa scenarier:

Kvalitetssäkring

Övervaka agentsamtal i realtid för att säkerställa kvalitetsstandarder och identifiera möjligheter till utbildning.

Mänsklig eskalering

Identifiera konversationer som kräver mänsklig hjälp och ta smidigt över från AI-agenten.

Analysinstrumentpaneler

Bygg instrumentpaneler för övervakning i realtid som sammanställer konversationsmått och prestationsindikatorer.

Övervakning av callcenter

Övervaka flera agentsamtal samtidigt och ingrip vid behov.

Automatiskt ingripande

Implementera automatiserade system som analyserar konversationsinnehåll och utlöser åtgärder baserat på specifika villkor.

Utbildning och coachning

Använd direktsända konversationer som utbildningsmaterial och ge återkoppling i realtid för att förbättra agentens prestanda.

Begränsningar

Övervakningshändelser skickas asynkront till konversationen och kanske inte kommer i samma ordning som kärnkonversationens händelser. När du bearbetar händelser ska du inte förlita dig på händelseordningen för att återskapa exakt tidpunkt för konversationen.

Övervakningsslutpunkten strömmar endast texthändelser och metadata. Rå ljuddata ingår inte i övervakningshändelser.

Endast ungefär de senaste 100 händelserna cachas och är tillgängliga när du ansluter till en aktiv konversation. Tidigare händelser kan inte hämtas.

VAD-poäng, turordningssannolikhetsmått och pinghändelser kan inte övervakas när anpassat händelseval är aktiverat.

Du måste ansluta efter att konversationen har startat. Övervakningsslutpunkten kan inte användas innan konversationen har inletts.

API-nycklar måste ha omfattningen ElevenLabs Agents Write, och du måste ha EDITOR-åtkomst till arbetsytan för att övervaka konversationer.

Relaterade resurser

Webhooks efter samtal

Ta emot konversationsdata och analys när samtal avslutas.

Agentanalys

Konfigurera utvärdering av framgång och datainsamling för konversationer.

Klienthändelser

Förstå händelser som tas emot under konversationsapplikationer.

WebSocket API

Lär dig mer om WebSocket API för konversationer i realtid.