Podręcznik uczestnika z objaśnieniami, przykładami i ćwiczeniami do samodzielnej nauki do Modułu 2

Porównuj przede wszystkim uzasadnienia. Część decyzji projektowych ma kilka poprawnych wariantów, ale żaden nie może opierać się na wymyślonej treści, pominiętej negacji lub nieprawdziwym źródle. Poniższe odpowiedzi dotyczą ćwiczeń offline z tej książki.

Ćwiczenie 1 — zakres i źródła

Przykładowy zakres: „Baza wspiera pracowników w interpretowaniu aktualnych instrukcji i zasad wsparcia DocAssist. Obejmuje dokumenty 1.4, nie obsługuje historii zmian i nie ustala nieudokumentowanych terminów rozwiązania zgłoszeń”. Można dodać, że asystent nie wykonuje poleceń administracyjnych.

Do bieżącego korpusu przyjmujemy instrukcja.txt, regulamin.md, docassist.pdf i pomoc.html: ich tematy odpowiadają zadaniu, a wersja 1.4 ma status active. regulamin_v1_3.md pomijamy jako archived i zastąpiony. Zachowujemy go w inwentarzu z uzasadnieniem oraz w archiwum źródeł. Nie musi być usunięty z dysku.

Pytanie	Najbardziej bezpośrednie źródło	Na co uważać
P1	instrukcja.txt	Warunek zmiany konfiguracji, dwa kroki i wynik
P2	regulamin.md 1.4	Dyżur oraz wyjątek awaryjny
P3	docassist.pdf, strona 1	Jednostki i fikcyjny zakres parametrów
P4	pomoc.html	Przekazanie komunikatu i zakaz pochopnej zmiany uprawnień
P5	regulamin.md, „Treść zgłoszenia”	Dokument nie podaje wartości gwarantowanego czasu

P5 nie wolno rozwiązać obietnicą 30 sekund, 24 godzin ani innego terminu. Poprawna odpowiedź wskazuje brak takiej wartości w źródle. Karty pracy, klucz i gotowe oceny nie należą do korpusu opisanego asystenta: dotyczą nauki przygotowania danych. Nieznaną datę zapisujemy jako null; jeżeli jej brak uniemożliwia decyzję o obowiązywaniu rzeczywistego źródła, kierujemy dokument do wyjaśnienia. W tym ćwiczeniu status i zastąpienie wersji są podane jawnie.

Ćwiczenie 2 — odczyt

W A szum stanowią nawigacja i stopka. Treść sekcji „Błąd połączenia”, w tym warunek działania usługi i negacja, jest zachowana. Należy oddzielić treść główną oraz zachować jej nagłówek. Nie wystarczy jednak ocenić w ten sposób całego pliku: drugą sekcję „Kontrola znaków” także trzeba odczytać i sprawdzić.

B gubi zapis dokładnego komunikatu i przekazanie go administratorowi. Co gorsza, nakazuje zmianę uprawnień w miejsce zakazu zmieniania ich bez ustalenia przyczyny. Tego wyniku nie naprawi kosmetyczne czyszczenie. Trzeba wrócić do odczytu i porównać go z oryginałem.

Powstaje pięć rekordów: TXT ze stroną null, MD ze stroną null, PDF strona 1, PDF strona 2 oraz HTML ze stroną null. Każdy zachowuje źródło i własny identyfikator rekordu. Dla skanu z pustym wynikiem rozpoznajemy brak warstwy tekstowej i planujemy OCR albo inny kontrolowany odczyt, a następnie sprawdzamy wynik. Nie uznajemy pustego tekstu za sukces.

Przykładowe ciągi do kontroli: „Zażółć gęślą jaźń”, docassist-api, --no-pager, 25°C. Warto dodać ±5% oraz ≤10 ms, ponieważ sprawdzają znaki i jednostki, które mogą zmienić znaczenie po uszkodzeniu.

Ćwiczenie 3 — czyszczenie

Dopuszczalne są B, C i E, przy opisanych warunkach kontroli. A usunęłaby oba ponumerowane kroki, a w innych tekstach także wiersze z parametrami. D zniszczyłaby docassist-api i usunęła negację. Wariant „wykonuj restart bez zmiany konfiguracji” byłby odwróceniem sensu źródła.

Wynik powinien odpowiadać blokowi „po” z R3. Dopuszczalne są drobne różnice układu, o ile zachowują kolejność i znaczenie. Przykładowy rejestr:

Operacja	Powód	Kontrola
Usunięto rozpoznany nagłówek	Powtarzany element strony	Porównanie z oryginałem; nagłówek sekcji pozostał
Usunięto „Strona 1 z 2”	Stopka techniczna	Numer 1 nadal w metadanych
Połączono „konfigu-” i „racji”	Potwierdzone łamanie wyrazu	Nazwa usługi i komendy nie zostały zmienione

Muszą przetrwać m.in. warunek zmiany konfiguracji, negacja, kolejność restart–sprawdzenie, nazwa docassist-api i wynik active. Spośród danych R2 należy zachować np. 8 GB lub 30 s wraz z informacją, co oznaczają. Same liczby bez jednostek i kontekstu nie są wystarczające.

Ćwiczenie 4 — granice fragmentów

