Hoppa till navigering

Realtidsövervakning

Övervaka aktiva samtal och skicka styrkommandon under pågående samtal

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

Det här är en funktion som endast är tillgänglig 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 livekonversation 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 workspace: Du måste ha EDITOR-åtkomst till agentens workspace
  • Headerformat: Inkludera din API-nyckel via headern xi-api-key

Exempel på anslutning

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

Konfiguration

Innan du övervakar konversationer ska du aktivera funktionen i agentens inställningar:

1

Gå till agentinställningarna

Öppna agentens konfigurationssida i dashboarden.

2

Aktivera övervakning

Aktivera alternativet ”Övervakning” i panelen Avancerade inställningar.

Övervakningsreglage 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.

Som standard skickar övervakningen user_transcript, agent_response och agent_response_correction. Om du vill övervaka verktygsanrop väljer du agent_tool_request och agent_tool_response.

Följande händelser kan inte övervakas: VAD-poäng, mätvärden för tur-sannolikhet 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 börjat.

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 till 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 mänskligt operatörsläge för chattkonversationer.

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

Skicka ett meddelande till användaren som en 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?"
}
}));

Återlämna 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ändningsområden

Realtidsövervakning möjliggör flera operativa scenarier:

Kvalitetssäkring

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

Eskalering till människa

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

Analysdashboards

Bygg dashboards för realtidsövervakning som sammanställer konversationsmått och prestandaindikatorer.

Översikt över callcenter

Övervaka flera agentsamtal samtidigt och ingrip vid behov.

Automatiserat ingripande

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

Utbildning och handledning

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

Begränsningar

Övervakningshändelser skickas asynkront i förhållande till konversationen och kanske inte kommer i samma ordning som de centrala konversationshändelserna. När du bearbetar händelser ska du inte förlita dig på händelseordningen för att återskapa exakt timing i konversationen.

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

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

VAD-poäng, mätvärden för tur-sannolikhet och pinghändelser kan inte övervakas när anpassat urval av händelser ä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 workspace för att övervaka konversationer.

Relaterade resurser