AI Hero

Jak przygotować dokumenty, żeby AI umiało z nich korzystać?

Autor: Kamil Jucha, AI & Automation EngineerZaktualizowano:

Jak przygotować dokumenty, żeby AI umiało z nich korzystać?

Wgrywasz do asystenta komplet firmowych regulaminów, a on odpowiada, że nie znalazł informacji, która stoi w nich czarno na białym. Nie zepsuł się i nie jest gorszy, niż obiecywał dostawca, tylko czyta zupełnie inaczej, niż zakłada osoba pisząca dokumenty. Zobacz, jak przygotować dokumenty dla AI i dlaczego akurat te zasady, a nie inne.

Pracownica działu kadr dostaje zgłoszenie, że asystent AI nie działa. Ktoś zapytał go o wymiar urlopu przy zatrudnieniu w połowie roku i usłyszał, że takiej informacji nie ma w dokumentach. Otwiera regulamin, przewija do sekcji czwartej i pokazuje palcem akapit, który odpowiada na to pytanie wprost. Regulamin jest wgrany, asystent ma do niego dostęp, a mimo to go nie znalazł.

Takie zgłoszenia są przy wdrożeniach asystentów najczęstsze i prawie nigdy nie wynikają z awarii. Wynikają z tego, że dokumenty dla AI wyglądają inaczej niż dokumenty dla ludzi, a nikt tego nie mówi przy podpisywaniu umowy. Poniżej opisujemy, jak asystent naprawdę czyta Twoje pliki i co z tego wynika dla osoby, która je pisze.

W skrócie

  • Asystent nie czyta dokumentu w całości, tylko wycina z niego kilka fragmentów i odpowiada wyłącznie na ich podstawie.
  • Nagłówki wyznaczają miejsca cięcia, więc ściana tekstu zostaje pocięta przypadkowo.
  • Każdy akapit musi być zrozumiały po wyrwaniu z kontekstu.
  • Skany bez rozpoznania tekstu, prezentacje i pliki pod hasłem nie wnoszą nic i nie zgłaszają błędu.

Asystent nie czyta dokumentu, tylko wycina z niego fiszki

Asystent AI nie zaczytuje pliku w całości i nie zapamiętuje go tak, jak zapamiętuje człowiek. Działa raczej jak bardzo szybka osoba w bibliotece, która wcześniej pocięła wszystkie regulaminy na fiszki po kilka akapitów każda, a na pytanie wyciąga z pudełka trzy albo cztery i czyta tylko je.

Ma to dwie konsekwencje. Pierwsza jest taka, że asystent nie pamięta reszty dokumentu. Jeśli na wyciągniętej fiszce stoi „przysługuje Ci 26 dni”, a informacja o tym, że dotyczy to wyłącznie osób z dziesięcioletnim stażem, została na fiszce obok, odpowiedź będzie brzmiała pewnie i będzie błędna. Nikt nie dostanie ostrzeżenia, bo z perspektywy systemu wszystko zadziałało poprawnie.

Druga dotyczy tego, gdzie przebiega cięcie. System nie zgaduje przypadkowo, tylko szuka wskazówek w formatowaniu, a główną wskazówką są nagłówki. Dokument z porządną hierarchią zostanie pocięty tam, gdzie kończy się jedna myśl. Ten sam materiał wklejony jako ciągła ściana tekstu zostanie pocięty w losowych miejscach, więc połowa procedury wyląduje na jednej fiszce, a reszta na drugiej i żadna z nich nie będzie kompletną odpowiedzią.

To dlatego rady o tym, jak przygotować dokumenty dla AI, nie są kwestią estetyki, tylko wynikają wprost z tego jednego mechanizmu.

Pięć zasad, żeby fragment obronił się sam

Skoro asystent czyta wyłącznie wycięte kawałki, każdy kawałek musi mieć sens bez reszty dokumentu. Pięć zasad poniżej wynika wprost z tej jednej potrzeby.

1. Jeden dokument, jeden temat

Największym błędem przy budowaniu bazy wiedzy jest tworzenie encyklopedii. Stustronicowy plik „Wszystko dla nowego pracownika”, w którym mieszają się urlopy, benefity i zamawianie sprzętu, daje setki fiszek z trzech różnych dziedzin, a asystent gubi się przy wyborze właściwej.

