Jak utrzymać aktualną bazę wiedzy bez etatowego redaktora

Asystent oparty na retrievalu jest tylko tak dobry, jak dokumenty, które za nim stoją. Budujemy systemy odpowiadające na podstawie własnych materiałów firmy, a nie ogólnej wiedzy modelu, i pytanie, które słyszymy najczęściej, nie dotyczy trafności ani czasu odpowiedzi. Dotyczy tego, kto pilnuje dokumentów źródłowych, gdy zespół wdrożeniowy przechodzi do innych zadań. Większość organizacji nie ma czym uzasadnić etatu redaktora bazy wiedzy, a te, które próbują, zwykle przekonują się, że rola zamienia się w zaległości, których nikt nie nadrabia. Dobra wiadomość: utrzymanie można rozłożyć na kilka osób, wpisać w harmonogram i w dużej części oprzeć na danych o tym, jak asystent jest używany.

Dlaczego nieaktualne odpowiedzi są gorsze niż brak odpowiedzi

Asystent dziedziczy aktualność tego, co zaindeksuje. Nic w modelu nie poprawi procedury, która straciła ważność dwa kwartały temu. Streści przestarzałą wersję płynnie i z pełnym spokojem. I to jest najdroższa część. Pewne siebie błędne odpowiedzi kosztują więcej niż cisza, bo pracownicy działają na ich podstawie bez dodatkowego sprawdzenia, a pomyłka wychodzi później w rozmowie z klientem albo na fakturze.

Ta awaria jest niewidoczna. Wyszukiwanie nadal zwraca porządny fragment, ranking nadal działa, w żadnym logu nie pojawia się błąd. Dołączanie dokumentu źródłowego do każdej odpowiedzi to zmienia: czytelnik widzi, z którego pliku pochodzi treść, zauważa, że to stara lista kroków wdrożeniowych, i zgłasza problem. Podanie źródła zamienia cichą awarię w taką, którą da się zgłosić.

Gdzie dokumentacja naprawdę się psuje

Treści starzeją się nierówno. Cenniki, kroki onboardingu, polityki bezpieczeństwa i dokumentacja API rozjeżdżają się szybko, a słowniki pojęć, historia firmy i tło regulacyjne stoją bez zmian latami. Wrzuć to wszystko do jednego kalendarza przeglądów, a zużyjesz siły na stabilne materiały i mimo to przegapisz to, co zmienia się najszybciej.

Większość szkód powodują dwa wzorce:

• Zdublowane procedury w różnych folderach. Te same instrukcje istnieją dwa razy, starzeją się w innym tempie, a wyszukiwanie bez wahania wybierze tę kopię, która wypadnie lepiej w ocenie - często starszą.
• Dokumenty zastąpione nowszymi, których nikt nie usunął. Nikt nie kasuje. Ludzie zmieniają nazwę na „v2" i zostawiają w indeksie obie wersje.

Praktyczny pierwszy krok to więc inwentaryzacja ułożona według tempa zmian, a nie według działów, z interwałem przeglądu przypisanym każdemu zestawowi.

Niech asystent sam powie, co jest zepsute

Logi zapytań to darmowa lista zadań redakcyjnych. To, o co pytają ludzie, mówi dokładnie, czego baza wiedzy nie pokrywa, a zbieranie tego nic nie kosztuje. Cztery sygnały, które obserwuję:

1. Pytania, na które wyszukiwanie nie zwróciło nic sensownego.
2. Odpowiedzi, w których wskazane źródło jest stare w stosunku do interwału przeglądu swojego zestawu.
3. Powtarzane przeformułowania jednego pytania, co zwykle znaczy, że pierwsza odpowiedź nie trafiła.
4. Tematy, do których nie ma w ogóle pasującego dokumentu.

Na osobną uwagę zasługują sprzeczności między dwoma znalezionymi dokumentami. Skoro asystent pokazuje oba, jeden z nich niemal na pewno powinien był zostać wycofany.

Wskazówka: co tydzień przejrzyj najczęstsze zapytania bez odpowiedzi i załataj trzy największe luki. To działa lepiej niż próba pełnego audytu dokumentacji, który zespoły zaczynają i rzadko kończą.

Właściciele zamiast zespołu redakcyjnego

