Sześć etapów i ich rezultaty

Wstęp do ćwiczeń DocAssist · Instrukcja uczestnika

Po materiałach merytorycznych i teście samokontroli danego modułu wykonaj odpowiadające mu zadanie DocAssist. Pracuj indywidualnie, w kolejności M1 → M2 → M3 → M4 → M5 → M6. Cykl jest nieobowiązkowym rozszerzeniem ćwiczeń podstawowych.

Orientacyjny czas całego cyklu wynosi 6,5–9 godzin przy przygotowanym środowisku. Instalacja, odtworzenie brakujących etapów i poprawki mogą wymagać dodatkowego czasu.

Na początku przeczytaj opis DA-01 i polecenie M1, wybierz ścieżkę praktyczną albo analityczną, a następnie zapisz plan testów przed pierwszym porównaniem. Możesz dołączyć później, korzystając z materiału referencyjnego: oznacz miejsce przejścia i jego pochodzenie. Dalsze wnioski odnoszą się wtedy do tej referencji.

Etap i zadanie	Co robisz	Rezultat i wejście do kolejnego etapu
M1 — Czy model zna naszą dokumentację?	Określasz zakres asystenta, wybierasz pytania i porównujesz odpowiedzi bez dokumentu oraz z ręcznie przekazanym kontekstem. Sprawdzasz granice wiedzy i podstawy twierdzeń.	Notatka projektowa, lista pytań, prompty, surowe odpowiedzi i wnioski. Zakres i pytania przechodzą do M2. Dokumenty M1 pozostają historycznym punktem odniesienia poza późniejszym indeksem.
M2 — Przygotuj aktualną bazę wiedzy DocAssist	Inwentaryzujesz aktualne źródła, odczytujesz TXT/MD/PDF/HTML, oczyszczasz treść, dzielisz ją na fragmenty i sprawdzasz metadane oraz jakość.	Zaakceptowany `knowledge_base_ready.jsonl`, opis pochodzenia i ograniczeń. To wejście do budowy indeksu w M3.
M3 — Znajdź właściwy fragment, także dla parafrazy	Tworzysz embeddingi i indeks. Przed oceną rankingów ustalasz własny klucz trafności; sprawdzasz wyszukiwanie i jego metryki.	Kompletny `semantic_index`, klucz trafności, rankingi, metryki i hipoteza poprawy. Cały indeks przechodzi do M4.
M4 — Odpowiedz na zgłoszenie wyłącznie na podstawie źródeł	Łączysz indeks z lokalnym modelem, budujesz kontekst i prompt. Oceniasz odpowiedzi, kompletność, źródła oraz zachowanie przy braku informacji.	Działający RAG, pełny indeks, konfiguracja oraz zapisy wywołań: ranking, rzeczywisty kontekst, prompt, odpowiedź, status i źródła. To podstawa M5.
M5 — Zamień RAG w asystenta rozmowy z kontrolą narzędzi	Dodajesz historię rozmowy, obsługę pytań zależnych, pokazywanie źródeł i metadanych oraz walidację narzędzi. Sprawdzasz doprecyzowania i blokadę niedozwolonych działań.	Prototyp, konfiguracja bazowa, pochodzenie indeksu i surowe ślady prób. Przekazujesz je do oceny w M6; samo uruchomienie nie potwierdza jakości.
M6 — Sprawdź jakość, popraw jeden element i przygotuj odbiór projektu	Zatwierdzasz kontrakty testów, oceniasz poszczególne warstwy, analizujesz błędy i porównujesz jedną zmianę z wersją bazową. Sprawdzasz regresję i odtwarzalność.	Końcowy pakiet projektu lub raport analityczny: wyniki, oceny, porównanie zmiany, instrukcja odtworzenia i dokumentacja demonstracji.

Pełne polecenia, wymagane pliki i kryteria samooceny znajdziesz w sześciu zadaniach udostępnionych w kursie. Mapa pokazuje ich wspólny sens i zależności.

Przed każdym etapem przeczytaj pełne polecenie zadania w Moodle. Ta instrukcja wyjaśnia wspólny sposób pracy; w zadaniu znajdziesz wymagane rezultaty, zakres prób i kryteria samooceny. Nie musisz ponownie wykonywać wszystkich kart podstawowego modułu.

DocAssist · Instrukcja uczestnika · Wersja z 6 października 2026