Wstęp do ćwiczeń DocAssist — instrukcja uczestnika

3. Paczka do pracy i właściwe źródła

Projekt DocAssist · Moduły 1–6 · Dla uczestnika kursu
Cykl sześciu zadań

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.txt i dane/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.html oraz docassist.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.json i slowniki.json — pełne kontrakty i zasady oceny M6. Listy zakresów checkpointów opisują dostępność; same zapisane wywołania są w notebook_support.
  • szablony/plan_testow_szablon.json — pomocniczy plan do uzupełnienia przed M1; nie zastępuje kontraktów walidatora M6.
i

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