Dziesięć krótkich dokumentów działa lepiej niż jeden ogromny. Osobno polityka urlopowa, osobno zasady przyznawania benefitów, osobno procedura zamawiania sprzętu. Warto przy okazji rozdzielić polityki, czyli ogólne zasady, od procedur, czyli instrukcji krok po kroku.

2. Akapit, który obroni się sam

Wyobraź sobie, że czytasz jeden akapit wycięty ze środka długiego pisma. Jeśli brzmi „w takim przypadku kwota zależy od stażu pracy, a wniosek należy złożyć do piętnastego dnia miesiąca”, nie wiesz ani o jaki przypadek chodzi, ani o jaką kwotę, ani co to za wniosek. Asystent ma dokładnie ten sam problem.

Rozwiązanie nie polega na powtarzaniu pełnej nazwy procedury w każdym zdaniu, tylko na zakotwiczeniu tematu na początku każdej nowej myśli. Zamiast „w takim przypadku kwota zależy od stażu pracy” piszesz „w przypadku dofinansowania do wczasów kwota świadczenia zależy od stażu pracy” i kolejne zdania w tym bloku są już zrozumiałe.

Do tej samej zasady należy żargon. Asystent przychodzi do firmy z zewnątrz i nie zna wewnętrznego słownictwa, więc jeśli formularz urlopowy oficjalnie nazywa się drukiem HR-02, ta nazwa musi padać konsekwentnie w każdym dokumencie, a każdy skrót powinien zostać rozwinięty przy pierwszym użyciu.

3. Nagłówek, który odpowiada zamiast zapowiadać

Nagłówki są dla asystenta granicami tematów, ale pełnią też drugą rolę, bo to na ich podstawie system często decyduje, do której fiszki w ogóle zajrzeć. Nagłówek „Wstęp”, „Ważne informacje” albo „Punkt 3” nie mówi mu nic.

Dobry nagłówek brzmi jak pytanie pracownika albo odpowiedź na nie, czyli „Kto jest uprawniony do premii rocznej?” zamiast „Uprawnienia”. Ważne przy tym, żeby używać wbudowanych stylów edytora, a nie samego pogrubienia i większej czcionki, bo dla systemu pogrubiony akapit nadal jest zwykłym akapitem.

4. Zero odniesień do „powyżej” i „na stronie piątej”

Fiszki nie zachowują kolejności z oryginału, więc każde odwołanie w stylu „jak wspomniano wyżej”, „zgodnie z poprzednim rozdziałem” czy „patrz strona 5” zamienia się w ślepy zaułek. Asystent wyciągający fragment ze zdaniem „formularz należy wypełnić zgodnie z instrukcją opisaną powyżej” nie ma pojęcia, o jaką instrukcję chodzi, bo akapit powyżej został na innej fiszce.

Zamiast odsyłać, powtórz kluczową nazwę. „Zgodnie z Instrukcją wypełniania formularza HR-02” kosztuje pięć słów więcej i działa zawsze.

5. Pytania zapisane językiem pracownika

Asystent najlepiej dopasowuje pytania użytkowników do dokumentów, które same zawierają te pytania. Sekcja z najczęstszymi pytaniami na końcu ważniejszych dokumentów jest przez to jednym z najtańszych sposobów na poprawę trafności odpowiedzi.

Warunek jest jeden, czyli pytania muszą być zapisane tak, jak zadałaby je osoba pytająca. „Ile dni urlopu mi przysługuje, jeśli zatrudniłem się w połowie roku?” działa. „Zasady kalkulacji wymiaru urlopu proporcjonalnego dla nowych zatrudnień” nie działa, choć opisuje to samo.

Czego asystent nie widzi w ogóle

Część materiałów nie wnosi nic niezależnie od tego, jak dobrze są napisane, bo asystent w podstawowej formie rozumie wyłącznie tekst i jest ślepy na obraz. Jeśli najważniejsze zasady są rozrysowane na infografice, system zobaczy w tym miejscu pustą treść.

Wraca to najczęściej w trzech sytuacjach, czyli przy wykresach niosących regułę, której nie ma w tekście obok, przy skanach będących w istocie zdjęciem kartki papieru oraz przy prezentacjach, gdzie treść jest z natury poszatkowana między slajdy. Skan sprawdzisz w pięć sekund, bo jeśli nie potrafisz zaznaczyć w pliku tekstu myszą, asystent też go nie przeczyta. Akurat ten problem da się naprawić, bo skan przepuszczony przez rozpoznawanie tekstu (OCR) staje się zwykłym plikiem tekstowym i działa jak każdy inny. Narzędzia masz zwykle pod ręką, czyli SharePoint Premium po stronie Microsoftu albo otwarcie skanu w Dokumentach Google, więc to kwestia jednej operacji, a nie przepisywania dokumentu.

