Aviseringar

Översikt

Aviseringar meddelar dig när något går fel med agenterna i din arbetsyta. ElevenLabs övervakar kontinuerligt konversationsaktivitet och utlöser en avisering när en felfrekvens överskrider ett konfigurerat tröskelvärde eller stiger kraftigt över sin senaste baslinje. Aviseringar kräver ingen konfiguration för att börja fungera: övervakningar körs automatiskt med standardtrösklar, och du kan justera tröskelvärden eller lägga till aviseringar vid behov.

Aviseringar visas och hanteras på ElevenLabs instrumentpanel, där inställningar konfigureras på arbetsyte- och agentnivå. Inställningar på agentnivå kan också ställas in programmatiskt via fältet platform_settings.alerting när du skapar eller uppdaterar en agent med API:t Uppdatera agent, SDK:er eller konfigurationsfiler för Agents CLI. Inställningar på arbetsytenivå och aviseringshistoriken är endast tillgängliga på instrumentpanelen.

Följande övervakningar utvärderas för varje agent:

Varje avisering har en av följande statusar:

• Aktiv: Villkoret utlöses för närvarande.
• Löst: Villkoret slutade utlösas och aviseringen löstes automatiskt efter en period av inaktivitet.
• Avfärdad: En användare avfärdade aviseringen manuellt.

Visa aviseringar

Gå till Utvecklare > Aviseringar för att se de senaste övervakningsaviseringarna för agenter i din arbetsyta. Sidan visar en tidslinje över aviseringsaktivitet och en tabell med varje aviserings tidsstämpel, varaktighet, status, typ och agent. Du kan filtrera efter status, agent eller verktyg och justera tidsintervallet (upp till 90 dagar).

Klicka på en avisering för att öppna de berörda konversationerna, eller använd radmenyn för att Granska konversationer i konversationshistoriken. Aktiva aviseringar kan avfärdas från samma meny.

Aktiva aviseringar visas också som högprioriterade kort i Spotlight, översiktsinstrumentpanelen på varje agents sida, och en banderoll på agenternas instrumentpanel länkar till sidan Aviseringar när din arbetsyta har aktiva aviseringar.

Konfigurera tröskelvärden

Tröskelvärden för aviseringar kan konfigureras på arbetsytenivå och åsidosättas per agent. Ej angivna värden använder arbetsytans konfiguration, och ej angivna värden för arbetsytan använder systemets standardvärden.

Klicka på Aviseringsinställningar och välj Konfigurera tröskelvärden på sidan Utvecklare > Aviseringar. Om du vill åsidosätta tröskelvärden för en enskild agent öppnar du avsnittet Aviseringar på fliken Avancerat i agentens inställningar och klickar i stället på Konfigurera tröskelvärden.

Varje övervakning kan aktiveras eller inaktiveras och har en inställning för Tröskelvärde: felfrekvensen som utlöser en avisering, som en procentandel mellan 0 % och 100 %. Du kan också ange Lös automatiskt efter inaktivitet (minuter) för att styra hur länge en avisering kan vara inaktiv innan den löses automatiskt.

Notifieringar

Aviseringar kan meddela externa system via webhooks för arbetsytan, Slack och PagerDuty. När en avisering utlöses, löses eller avfärdas meddelar ElevenLabs varje konfigurerad notifierare. Notifierare kan kopplas på arbetsytenivå och per agent; notifierare på agentnivå läggs till utöver notifierare på arbetsytenivå i stället för att ersätta dem. Upp till 10 notifierare kan konfigureras per nivå.

För att konfigurera en notifierare klickar du på Aviseringsinställningar > Konfigurera notifieringar på sidan Utvecklare > Aviseringar, eller, för en enskild agent, på Konfigurera notifieringar i avsnittet Aviseringar på fliken Avancerat i agentens inställningar. Varje notifierare har åtgärden Skicka test för att verifiera leveransen innan en avisering utlöses.

Webhooks

Välj en befintlig webhook för arbetsytan eller skapa en ny med en HTTPS-URL för återanrop. ElevenLabs skickar en POST-begäran för varje händelse i aviseringens livscykel. Din slutpunkt bör verifiera begärans signatur och snabbt returnera HTTP 200. Webhooks som upprepade gånger misslyckas inaktiveras automatiskt enligt samma regler som andra webhooks för arbetsytan.

Notifieringsnyttolast

Aviseringsnotifieringar använder händelsetypen convai_alerting_notification. Fältet event.name anger vad som hände: triggered när aviseringen blir aktiv, auto_resolved när den löses efter inaktivitet och resolved när en användare avfärdar den (i så fall är was_resolved_by_user true). Fältet text innehåller en läsbar sammanfattning formaterad med Slack-markering, så notifieringen kan vidarebefordras direkt till en inkommande Slack-webhook.

{
  "type": "convai_alerting_notification",
  "event_timestamp": 1739537297,
  "text": ":rotating_light: *New agent alert - High tool failure rate*\n*Agent:* <https://elevenlabs.io/app/agents/agents/agent_7101k5zvyjhmfg983brhmhkd98n6|Support agent>\n*Status:* Triggered\n*Started at:* 14 February at 12:48 UTC",
  "event": {
    "name": "triggered",
    "was_resolved_by_user": false
  },
  "alert": {
    "id": "alert_2601k5zvyjhmfg983brhmhkd98n6",
    "tool_name": "get_order_status",
    "monitor": "elevated_tool_failure_rate",
    "metric_name": "tool_failure_rate",
    "status": "active",
    "first_triggered_at_unix_secs": 1739537297,
    "last_triggered_at_unix_secs": 1739537897
  }
}

Fältet monitor är ett av elevated_conversation_failure_rate, elevated_tool_failure_rate, webhook_error_spike, guardrail_trigger_spike, call_initiation_error_spike eller low_evaluation_success_score. Fältet tool_name anges bara för aviseringar om verktygsfel.

Slack

Slack-notifierare publicerar aviseringsnotifieringar direkt i en Slack-kanal. Anslut Slack-integrationen till din arbetsyta, lägg sedan till anslutningen som en notifierare och ange ID:t för kanalen att publicera till. För att hitta kanal-ID:t i Slack öppnar du kanalen, klickar på kanalnamnet i sidhuvudet och bläddrar sedan längst ned på fliken Om för att kopiera kanal-ID:t (till exempel C0123456789). Lägg till den anslutna Slack-appen i kanalen; appen behöver scopet chat:write, eller chat:write.public för att publicera i offentliga kanaler som den inte har gått med i. Ett meddelande publiceras när en avisering utlöses och igen när den löses.

PagerDuty

PagerDuty-notifierare levererar aviseringar som PagerDuty-incidenter via Events API. Anslut PagerDuty-integrationen på integrationssidan med en Events API v2-integrationsnyckel från PagerDuty-tjänsten som ska ta emot aviseringarna, och lägg sedan till anslutningen som en notifierare. En incident utlöses när en avisering blir aktiv och löses automatiskt när aviseringen löses. Upprepade utlösningar av samma avisering avdupliceras till en enda incident. Både amerikanska och europeiska PagerDuty-tjänstregioner stöds.

Relaterade resurser