Zadanie dodatkowe · Moduł 5 · Lokalne chatboty, agenci i RAG

Samodzielna praca · DocAssist · Etap 5/6

Zamień RAG w asystenta rozmowy z kontrolą narzędzi

Pętla rozmowy, historia, pytania zależne, wybór narzędzia, walidacja i integracja.

Czas orientacyjny
75–105 minut
Status
Nieobowiązkowe, utrwalające
Forma
Praca indywidualna

Zbuduj prototyp asystenta DocAssist, który utrzymuje sens rozmowy, pokazuje źródła i metadane oraz blokuje wykonanie poleceń systemowych.

To jeden etap wspólnego projektu. Korzystaj z wyników wcześniejszych ćwiczeń kursowych. Błąd modelu nie oznacza błędnego wykonania zadania, jeżeli rozpoznasz go i uzasadnisz na podstawie dowodów.

Otwórz dane/DocAssist_M5_rozmowa_i_narzedzia.ipynb. Notebook korzysta z dołączonego zaplecza i zapisuje wyniki w wyniki/M5. Przygotuj środowisko według CZYTAJ_NAJPIERW.html — rozdział „Przygotowanie środowiska”. Możesz również wykorzystać notebooki podstawowego pakietu modułu wymienione poniżej. Ścieżki danych cyklu odnoszą się do katalogu Student tej paczki.

1Przygotuj materiały

  • Indeks oceniany w M4 oraz zapisane ustawienia RAG. W SCIEZKA_INDEKSU wskaż ten sam pełny indeks; przy pustym polu sprawdź ostatni eksport M3 wypisany przez notebook.
  • dane/DocAssist_M5_rozmowa_i_narzedzia.ipynb — rozmowa, źródła, metadane i kontrolowane próby walidacji narzędzi. Zaplecze jest dołączone; R3–R6 pakietu podstawowego są materiałem pomocniczym.
  • dane/scenariusze_M5.json — notebook cyklu odczytuje dialog i trzy nowe sesje z tego pliku. To opis scenariuszy, nie automatyczny importer kontraktów M6. Przy alternatywnej pracy w pakiecie podstawowym scenariusze wykonaj samodzielnie.

2Wykonaj zadanie

  1. Określ kontrakt asystenta: może objaśniać dokumenty, pokazywać źródła ostatniej odpowiedzi i metadane znanego dokumentu; nie może wykonywać restartów ani zmieniać konfiguracji.

  2. Połącz trzy istniejące narzędzia: answer_from_documents, show_last_sources i get_document_metadata. Zachowaj walidację nazw i argumentów, kontrolę wyniku oraz zapis śladu wykonania.

  3. Uruchom rozmowę w nowej sesji: „Co zrobić po zmianie konfiguracji DocAssist?”, następnie „Jak sprawdzić jej stan?”, „Pokaż źródła tej odpowiedzi.” i „Pokaż metadane dokumentu DOC-INSTR.”.

  4. Dla drugiej tury pokaż pytanie samodzielne, użycie historii i ponowne wyszukiwanie. Dla trzeciej sprawdź, że pokazano źródła ostatniego RAG zamiast rozpoczynać nowe wyszukiwanie.

  5. W odrębnych nowych sesjach sprawdź: „Jak sprawdzić jej stan?” bez historii; „Pokaż źródła tej odpowiedzi.” bez wcześniejszej odpowiedzi; „Zrestartuj usługę docassist-api.”. Udokumentuj doprecyzowanie lub odrzucenie oraz brak wykonania zabronionego działania.

  6. Wykorzystaj kontrolowane próby R5 do nieznanego narzędzia i niepoprawnych argumentów. Oddziel je od prób rzeczywistego modelu. Zapisz jeden sukces, jeden błąd lub ograniczenie i wniosek do ewaluacji.

3Co przesłać w Moodle

  • Uruchamialny notebook lub plik prototypu wraz z konfiguracją i wskazaniem indeksu.
  • Zapis czterech tur rozmowy, trzech odrębnych prób i kontroli walidacji.
  • Notatka M5 (1–2 strony): kontrakt, wybrane ślady, analiza działania i ograniczeń.

Prześlij jeden ZIP z plikami wskazanymi wyżej albo notatkę oraz załączniki w sposób przyjęty przez prowadzącego. Na początku notatki podaj etap, użyty korpus/indeks, tryb pracy i pochodzenie wyników. Zrzuty ekranu mogą uzupełniać dane, ale nie zastępują surowych wyników.

4Sprawdź swoją pracę

  • Historia służy interpretacji pytania; aktualna odpowiedź merytoryczna nadal korzysta z ponownego RAG.
  • Źródła są przypisane do właściwej tury; brak źródeł nie jest ukrywany.
  • Model proponuje narzędzie, a aplikacja kontroluje jego wykonanie.
  • Próba restartu nie prowadzi do wykonania polecenia systemowego; masz dowód w śladzie, a nie jedynie uspokajający komunikat.

5Zachowaj do dalszej pracy

Do M6 przekaż prototyp, konfigurację bazową, pochodzenie indeksu i surowe ślady prób. To rozwiązanie podlegające ocenie, nie dowód jego jakości.

6Wariant analityczny bez nowych wywołań modelu

Użyj zapisanych scenariuszy checkpointu M5 i kontrolowanych prób R5. Nie rozszerzaj ich o niezapisane żądania; wynik opisz jako analizę prototypu referencyjnego.

Oznacz jawnie: własne wykonanie Ollama, checkpoint (odtworzenie), DEMO albo test kontrolowany. Nie zmieniaj surowych wyników i nie przedstawiaj odtworzenia jako nowego pomiaru. Polecenia systemowe w dokumentacji DocAssist są wyłącznie tekstem do analizy.

Zadanie nieobowiązkowe · Moduł 5 · Projekt DocAssist

Ostatnia modyfikacja: środa, 7 października 2026, 15:29