Wstęp do ćwiczeń DocAssist — instrukcja uczestnika

5. Praca w notebookach

Projekt DocAssist · Moduły 1–6 · Dla uczestnika kursu

Cykl sześciu zadań

Praca w notebookach

Wstęp do ćwiczeń DocAssist · Instrukcja uczestnika

W JupyterLab otwórz plik w katalogu dane i wybierz kernel DocAssist - cykl zadan albo przygotowany kernel Python z tymi bibliotekami. Dla każdego notebooka używaj osobnego kernela. Wykonuj komórki od góry przez Shift+Enter, uzupełniając wskazane pola i formularze.

Moduł i notebook	Wejście	Zapisane rezultaty
M1 `DocAssist_M1_porownanie_AB.ipynb`	Dokumenty M1 i własny plan porównania.	Trzy pary A/B: sześć surowych odpowiedzi, sześć pełnych promptów, konfiguracja, formularz ocen i notatka.
M2 `DocAssist_M2_przygotowanie_bazy.ipynb`	Pięć plików M2_zrodla; inwentarz do własnej oceny.	Surowy odczyt czterech formatów, czyszczenie, fragmenty, metadane, audyt i zatwierdzony knowledge_base_ready.jsonl.
M3 `DocAssist_M3_indeks_i_retrieval.ipynb`	Własna zaakceptowana baza M2 albo jawnie wybrana referencja checkpoint.	Embeddingi, kompletny semantic_index, sześć rankingów, Hit@1/3/5 z licznikiem i mianownikiem oraz kontrola odczytu po restarcie.
M4 `DocAssist_M4_odpowiedzi_RAG.ipynb`	Własny indeks M3 albo indeks referencyjny; sześć pytań P01–P06.	Pełny ślad RAG, surowe odpowiedzi, formularz ocen i dwa ręcznie wybrane warianty kontekstu P03.
M5 `DocAssist_M5_rozmowa_i_narzedzia.ipynb`	Własny indeks M3 albo indeks referencyjny; scenariusze M5.	Cztery tury rozmowy, trzy nowe sesje, ślady, kontrakt, formularz ocen i oddzielne kontrolowane próby R5.
M6 `DocAssist_M6_ocena_i_dokumentacja.ipynb`	Oceniany indeks, pełne kontrakty dopasowane przez uczestnika i plan oceny.	Walidacja, wybrany zakres, surowe próby, recenzje, Hit i pokrycie, diagnoza, jedna zmiana top_k, regresja i szablon raportu końcowego.

Pliki z dopiskiem draft, plany, oceny i notatki zawierają pola do samodzielnego uzupełnienia. Otwórz je w JupyterLab, wpisz własne oceny, zapisz plik, a potem wykonaj kolejną komórkę notebooka. Blokady przed pomiarem chronią kolejność: najpierw oczekiwania i plan, potem wynik i ocena.

Surowych odpowiedzi nie poprawiaj. Błąd wykonania i brak danych pozostają widoczne. Przy ponownym wykonaniu pomiaru rozpocznij nową próbę komórką przygotowania; nie nadpisuj wcześniejszych rezultatów. W M3 instrukcja wskazuje samodzielną komórkę kontroli indeksu po restarcie kernela.

Notebook wspiera wykonanie, uczestnik ocenia

Notebooki zapisują dane i przygotowują formularze. Samodzielnie ustalasz oczekiwania, wybierasz właściwe fragmenty, akceptujesz bazę, przypisujesz twierdzenia do źródeł, oceniasz błędy i formułujesz wnioski. Pozostawienie pól UZUPEŁNIJ nie oznacza ukończenia zadania.

Komórka przygotowania tworzy nowy folder próby. Po jej ponownym wykonaniu kolejne komórki odnoszą się do nowej próby: nie mieszaj plików z różnych uruchomień. Samo Run All bez uzupełnienia wymaganych decyzji nie stanowi poprawnego wykonania.

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