Każdy zestaw dokumentów dostaje imiennego właściciela, który i tak pracuje z tym materiałem na co dzień. Support ma poradniki rozwiązywania problemów, finanse rozliczenia, inżynieria dokumentację API. Nikt nie musi uczyć się nowych treści, tylko potwierdzić to, co już wie.

Właściciele robią przeglądy w rytmie zależnym od tego, jak szybko rozjeżdża się ich zestaw, a nie według jednolitego kwartalnego kalendarza narzuconego całej firmie. Przeglądy są krótkie i zerojedynkowe: nadal poprawne, wymaga poprawki albo do wycofania. Ta trzecia opcja waży więcej, niż się ludziom wydaje - wyjęcie dokumentu z indeksu to najszybsza dostępna poprawa poprawności i nie wymaga pisania niczego.

Metadane i praca po stronie pipeline'u, która zdejmuje ręczną robotę

Część ciężaru da się schować w instalacji. Zapisuj datę obowiązywania, właściciela i termin kolejnego przeglądu jako metadane, żeby aktualność stała się czymś, po czym filtrujesz i rankujesz, zamiast zgadywać. Reindeksuj przy zmianie zamiast przebudowywać indeks co noc, a poprawka zrobiona rano trafia do odpowiedzi przed obiadem. Tam, gdzie się da, synchronizuj z systemem źródłowym - wiki, systemem zgłoszeń, repozytorium - zamiast wgrywać kopie, które rozjeżdżają się w chwili wgrania.

Wskazówka: dokumenty zastąpione nowszymi oznaczaj jako zarchiwizowane, zamiast je kasować. Wyszukiwanie pomija archiwum, a ślad audytowy zostaje nienaruszony.

Miejsce wdrożenia zmienia instalację, ale nie dyscyplinę. W chmurze czy on-premise zadanie ingestii i tak musi wiedzieć, kiedy dokument się zmienił.

Rutyna utrzymania, która mieści się w godzinie tygodniowo

Cała praktyka ściska się do jednej sesji w tygodniu:

• Przeczytaj tygodniowe zapytania o niskiej pewności i bez wyników, a potem pogrupuj je w tematy.
• Sprawdź najczęściej wskazywane źródła i potwierdź, że kilka pierwszych jest nadal aktualnych.
• Każdą lukę przekaż właścicielowi dokumentu jako drobną poprawkę, nigdy jako projekt dokumentacyjny.
• Wycofaj wszystko, co w ciągu tygodnia okazało się sprzeczne z nowszym dokumentem.
• Zapisz, co się zmieniło, żeby kolejna osoba robiąca przegląd czytała historię, zamiast odkrywać ją od nowa.

Najczęściej zadawane pytania

Czy asystent nie może po prostu automatycznie pomijać starych dokumentów?

Częściowo może. Aktualność da się uwzględnić w rankingu, a przeterminowane zestawy odciąć filtrem po dacie. Czego system nie rozstrzygnie, to czy dwuletnia polityka bezpieczeństwa jest już nieaktualna, czy nadal obowiązuje. Wiek i ważność to dwie różne rzeczy. Ta ocena zostaje po stronie właściciela.

Ile dokumentacji trzeba mieć, żeby wdrożenie miało sens?

Dużo bardziej niż objętość liczy się pokrycie pytań, które ludzie faktycznie zadają. Mały, aktualny zestaw obsługujący najczęściej wracające pytania bije duże archiwum, którego nikt nie utrzymuje.

Czy uruchomienie na własnej infrastrukturze utrudnia utrzymanie?

Praca redakcyjna jest identyczna. Różnica jest operacyjna: przy wdrożeniu na własnym sprzęcie harmonogram ingestii, przechowywanie danych i kontrola dostępu trafiają pod twój własny proces zmian, a nie pod proces dostawcy.

Co z tego masz

Utrzymanie staje się rutyną o małym, przewidywalnym koszcie zamiast okresową akcją ratunkową. Podanie źródła robi z każdego użytkownika korektora, choć nikogo o korektę nie prosisz. Rozproszona odpowiedzialność plus sygnały z użycia zastępują etat redaktora, na który większość zespołów nie ma uzasadnienia, a baza wiedzy zostaje użyteczna, bo jest poprawiana dokładnie tam, gdzie jest błędna, zamiast przepisywana w całości.