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.
Ö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:
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
Konfiguration
Innan du övervakar konversationer ska du aktivera funktionen i agentens inställningar:
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 samtal
Avsluta den aktiva konversationen omedelbart.
Överför till telefonnummer
Överför samtalet till ett angivet telefonnummer.
transfer_to_number måste redan vara konfigurerat i agenten.Kontextuppdatering i realtid
Lägg till kontext eller instruktioner i den aktiva konversationen så att agenten kan använda den nya informationen i sina svar.
Aktivera mänskligt övertagande
Växla från AI-agent till mänskligt operatörsläge för chattkonversationer.
Skicka meddelande som människa
Skicka ett meddelande till användaren som en mänsklig operatör i chattkonversationer.
Inaktivera mänskligt övertagande
Återlämna kontrollen från den mänskliga operatören till AI-agenten.
Användningsområden
Realtidsövervakning möjliggör flera operativa scenarier:
Begränsningar
Asynkron händelseleverans
Ö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.
Ljuddata är inte tillgängliga
Övervakningsslutpunkten strömmar endast texthändelser och metadata. Rå ljuddata inkluderas inte i övervakningshändelser.
Gräns för historiska hä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.
Begränsningar för händelsefiltrering
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.
Tidpunkt för anslutning
Du måste ansluta efter att konversationen har startat. Övervakningsslutpunkten kan inte användas innan konversationen har inletts.
Behörigheter krävs
API-nycklar måste ha omfattningen ElevenLabs Agents Write, och du måste ha EDITOR-åtkomst till workspace
för att övervaka konversationer.