FormatJak radzi sobie asystent
Word (DOCX)najlepiej, zachowuje nagłówki, listy i tabele
PDF tekstowybardzo dobrze, pod warunkiem że powstał z edytora, a nie ze skanera
Markdown, HTMLdobrze, czysta struktura
Arkusze (XLSX, CSV)warunkowo, przy jednym płaskim arkuszu bez pustych luk
TXTsłabo, brak nagłówków zmusza system do zgadywania granic
Prezentacje (PPTX)źle, treść poszatkowana między slajdy
Skan po rozpoznaniu tekstu (OCR)tak jak PDF tekstowy, o ile rozpoznanie faktycznie zadziałało
Skan bez OCR, zdjęcia, wideowcale
Pliki pod hasłem lub z etykietą poufnościwcale, przy czym nie zgłaszają błędu

Ostatni wiersz tej tabeli jest najbardziej kosztowny w praktyce. Plik chroniony hasłem albo oznaczony etykietą poufności zostanie wgrany, pokaże status „gotowy” i po prostu nie odda treści. Nic nie wygląda na zepsute, więc nikt tego nie szuka.

Co najczęściej idzie nie tak

Największą pozycją takiego wdrożenia jest doprowadzenie dokumentów do porządku, a przy tej pracy powtarzają się cztery pułapki.

Trzy wersje tego samego regulaminu w jednej bazie. Jeśli obok siebie leżą pliki z dopiskami v1, v2 i v3, asystent nie wie, która wersja obowiązuje, i potrafi podać zasady sprzed dwóch lat. Aktualizuj ten sam plik zamiast wgrywać kopie, a stare wersje przenieś do archiwum, do którego asystent nie ma dostępu.

Nazwa pliku, która nic nie mówi. System bierze nazwy pod uwagę, decydując, gdzie zajrzeć, więc „nowy_dokument.docx” działa przeciwko Tobie, a spójny wzorzec w rodzaju „HR-polityka-urlopowa-2026-03.docx” pracuje w każdym zapytaniu.

Brak właściciela treści po stronie firmy. To może być część obowiązków jednej osoby, która dokłada nowe materiały i wie, która wersja obowiązuje. Bez tego każda drobna zmiana wraca do wykonawcy, a baza starzeje się w tempie firmy.

Błąd nie wygląda jak błąd. Asystent nie zgłasza awarii, tylko odpowiada źle, a odpowiedź brzmi przekonująco. Najczęstszy wariant to zapewnienie, że informacji nie ma w dokumentach, mimo że jest tam czarno na białym. Dlatego zestaw pytań testowych musi pochodzić od osób, które będą z tego korzystać na co dzień, a nie od zespołu wdrożeniowego. Więcej o tym, dlaczego asystent bywa pewny siebie i nietrafiony, pisaliśmy osobno.

Co możesz zrobić już teraz

Nie musisz przepisywać całej dokumentacji, żeby zobaczyć różnicę. Wystarczą trzy ruchy.

Zbierz dziesięć pytań, które wracają. Nie z listy procedur, tylko ze skrzynki działu i z komunikatora. To one wyznaczają, które dokumenty w ogóle warto ruszać, i to na nich sprawdzisz później, czy wdrożenie ma sens.

Sprawdź, czy da się zaznaczyć tekst. Otwórz pięć najważniejszych plików i spróbuj zaznaczyć w nich fragment myszą. Każdy, w którym się nie da, jest dla asystenta pustą kartką i wymaga przepuszczenia przez rozpoznawanie tekstu, zanim trafi do bazy.

Weź jeden regulamin i przeczytaj sam środek. Wybierz akapit ze środka dokumentu i przeczytaj go bez tego, co jest wyżej. Sprawdź, czy nadal wiadomo, o czym mówi. Jeśli nie wiadomo, masz przed sobą dokładnie ten problem, który zobaczy asystent.

