Wstęp do ćwiczeń DocAssist — instrukcja uczestnika
3. Paczka do pracy i właściwe źródła
Paczka do pracy i właściwe źródła
Wstęp do ćwiczeń DocAssist · Instrukcja uczestnika
Pobierz z kursu plik DocAssist_dane_i_notebooki.zip i rozpakuj go do własnego katalogu. Otrzymasz folder Student. Zachowaj jego strukturę i pracuj na rozpakowanych plikach. Wszystkie ścieżki w tej instrukcji i w zadaniach odnoszą się do tego folderu.
Student/
CZYTAJ_NAJPIERW.html — pełna instrukcja cyklu
dane/ — dokumenty, pytania, scenariusze i 6 notebooków
M1/ — dokumenty wprowadzające
M2_zrodla/ — źródła aktualne i jeden plik archiwalny
M6/ — kontrakty testów i rubryki
notebook_support/ — kod, konfiguracje, dane referencyjne, checkpointy
notebook_utils.py — funkcje obsługujące notebooki cyklu
requirements_notebooki.txt
szablony/ — pomocniczy plan testów
wyniki/ — powstaje po rozpoczęciu własnych prób
Paczka zawiera zaplecze potrzebne notebookom dodatkowym. Podręczniki, prezentacje oraz podstawowe pakiety Student M1–M6 z kursu służą do nauki i powtórek. Ich notebooki możesz wykorzystać zamiast notebooków cyklu, jeśli samodzielnie dostosujesz je do pełnego polecenia; nie są dodatkowym obowiązkiem w głównej ścieżce pracy.
Dwie wersje dokumentacji
- M1: używaj wyłącznie
dane/M1/instrukcja.txtidane/M1/regulamin.md. To punkt wyjścia do porównania odpowiedzi z kontekstem i bez niego. - Od M2: pracuj na pięciu plikach
dane/M2_zrodla:instrukcja.txt,regulamin.md,regulamin_v1_3.md,pomoc.htmlorazdocassist.pdf. Regulamin 1.3 jest archiwalny; pozostaje w inwentarzu, ale nie należy do korpusu bieżących odpowiedzi. - Zachowaj identyfikatory dokumentów z inwentarza, szczególnie
DOC-INSTR. Własne identyfikatory fragmentów muszą być unikalne i zgodne z późniejszym kluczem trafności oraz kontraktami testów.
Opis DA-01 z dane/opis_przypadku.txt przedstawia potrzebę użytkownika. Nie normuje procedur i nie trafia do indeksu. Zmiana dokumentacji między M1 i M2 jest celowa; różnic wyników nie przypisuj wyłącznie promptowi.
Pytania, scenariusze i ocena
dane/pytania_M3.json— 12 pytań do wyszukiwania; zadanie M3 wskazuje sześć wybranych.dane/pytania_M4_M5.json— pytania P01–P06 do odpowiedzi RAG.dane/scenariusze_M5.json— dialog czteroturowy oraz trzy próby w nowych sesjach.dane/zakres_M6.json— wybór 12 rekordów do końcowej oceny.dane/M6/test_cases_wzorzec.jsonl,rubryki.jsonislowniki.json— pełne kontrakty i zasady oceny M6. Listy zakresów checkpointów opisują dostępność; same zapisane wywołania są wnotebook_support.szablony/plan_testow_szablon.json— pomocniczy plan do uzupełnienia przed M1; nie zastępuje kontraktów walidatora M6.
Nie indeksuj całego folderu dane. Do indeksu wprowadzaj tylko zaakceptowane fragmenty aktualnej dokumentacji. Notebooki, kod, instrukcje, pytania, kontrakty, checkpointy oraz dokumenty M1 są materiałami pracy. Pochodzenie kopii dokumentuje dane/manifest_pochodzenia.json.
DocAssist · Instrukcja uczestnika · Wersja z 6 października 2026