> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Övervakning i realtid

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

> **Note**
>
> 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

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

```python
import websockets
import asyncio

async def monitor_conversation():
    uri = "wss://api.elevenlabs.io/v1/convai/conversations/conv_123/monitor"
    headers = {
        "xi-api-key": "your_api_key_here"
    }

    async with websockets.connect(uri, extra_headers=headers) as websocket:
        # Connection established
        pass
```

## Konfiguration

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

### Gå till agentinställningarna

Öppna agentens konfigurationssida i instrumentpanelen.

### Aktivera övervakning

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

![Växlingsknapp för övervakning i agentinställningarna](/docs/_fern-img/1a4b5507a39ddf6a517772b8c01ede5f7d12429175fdf89e04c8ba910f646f8e.webp)

### Välj händelser

Välj vilka händelser du vill övervaka. Se [Klienthändelser](/docs/sv/eleven-agents/customization/events/client-events) för en fullständig lista över tillgängliga händelser.

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

> **Info**
>
> 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 samtal

Avsluta den aktiva konversationen omedelbart.

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

```python
import json

# End the active conversation
await websocket.send(json.dumps({
    "command_type": "end_call"
}))
```

#### Överför till telefonnummer

Överför samtalet till ett angivet telefonnummer.

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

```python
import json

# Transfer to a phone number
await websocket.send(json.dumps({
    "command_type": "transfer_to_number",
    "parameters": {
        "phone_number": "+1234567890"
    }
}))
```

> **Note**
>
> Systemverktyget `transfer_to_number` måste redan vara konfigurerat i agenten.

#### Kontextuell uppdatering i realtid

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

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

```python
import json

# Send a contextual update to the agent
await websocket.send(json.dumps({
    "command_type": "contextual_update",
    "parameters": {
        "contextual_update": "<your update text>"
    }
}))
```

#### Aktivera mänskligt övertagande

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

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

```python
import json

# Enable human takeover
await websocket.send(json.dumps({
    "command_type": "enable_human_takeover"
}))
```

#### Skicka meddelande som människa

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

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

```python
import json

# Send a message as a human operator
await websocket.send(json.dumps({
    "command_type": "send_human_message",
    "parameters": {
        "text": "How can I help you?"
    }
}))
```

#### Inaktivera mänskligt övertagande

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

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

```python
import json

# Disable human takeover and return to AI
await websocket.send(json.dumps({
    "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

#### Asynkron händelseleverans

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

#### Ljuddata är inte tillgängliga

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

#### Gräns för historiska hä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.

#### Begränsningar för händelsefiltrering

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

#### Anslutningstidpunkt

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 arbetsytan
för att övervaka konversationer.

## Relaterade resurser

#### [Webhooks efter samtal](/docs/sv/eleven-agents/workflows/post-call-webhooks)

Ta emot konversationsdata och analys när samtal avslutas.

#### [Agentanalys](/docs/sv/eleven-agents/customization/agent-analysis)

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

#### [Klienthändelser](/docs/sv/eleven-agents/customization/events/client-events)

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

#### [WebSocket API](/docs/sv/eleven-agents/libraries/web-sockets)

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