Wstęp do ćwiczeń DocAssist — instrukcja uczestnika
2. Sześć etapów i ich rezultaty
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