Alerty

Omówienie

Alerty powiadamiają cię, gdy coś nie działa z agentami w twojej przestrzeni roboczej. ElevenLabs stale monitoruje aktywność rozmów i tworzy alert, gdy współczynnik błędów przekroczy skonfigurowany próg lub gwałtownie wzrośnie ponad ostatnią wartość bazową. Alerty nie wymagają konfiguracji: monitorowanie działa automatycznie z domyślnymi progami, a w razie potrzeby możesz dostosować progi lub dodać powiadomienia.

Alerty wyświetlasz i zarządzasz nimi w panelu ElevenLabs, gdzie ustawienia konfigurujesz na poziomie przestrzeni roboczej i agenta. Ustawienia na poziomie agenta można też określić programowo przez pole platform_settings.alerting podczas tworzenia lub aktualizowania agenta za pomocą API Update agent, SDK lub plików konfiguracji Agents CLI. Ustawienia na poziomie przestrzeni roboczej i historia alertów są dostępne tylko w panelu.

Dla każdego agenta oceniane są poniższe monitory:

Każdy alert ma jeden z poniższych statusów:

• Aktywny: Warunek jest obecnie spełniony.
• Rozwiązany: Warunek przestał być spełniony, a alert został automatycznie rozwiązany po okresie braku aktywności.
• Odrzucony: Użytkownik ręcznie odrzucił alert.

Wyświetlanie alertów

Przejdź do Developers > Alerts, aby zobaczyć ostatnie alerty monitorowania dla agentów w swojej przestrzeni roboczej. Strona pokazuje oś czasu aktywności alertów i tabelę z czasem, czasem trwania, statusem, typem oraz agentem dla każdego alertu. Możesz filtrować według statusu, agenta lub narzędzia oraz dostosować zakres czasu (do 90 dni).

Kliknij alert, aby otworzyć rozmowy, których dotyczy, albo użyj menu wiersza, aby wybrać Inspect conversations w historii rozmów. Aktywne alerty możesz odrzucić z tego samego menu.

Aktywne alerty pojawiają się też jako karty o wysokim priorytecie w Spotlight, panelu przeglądu na stronie każdego agenta, a baner w panelu Agents prowadzi do strony Alerts, gdy twoja przestrzeń robocza ma aktywne alerty.

Konfiguracja progów

Progi alertów możesz skonfigurować na poziomie przestrzeni roboczej i nadpisać dla każdego agenta. Nieustawione wartości używają konfiguracji przestrzeni roboczej, a nieustawione wartości przestrzeni roboczej — ustawień domyślnych systemu.

Na stronie Developers > Alerts kliknij Alerts settings i wybierz Configure thresholds. Aby nadpisać progi dla jednego agenta, otwórz sekcję Alerting na karcie ustawień Advanced agenta i kliknij Configure thresholds.

Każdy monitor można włączyć lub wyłączyć. Ma on też ustawienie Threshold: współczynnik błędów wyzwalający alert, wyrażony jako wartość procentowa od 0% do 100%. Możesz również ustawić Auto-resolve after inactivity (minutes), aby określić, jak długo alert może pozostawać nieaktywny przed automatycznym rozwiązaniem.

Powiadomienia

Alerty mogą powiadamiać zewnętrzne systemy przez webhooki przestrzeni roboczej, Slack i PagerDuty. Gdy alert zostanie wyzwolony, rozwiązany lub odrzucony, ElevenLabs powiadamia każdy skonfigurowany moduł powiadamiający. Moduły powiadamiające można przypisać na poziomie przestrzeni roboczej i dla każdego agenta; moduły na poziomie agenta są dodawane do modułów przestrzeni roboczej, a nie je zastępują. Na każdym poziomie można skonfigurować do 10 modułów.

Aby skonfigurować moduł powiadamiający, kliknij Alerts settings > Configure notifications na stronie Developers > Alerts albo — dla jednego agenta — Configure notifications w sekcji Alerting na karcie ustawień Advanced agenta. Każdy moduł ma akcję Send test, która pozwala sprawdzić dostarczanie przed wyzwoleniem alertu.

Webhooki

Wybierz istniejący webhook przestrzeni roboczej lub utwórz nowy z adresem URL wywołania zwrotnego HTTPS. ElevenLabs wysyła żądanie POST dla każdego zdarzenia cyklu życia alertu. Twój endpoint powinien zweryfikować podpis żądania i szybko zwrócić HTTP 200; webhooki, które wielokrotnie zawodzą, są automatycznie wyłączane zgodnie z tymi samymi zasadami co inne webhooki przestrzeni roboczej.

Ładunek powiadomienia

Powiadomienia o alertach używają typu zdarzenia convai_alerting_notification. Pole event.name wskazuje, co się stało: triggered, gdy alert staje się aktywny, auto_resolved, gdy zostaje rozwiązany po braku aktywności, oraz resolved, gdy użytkownik go odrzucił (wtedy was_resolved_by_user ma wartość true). Pole text zawiera czytelne dla człowieka podsumowanie sformatowane w znacznikach Slack, więc powiadomienie można przekazać bezpośrednio do przychodzącego webhooka Slack.

{
  "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
  }
}

Pole monitor ma jedną z wartości: elevated_conversation_failure_rate, elevated_tool_failure_rate, webhook_error_spike, guardrail_trigger_spike, call_initiation_error_spike lub low_evaluation_success_score. Pole tool_name jest ustawiane tylko w alertach o błędach narzędzi.

Slack

Moduły powiadamiające Slack publikują powiadomienia o alertach bezpośrednio na kanale Slack. Połącz integrację Slack ze swoją przestrzenią roboczą, a następnie dodaj połączenie jako moduł powiadamiający i wpisz ID kanału, na którym mają pojawiać się posty. Aby znaleźć ID kanału w Slack, otwórz kanał, kliknij jego nazwę w nagłówku, przewiń na dół karty About i skopiuj Channel ID (na przykład C0123456789). Dodaj połączoną aplikację Slack do kanału; aplikacja potrzebuje zakresu chat:write lub chat:write.public, aby publikować na publicznych kanałach, do których nie dołączyła. Wiadomość jest publikowana po wyzwoleniu alertu oraz ponownie po jego rozwiązaniu.

PagerDuty

Moduły powiadamiające PagerDuty dostarczają alerty jako incydenty PagerDuty przez Events API. Połącz integrację PagerDuty na stronie Integrations, używając klucza integracji Events API v2 z usługi PagerDuty, która ma otrzymywać alerty, a następnie dodaj połączenie jako moduł powiadamiający. Incydent jest wyzwalany, gdy alert staje się aktywny, i automatycznie rozwiązywany po rozwiązaniu alertu; powtarzające się wyzwolenia tego samego alertu są scalane w jeden incydent. Obsługiwane są regiony usług PagerDuty w USA i UE.

Powiązane materiały