11. Źródła ćwiczeń i mapa pakietu

ENHANCER+ · Moduł 6 · Ewaluacja RAG · Rozdział

Poniższe teksty są kopią dziesięciu fragmentów z aktualnego chunks.jsonl pakietu Studenta M6. Pozwalają rozwiązywać zadania analityczne bez otwierania prezentacji. Nie zastępują całego katalogu indeksu potrzebnego do uruchamiania kodu. Oceniając własną zmienioną bazę, użyj jej faktycznej wersji zamiast tej kopii.

DOC-INSTR · Ponowne uruchomienie usługi

DOC-INSTR-dd6055d675-0002
Źródło: instrukcja.txt · wersja: 1.4

## Ponowne uruchomienie usługi Po zmianie pliku /etc/docassist/config.yaml wykonaj kolejno: 1. Uruchom ponownie usługę: sudo systemctl restart docassist-api 2. Sprawdź stan: systemctl is-active docassist-api Prawidłowy wynik: active. Uwaga: wykonaj ponowne uruchomienie tylko po zmianie konfiguracji.

DOC-INSTR · Kopia konfiguracji

DOC-INSTR-dd6055d675-0003
Źródło: instrukcja.txt · wersja: 1.4

## Kopia konfiguracji Przed edycją zachowaj kopię pliku konfiguracyjnego w katalogu kopii. Nie zapisuj w zgłoszeniu haseł ani kluczy. W razie nieudanego uruchomienia przywróć zatwierdzoną kopię i zgłoś problem administratorowi.

DOC-REG · Dyżur operatora

DOC-REG-6a742ef524-0002
Źródło: regulamin.md · wersja: 1.4

## Dyżur operatora Operator przyjmuje zgłoszenia w dni robocze od 08:00 do 16:00. Poza tymi godzinami zgłoszenie czeka do następnego dyżuru. Wyjątek: awarię uniemożliwiającą pracę całego zespołu zgłoś dyżurnemu administratorowi zgodnie z wewnętrzną procedurą eskalacji.

DOC-REG · Treść zgłoszenia

DOC-REG-6a742ef524-0003
Źródło: regulamin.md · wersja: 1.4

## Treść zgłoszenia Podaj wersję systemu, czas zdarzenia, komunikat błędu i wykonane kroki. Nie dołączaj danych osobowych ani sekretów. Opisz oczekiwany wynik. Nie podajemy w tym regulaminie gwarantowanego czasu rozwiązania zgłoszenia.

DOC-PDF · Parametry stanowiska

DOC-PDF-51aa0fc583-0002
Źródło: docassist.pdf · wersja: 1.4

## Parametry stanowiska Dla tej fikcyjnej aplikacji przyjęto 8 GB RAM i 2 GB wolnego miejsca. Są to dane ćwiczenia, a nie wymagania modeli językowych. Przed instalacją sprawdź dostęp do zatwierdzonego pakietu.

DOC-PDF · Test po zmianie konfiguracji

DOC-PDF-51aa0fc583-0003
Źródło: docassist.pdf · wersja: 1.4

## Test po zmianie konfiguracji Po zmianie konfiguracji sprawdź uruchomienie usługi i zapisz wynik. Nie usuwaj łącznika w nazwie docassist-api.

DOC-PDF · Parametr oczekiwania

DOC-PDF-7bf28bc22b-0005
Źródło: docassist.pdf · wersja: 1.4

## Parametr oczekiwania Parametr: timeout_seconds. Wartość zalecana w tym przykładzie: 30 s. Zwiększ wartość dopiero po ustaleniu, że operacja trwa dłużej. Nie traktuj tego parametru jako gwarancji czasu odpowiedzi.

DOC-PDF · Zapis wyniku testu

DOC-PDF-7bf28bc22b-0006
Źródło: docassist.pdf · wersja: 1.4

## Zapis wyniku testu Zapisz datę próby, wersję dokumentu i komunikat diagnostyczny. Prawidłowy odczyt powinien zachować jednostkę s i wartość 30.

DOC-HELP · Błąd połączenia

DOC-HELP-cc64f35642-0002
Źródło: pomoc.html · wersja: 1.4

## Błąd połączenia Gdy aplikacja zgłasza brak połączenia, sprawdź stan usługi i adres w konfiguracji. Jeżeli usługa działa, zapisz dokładny komunikat i przekaż go administratorowi. Nie zmieniaj uprawnień plików bez ustalenia przyczyny.

DOC-HELP · Kontrola znaków

DOC-HELP-cc64f35642-0003
Źródło: pomoc.html · wersja: 1.4

## Kontrola znaków Tekst kontrolny: Zażółć gęślą jaźń. Zachowaj nazwy docassist-api i --no-pager oraz jednostki: 25°C, ±5%, ≤10 ms.

Gdzie są potrzebne funkcje

ModułRola i najważniejsze funkcje
m3_toolsload_index, search_local_index, normalize_search_results: indeks, podobieństwo, stabilny format wyników
m4_toolsretrieve, filter_results_for_context, prepare_context_results, build_context, answer_from_results, ask_rag: ścieżka RAG
m5_toolscreate_initial_state, resolve_followup_question, assistant_step oraz narzędzia: rozmowa i kontrola wykonania
m6_toolsconfigure, walidator kontraktów, import_m5, review_template, save_review, join_reviews: referencyjne wsparcie ewaluacji
moj_m6Twoje trzynaście funkcji oraz dostarczone pętle run_retrieval i run_assistant
sprawdz_moj_m6check_stage: kontrola zachowania kolejnych etapów bez nowych wywołań modelu

Własny warsztat korzysta z dokładnie tego samego korpusu, konfiguracji i checkpointów co pakiet. Gdy aktualizujesz pakiet, porównaj jego manifest z manifestem książki i ponów testy warsztatu. Sama zgodna nazwa pliku nie potwierdza zgodności implementacji.

Podstawa opracowania

Książka odpowiada zakresowi M12-M6-v6 oraz kartom i notebookom pakietu M6. Zachowuje dydaktyczny sposób prowadzenia czytelnika z książki M1: objaśnienie, przykład, ćwiczenie i samokontrola. Długość i podział zostały dopasowane do ewaluacji i dokumentacji, a nie do liczby stron M1.

Przykłady historyczne pochodzą z pełnego R6 M5, którego plik źródłowy i suma kontrolna znajdują się w dane/import_M5. Przykład T004 pochodzi z odtworzenia indeksu pakietowego. Kontrolowane przykłady A/B i oceny 2,1,2 są ilustracjami działania miary lub reguły, nie wynikami nowego wywołania LLM.

Do czytania nie są potrzebne strony zewnętrzne. Instrukcja publikacji dołączona osobno do paczki odwołuje się do oficjalnej dokumentacji Moodle i kodu importera. Ustawienia techniczne publikacji nie zmieniają kontraktów ćwiczeń.

Lokalne chatboty, agenci i systemy RAG z własną bazą wiedzy · Moduł 6 · Wydanie 29.09.2026