Files
servicedesk/wiki/operator
Kacper 313e01ad24 v1.2.1
- Generic AI integration (Admin > Integracje > "Integracja AI"), optional and
  off by default: an OpenAI-compatible /chat/completions client (Groq, OpenAI,
  or a self-hosted Ollama instance) configured by base URL, optional API key,
  model, and an SSL-verification toggle. Foundation for the two AI features
  below and anything else that wants an LLM call in the future.
- BookStack automatic content tagging (AI): "Otaguj nową treść"/"Otaguj
  wszystko ponownie" buttons plus `php artisan bookstack:tag-content`
  (--dry-run/--force/--limit=N) tag every book/chapter/page with matching
  helpdesk subcategory names, idempotent by default.
- BookStack search refinement: "Przeszukuj" is now three independent
  checkboxes (Książki/Strony/Rozdziały) instead of a single dropdown, plus a
  new "Szukaj po" setting (nazwa/tagi/oba) — tag matching uses the bare
  subcategory name, matching what auto-tagging writes.
- AI-driven ticket triage + summary (Admin > Integracje > "Automatyzacja AI
  dla zgłoszeń", via new scheduled ai:run-ticket-automation): five toggles
  auto-assign/correct category+subcategory, rewrite an unclear subject, and
  set priority from content, once per ticket in the background; every change
  is logged in the ticket's history. Separately, an AI summary + suggested
  action for every ticket, shown to operators only, with an admin-editable
  prompt.
- Operators can now reassign a ticket to any team, not just one they belong
  to.
- The auto-refresh countdown badges (ticket view, operator queue) are now
  clickable — fetch immediately and reset the countdown.
- All 7 "cyclical" intervals (3 browser refresh countdowns, the notification
  bell poll, and the 4 background scheduled commands) are now configurable
  from Admin > Konfiguracja instead of fixed in code.
- Fixed: an operator viewing a ticket that's deleted or moved outside their
  team scope mid-session is now redirected to the operator queue instead of
  hitting an error.
- Docs: README/ARCHITECTURE/CLAUDE/install/wiki updated for all of the above.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-24 13:38:39 +02:00
..
2026-07-24 13:38:39 +02:00

Przewodnik — Operator

Panel operatora (/operator) to miejsce pracy z kolejką zgłoszeń: przegląd, odpowiadanie, zmiana statusu/priorytetu/przypisania oraz statystyki zespołu.

Domyślnie każde konto ląduje po zalogowaniu w panelu Klienta; przełącz się do panelu Operatora przez menu profilu (prawy górny róg), jeśli konto ma tę rolę. Dzwoneczek powiadomień w górnym pasku (widoczny we wszystkich panelach) pokazuje Twoje nieprzeczytane powiadomienia, aktualizowane na żywo w chwili ich utworzenia (niezależny od tego 30-sekundowy fallback dogrywa to, co ominęłoby zerwane połączenie) — kliknięcie (albo „Oznacz wszystkie jako przeczytane”) usuwa je z listy.

„Powiadomienia” w menu profilu (/settings/notifications) pozwala wybrać, dla każdej kategorii zdarzeń (nowe zgłoszenie, aktualizacja zgłoszenia, eskalacja), jaki zakres zgłoszeń ma Cię powiadamiać dzwoneczkiem — moje / nieprzypisane / obserwowane / wszystkie — oraz czy dodatkowo wysłać e-mail. Tam też włączysz natywne powiadomienia push przeglądarki (działają, dopóki karta jest otwarta).

Kolejka zgłoszeń — aktualizacje na żywo

Panel główny (/operator) pokazuje listę zgłoszeń z zakładkami po lewej stronie:

  • Otwarte — wszystkie zgłoszenia jeszcze nie zamknięte, widoczne dla Ciebie.
  • Moje zgłoszenia — przypisane do Ciebie (bez zamkniętych).
  • Nieprzypisane — czekają na przejęcie przez kogoś z zespołu (bez zamkniętych).
  • Zamknięte — archiwum; jedyna zakładka, w której pojawiają się zamknięte zgłoszenia.
  • Zespoły — osobna zakładka na każdy zespół, do którego należysz (administrator widzi wszystkie zespoły; też bez zamkniętych).

Nie-administratorzy widzą tylko zgłoszenia swoich zespołów, zgłoszenia bez przypisanego zespołu, oraz wszystko przypisane bezpośrednio do nich.

Filtry nad tabelą: status, priorytet, kategoria, wyszukiwanie po numerze/ temacie/kliencie/treści zgłoszenia i odpowiedzi w wątku. Kolumny można dowolnie włączać/wyłączać przyciskiem „Kolumny” (numer, temat, klient, kategoria, podkategoria, priorytet, status, SLA, przypisany, zespół, utworzono — kilka z nich domyślnie ukryte), a nagłówki kolumn sortują listę. Wybrana zakładka i kolumny zostają zapamiętane w adresie strony, więc odświeżenie nie cofa Cię do pierwszej zakładki.

Zapisane widoki — przycisk „Zapisane widoki” pozwala zapisać bieżącą kombinację zakładki/filtrów/sortowania/kolumn pod własną nazwą, oznaczyć jeden z zapisanych widoków jako domyślny (ładuje się automatycznie przy wejściu do kolejki) i usuwać niepotrzebne. Widoki są prywatne — każdy operator widzi tylko swoje.

Akcje zbiorcze: zaznacz kilka zgłoszeń checkboxami, by je scalić (pierwsze zaznaczone staje się główne, reszta trafia do niego jako wiadomości i zostaje zamknięta) albo usunąć. Checkbox w nagłówku tabeli zaznacza/odznacza od razu wszystkie zgłoszenia aktualnie widoczne pod bieżącym filtrem/zakładką (nie wszystkie w systemie).

Zgłoszenie założone albo odpowiedziane przez e-mail (patrz konfiguracja w Admin > Poczta) ma widoczną ikonę koperty obok numeru w kolejce oraz przy konkretnej wiadomości w wątku zgłoszenia.

Kolejka aktualizuje się na żywo — nowe zgłoszenie, zmiana statusu/priorytetu/ przypisania czy nowa odpowiedź pojawiają się bez odświeżania strony. Obok przycisku „Kolumny” widać mały licznik odliczający do zera — to niezależny od połączenia na żywo, okresowy fallback (interwał ustawia administrator w Konfiguracji, domyślnie co ok. 60 s), na wypadek gdyby połączenie sieciowe w tle się zerwało. Licznik jest też klikalny — kliknięcie od razu odświeża listę i resetuje odliczanie, zamiast czekać na naturalny koniec.

Praca ze zgłoszeniem

Widok zgłoszenia też aktualizuje się na żywo — nowa wiadomość klienta pojawia się od razu (bez odświeżania), podobnie jak zmiana statusu/priorytetu/zespołu zrobiona przez innego operatora, przez regułę automatyzacji SLA albo przez automatyzację AI (patrz „Historia” niżej). Licznik przy przycisku „Wróć do listy” to taki sam fallbackowy, klikalny zegar jak w kolejce (domyślnie co ok. 30 s, konfigurowalny przez administratora).

Jeśli zgłoszenie, które akurat oglądasz, zostanie usunięte przez kogoś innego, albo trafi (przez zmianę zespołu) poza Twój zakres widoczności — zostaniesz automatycznie przeniesiony z powrotem do swojej kolejki, zamiast zobaczyć błąd.

W widoku pojedynczego zgłoszenia:

  • Obserwuj — przycisk obok licznika auto-odświeżania oznacza zgłoszenie jako obserwowane niezależnie od przypisania czy zespołu; zasila zakres „Obserwowane zgłoszenia” w Twoich preferencjach powiadomień (/settings/notifications).
  • Zmiana statusu / priorytetu / zespołu / przypisanego operatora — z listy rozwijanej; „Przypisz do mnie” to skrót jednym kliknięciem. Zespół można zmienić na dowolny, nie tylko taki, do którego sam należysz — jeśli przeniesiesz zgłoszenie do zespołu spoza swojego zakresu widoczności, zostaniesz automatycznie przeniesiony do swojej kolejki.
  • Odpowiedź publiczna — widoczna dla klienta; można wybrać szablon odpowiedzi (wstawia gotowy tekst do edycji) i wysłać razem ze zmianą statusu jedną szybką akcją (np. „Wyślij i zamknij”) zamiast dwóch osobnych kroków.
  • Notatka wewnętrzna — widoczna tylko dla operatorów/adminów, np. do przekazania kontekstu innemu operatorowi.
  • Załączniki — do odpowiedzi/notatki, przeciągnij pliki na pole załączników albo kliknij, żeby wybrać je z dysku, w granicach limitów ustawionych przez administratora; załączone obrazy pokazują się jako miniatury w wątku.
  • Baza wiedzy (jeśli administrator włączył integrację z BookStack) — panel boczny podpowiada artykuły pasujące do kategorii/podkategorii zgłoszenia; kliknięcie otwiera artykuł, przycisk „Kopiuj link" kopiuje adres bez wychodzenia ze zgłoszenia (np. do wklejenia w odpowiedzi).
  • Podsumowanie AI (jeśli administrator włączył automatyzację AI zgłoszeń) — panel boczny widoczny tylko w panelu operatora, pokazuje krótkie podsumowanie sprawy i sugerowaną kolejną akcję; odświeża się samo, gdy w wątku pojawi się nowa wiadomość — nie trzeba go ręcznie odświeżać.
  • Ocena obsługi — jeśli klient już ocenił zgłoszenie, ocena (gwiazdki + ewentualny komentarz) pokazuje się w panelu bocznym, tylko do odczytu.
  • Licznik czasu pracy — start/stop/reset przy zgłoszeniu; czas zapisuje się automatycznie nawet przy zamknięciu karty (mechanizm sendBeacon). Zliczanie jest automatycznie wstrzymywane, gdy zgłoszenie ma status zamknięty — nie uruchomi się przy otwarciu zamkniętego zgłoszenia ani nie będzie dalej biec po jego zamknięciu; wcześniej naliczony czas można wciąż ręcznie skorygować.
  • Edycja danych zgłoszenia — temat, opis, podkategoria, pola dodatkowe; zmiana kategorii może wysłać powiadomienie do klienta.
  • Historia — log każdej zmiany (status, priorytet, zespół, przypisanie, kategoria/podkategoria, temat) z datą; wpis „Automatyzacja: nazwa reguły” oznacza regułę automatyzacji SLA (Admin > Automatyzacja SLA), a „Automatyzacja: klasyfikacja AI” — automatyczną kategoryzację/priorytet ustawione przez integrację AI (Admin > Integracje) — w obu przypadkach nie operator ręcznie.

Statystyki (/operator/stats)

Nowa zakładka „Statystyki” (przycisk w pasku narzędzi kolejki) pokazuje pulpit analityczny z możliwością filtrowania — dane odświeżają się na żywo przy każdej zmianie filtra, bez przeładowania strony.

Filtry:

  • Zakres dat — Dziś / 7 dni / 30 dni / 90 dni / Cały okres / zakres niestandardowy (oddo).
  • Zespół, priorytet, kategoria, operator — jak w kolejce; nie-administratorzy widzą tylko swoje zespoły i przypisanych do nich operatorów.

Kafelki KPI:

Wskaźnik Co pokazuje
Łącznie zgłoszeń liczba zgłoszeń w wybranym zakresie/filtrach
Otwarte / Zamknięte podział + % zamkniętych
Śr. czas 1. odpowiedzi średni czas od utworzenia do pierwszej odpowiedzi operatora
Śr. czas rozwiązania średni czas od utworzenia do zamknięcia (przybliżony — brak osobnej daty "rozwiązano", liczony do ostatniej aktualizacji zamkniętego zgłoszenia)
Naruszenia SLA % zgłoszeń, które przekroczyły czas rozwiązania wg priorytetu (zgodnie z regułami SLA w Admin > Statusy/Priorytety)
Ocena obsługi (CSAT) średnia ocen klientów (15) w wybranym zakresie/filtrach + % zamkniętych zgłoszeń, które zostały ocenione

Przycisk „Eksportuj CSV" pobiera listę zgłoszeń (jeden wiersz na zgłoszenie) z uwzględnieniem aktualnie wybranego zakresu dat i filtrów.

Reszta strony jest podzielona na sekcje:

Rozkład zgłoszeń (paski poziome, kolor = ta sama identyfikacja co w kolejce dla statusu/priorytetu; najedź kursorem na pasek, by zobaczyć dokładną wartość):

  • Zgłoszenia wg statusu
  • Zgłoszenia wg priorytetu
  • Zgłoszenia wg kategorii
  • Zgłoszenia wg podkategorii

Obciążenie:

  • Obciążenie zespołów
  • Obciążenie operatorów (ranking wg liczby przypisanych zgłoszeń)

Klienci:

  • Najaktywniejsi klienci (Top 10 wg liczby zgłoszeń w wybranym okresie; osobny wiersz „Goście (bez konta)” sumuje zgłoszenia bez zalogowanego klienta)
  • Klienci wg podkategorii — tabela krzyżowa: top 10 klientów × top 5 najczęstszych podkategorii w wybranym okresie, reszta podkategorii zbiorczo w kolumnie „Inne”.

Ocena obsługi (CSAT) — średnia ocena (X.XX / 5) wg zespołu i wg operatora; zespół/operator bez żadnej oceny w wybranym okresie po prostu nie pojawia się na liście.

Trend — dzienny wykres słupkowy „Nowe zgłoszenia” i „Zamknięte zgłoszenia” obok siebie (maks. ostatnie 60 dni wybranego zakresu, żeby słupki pozostały czytelne przy długich okresach).

Wskazówki

  • Zgłoszenie bez przypisanego zespołu jest widoczne dla wszystkich operatorów — warto je szybko zaklasyfikować/przypisać.
  • Szybkie akcje i szablony odpowiedzi konfiguruje administrator (Admin > Szybkie akcje / Szablony odpowiedzi) — zgłoś mu, jeśli brakuje przydatnego szablonu.