Ostatnia rzecz jest wykonalna także maszynowo i u naszych klientów zwykle wyprzedza właściwe wdrożenie. Agent oceniający dokumenty według stałego zestawu reguł czyta wgrany plik i zwraca uwagi w powtarzalnej strukturze, czyli dosłowny cytat problematycznego fragmentu, wyjaśnienie, dlaczego jest problemem, i gotową propozycję poprawy. Dopiero ta trójka razem daje coś, z czym da się usiąść do pracy, bo ocena bez uzasadnienia niczego nie uczy, a uzasadnienie bez propozycji zostawia człowieka z problemem.

Uwaga agenta w pełnej strukturze, czyli cytat problematycznego fragmentu, wyjaśnienie problemu i propozycja poprawy

Równie ważne jest to, czego taki agent nie robi. Nie przepisuje dokumentu za Ciebie, bo redagujący agent przestaje być narzędziem oceny i staje się kolejnym źródłem treści, której nikt nie weryfikuje. Nie ocenia też według swojej ogólnej wiedzy o dokumentacji, tylko wyłącznie według podanych reguł. Model wie sporo o standardach branżowych, więc bez tego ograniczenia wystawia oceny brzmiące rozsądnie i niezgodne z tym, co firma faktycznie ustaliła.

Na koniec analizy dostajesz od trzech do pięciu zmian o największym wpływie, bo lista dwudziestu uwag paraliżuje, a pięć uszeregowanych daje się wykonać w godzinę.

Podsumowanie analizy z listą mocnych stron dokumentu i priorytetami zmian

Dokument, którego nikt nie przeczyta w całości

Wróćmy na moment do pudełka z fiszkami. Twój regulamin nie trafia do asystenta jako dokument, tylko jako kilkadziesiąt luźnych karteczek, z których ktoś kiedyś wyciągnie trzy i na ich podstawie odpowie komuś na pytanie. Cała praca nad przygotowaniem dokumentów dla AI sprowadza się do jednego pytania, czyli czy każda z tych karteczek obroni się w pojedynkę.

Firmy, które przechodzą przez to przed wdrożeniem, zwykle odkrywają przy okazji, że część dokumentów była nieczytelna również dla ludzi, tylko nikt się nie skarżył. Jeśli chcesz sprawdzić, w jakim stanie są Twoje materiały, zanim zainwestujesz w asystenta, napisz do nas i przejdziemy przez to razem. Możesz też zajrzeć do naszej oferty i zobaczyć, jak wygląda cała ścieżka wdrożenia.

Najczęstsze pytania

Czy muszę uporządkować wszystkie dokumenty, zanim uruchomię asystenta?

Nie i zwykle jest to zły pomysł. Lepiej wybrać jeden obszar z największą liczbą powtarzalnych pytań, doprowadzić do porządku wyłącznie jego dokumenty i uruchomić asystenta na tym wycinku. Kolejne obszary dokłada się po tym, jak pierwszy zacznie działać stabilnie.

Kto w firmie powinien przygotowywać dokumenty pod asystenta?

Osoba merytorycznie odpowiedzialna za treść, nie dział IT. Decyzje w rodzaju „która wersja regulaminu obowiązuje” albo „czy te dwie procedury się nie wykluczają” są decyzjami biznesowymi i nikt z zewnątrz nie podejmie ich za firmę.

Co zrobić z wiedzą, której nikt nigdy nie spisał?

To osobna praca i trzeba ją zaplanować niezależnie od wdrożenia. Asystent obsłuży wyłącznie to, co istnieje w dokumentach, więc wiedzę mieszkającą w głowach kilku osób najpierw ktoś musi z nich wydobyć i zapisać. Pytania testowe od zespołu pokazują przy okazji, gdzie takie luki są.

Czy dane z naszych dokumentów trafią do publicznych modeli AI?

Przy rozwiązaniach uruchamianych wewnątrz firmowego środowiska dane zostają w dzierżawie organizacji i nie służą do trenowania modeli publicznych. Warto to sprawdzić przy wyborze platformy, bo rozstrzyga o tym architektura rozwiązania, a nie deklaracja. Szerzej opisaliśmy to przy okazji tematu, jakie dane firmowe można bezpiecznie przetwarzać.

Kamil Jucha

Kamil Jucha

AI & Automation Engineer

Wdraża automatyzacje i rozwiązania AI, które zdejmują z zespołów powtarzalne zadania, oraz szkoli ludzi tak, żeby sami potrafili z nich korzystać i rozwijać je dalej. W AI Hero odpowiada za wdrożenia u klientów.

Artykuły autora