> 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. # 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](/docs/pl/api-reference/agents/update), SDK lub plików konfiguracji [Agents CLI](/docs/pl/eleven-agents/operate/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: | Typ alertu | Wyzwalacz | | --------------------------- | -------------------------------------------------------------------------------------- | | Niepowodzenie rozmowy | Błędy przekraczają określony odsetek rozmów | | Niepowodzenie narzędzia | Błędy przekraczają określony odsetek wywołań narzędzia, śledzony dla każdego narzędzia | | Błąd webhooka | Błędy przekraczają określony odsetek wywołań webhooka | | Wyzwolenie guardraila | Wyzwolenia guardraila przekraczają określony odsetek rozmów | | Błąd rozpoczęcia połączenia | Błędy przekraczają określony odsetek prób rozpoczęcia połączenia | | Wynik sukcesu oceny | Średni wynik sukcesu oceny spada poniżej progu | 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**](https://elevenlabs.io/app/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). ![Strona Alerts w panelu](/docs/_fern-img/d2dbe97d07149ab05ea88cff5300146de39682532a84d1a37326b01dbc04ba9f.webp) 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**](/docs/pl/eleven-agents/dashboard/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. > **Note** > > Ustawienia alertów na poziomie przestrzeni roboczej mogą zmieniać tylko administratorzy tej przestrzeni. Na stronie [**Developers** > **Alerts**](https://elevenlabs.io/app/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. ![Ustawienia alertów na karcie Advanced agenta](/docs/_fern-img/d951fa5b6cd3c39590227a893874426be4b0629cd84a6d9919b584a977d2cfdc.webp) ## Powiadomienia Alerty mogą powiadamiać zewnętrzne systemy przez [webhooki przestrzeni roboczej](/docs/pl/eleven-api/resources/webhooks), 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**](https://elevenlabs.io/app/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](/docs/pl/eleven-api/resources/webhooks). #### Ł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. ```json { "type": "convai_alerting_notification", "event_timestamp": 1739537297, "text": ":rotating_light: *New agent alert - High tool failure rate*\n*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](/docs/pl/eleven-agents/customization/integrations/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](https://developer.pagerduty.com/docs/events-api-v2-overview). Połącz integrację PagerDuty na [stronie Integrations](https://elevenlabs.io/app/agents/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 #### [Webhooki](/docs/pl/eleven-api/resources/webhooks) Skonfiguruj webhooki przestrzeni roboczej, ponowne próby i automatyczne wyłączanie. #### [Monitorowanie w czasie rzeczywistym](/docs/pl/eleven-agents/guides/realtime-monitoring) Obserwuj rozmowy na żywo i wysyłaj polecenia sterujące podczas aktywnych połączeń. #### [Webhooki po rozmowie](/docs/pl/eleven-agents/workflows/post-call-webhooks) Otrzymuj dane rozmów i analizę po ich zakończeniu. #### [Analityka](/docs/pl/eleven-agents/dashboard) Śledź metryki wydajności agentów w panelu.