Wariant B jest lepszy dla pytania o awarię całego zespołu po 16:00, ponieważ zawiera regułę i wyjątek razem. Z regulaminu wynika zgłoszenie takiej awarii dyżurnemu administratorowi zgodnie z wewnętrzną procedurą. Szczegółów tej procedury nie podano, więc nie można ich odtworzyć z wyobraźni.

Dwadzieścia znaków overlapu nie jest semantyczną gwarancją. Trzeba obejrzeć rzeczywisty tekst na granicy i sprawdzić, czy zachował cały warunek. Liczba znaków nie mówi, czy przeniesiono początek wyjątku, całą treść wyjątku czy jedynie końcówkę słowa.

Dla restartu potrzebujemy warunku zmiany konfiguracji, obu kroków, kolejności i wyniku active; sam wynik nie wskazuje, co wykonano. Dobrym początkiem dla krótkiego regulaminu są sekcje, z kontrolą oddzielenia wyjątków i długich sekcji. Dla tekstu bez nagłówków można zacząć od akapitów, a gdy struktura jest niewiarygodna — od znaków z nakładaniem i ręczną oceną granic.

Kryteria jakości to np. zachowanie warunku i wyjątku oraz samodzielna zrozumiałość fragmentu. Można też oceniać możliwość wskazania źródła, obecność szumu i nadmierne powtórzenia. Znak jest jednostką zapisu tekstu, a token zależy od sposobu tokenizacji stosowanego przez model; 420 znaków nie oznacza 420 tokenów.

Ćwiczenie 5 — metadane

source powinno mieć wartość regulamin.md, a version — 1.4. page_number, page_start i page_end powinny mieć wartość null, bo źródłem jest Markdown. updated_at również ma wartość null, ponieważ daty nie znamy. Nie wpisujemy dosłownego słowa „dzisiaj” ani bieżącej daty jako rzekomego faktu źródłowego.

status przyjmuje active, zgodnie z opisem dokumentu. Ocena jakości należy do metadata.qa_status. Bez sprawdzenia treści nie można uzasadnić accepted; rekord wymaga przeglądu. Nagłówek przenosimy z pola pośredniego section_title do końcowego section, zachowując wartość „Dyżur operatora”.

Po odrzuceniu D identyfikatory E i F pozostają takie same, a vector_index wynosi odpowiednio 0 i 1. Pole access_level: internal opisuje zamierzony zakres dostępu. Nie jest mechanizmem uwierzytelniania ani kontroli uprawnień; aplikacja musi takie ograniczenia rzeczywiście egzekwować.

Ćwiczenie 6 — audyt i decyzja

ID	Pierwsza ocena	Uzasadnienie lub działanie
A	accepted	Aktualna, sprawdzona reguła wraz z wyjątkiem
B	rejected	Archiwalna wersja poza zakresem bieżącego asystenta
C	review	Sam wynik nie wyjaśnia testu; wróć do podziału i pełnej sekcji
D	review	Strona 7 nie istnieje; sprawdź źródło i popraw wszystkie pola strony na 1
E	rejected	Pusty tekst nie jest fragmentem wiedzy; zaplanuj poprawę odczytu

Dopuszczalne jest odrzucenie C zamiast pozostawienia go do naprawy, pod warunkiem opisania utraty pokrycia P1 i zaplanowania nowego, pełnego fragmentu. Nie jest poprawne przyjęcie go wyłącznie dlatego, że słowo active występuje w instrukcji.

W pierwszym przeglądzie NO-GO: pozostają nierozstrzygnięte C i D. Dla C trzeba odzyskać pełną procedurę z warunkiem, krokami i wynikiem, a następnie przeliczyć zależne pola. Dla D trzeba poprawić pochodzenie strony i zweryfikować zgodność treści. Po opisanej w zadaniu naprawie przyjęte etykiety A, C i D mają indeksy 0, 1 i 2.

P1, P2 i P3 są wtedy pokryte. P4 nadal nie ma pokrycia, ponieważ pusty E odrzucono i nie dodano poprawnego fragmentu „Błąd połączenia”. P5 nie ma wartości gwarantowanego czasu w korpusie. To dwa różne braki: P4 wymaga naprawy przetwarzania istniejącej treści, a P5 wymaga jawnego komunikatu o braku danych, bez zmyślania wartości.

Przykładowe podsumowanie: „Zbiór po naprawie zawiera trzy przyjęte fragmenty i nie ma ocen oczekujących. Nie pokrywa jeszcze błędu połączenia P4, a źródła nie określają wartości gwarantowanego czasu dla P5. Przed przekazaniem bazy do eksperymentu obejmującego cały zadeklarowany zakres poprawimy odczyt pomocy i ponowimy zależne etapy oraz audyt”.

Warunek techniczny GO może być już spełniony, ale pełny zadeklarowany zakres wymaga uzupełnienia P4. Dopuszczenie do eksperymentu ograniczonego do P1–P3 wymagałoby jawnego zawężenia celu. Nie należy utożsamiać komunikatu programu z pełną oceną gotowości merytorycznej.

Przygotowanie dokumentów i bazy wiedzy
ENHANCER+ · Politechnika Warszawska · materiał do samodzielnej nauki offline