Cel i droga projektu DocAssist

Wstęp do ćwiczeń DocAssist · Instrukcja uczestnika

W tym cyklu zastosujesz umiejętności z kolejnych modułów do jednego projektu: asystenta, który pomaga korzystać z dokumentacji DocAssist. Zaczniesz od pytań i granic wiedzy modelu, przygotujesz dokumenty oraz wyszukiwanie, połączysz je z odpowiedziami i rozmową, a na końcu sprawdzisz jakość rozwiązania. Wyniki wcześniejszych etapów stają się wejściem do następnych.

Sam płynnie napisany tekst nie wystarcza, aby uznać odpowiedź za poprawną. Asystent powinien odnaleźć właściwe informacje, zachować warunki opisanych procedur, wskazać źródła i jasno powiedzieć, kiedy dokumentacja nie daje odpowiedzi. Nauczysz się sprawdzać każdy z tych elementów na podstawie zapisanych wyników.

Wspólny przypadek DA-01

Po zmianie konfiguracji fikcyjnego DocAssist we wtorek o 18:20 aplikacja zgłasza brak połączenia, a awaria uniemożliwia pracę całego zespołu. Użytkownik potrzebuje wskazówek sprawdzenia stanu, postępowania po nieudanym uruchomieniu, eskalacji poza dyżurem i przygotowania zgłoszenia. Zadaje pytania uzupełniające, prosi o źródła i metadane, a następnie żąda wykonania restartu.

Opis przypadku określa potrzebę użytkownika. Odpowiedzi o procedurach musisz oprzeć na dokumentach. Sam opis DA-01 nie jest źródłem procedur i nie trafia do indeksu wiedzy.

Ścieżka praktyczna

Rezultatem jest lokalny prototyp asystenta dokumentacji z własną bazą wiedzy: wyszukuje fragmenty, odpowiada ze źródłami, obsługuje krótką rozmowę, pokazuje metadane i blokuje niedozwolone wykonania.

Do prototypu dołączysz ocenę jakości, porównanie jednej poprawy z wersją bazową oraz instrukcję odtworzenia.

Ścieżka analityczna

Pracujesz na dostępnych wynikach DEMO, checkpointach i testach kontrolowanych. Rezultatem jest udokumentowana ocena prototypu referencyjnego wraz z ograniczeniami dostępnych dowodów.

Zapisujesz, które próby odtworzono, które przeanalizowano, a których nie wykonano.

DocAssist korzysta z RAG: przed wygenerowaniem odpowiedzi wyszukuje fragmenty dokumentacji i przekazuje je modelowi jako kontekst. Cały przepływ projektu wygląda tak:

dokumenty → fragmenty → embeddingi → indeks → wyszukiwanie → kontekst → prompt → odpowiedź → źródła → ocena

Dokumenty są porządkowane i dzielone na fragmenty z metadanymi. Embeddingi przedstawiają ich znaczenie w postaci wektorów, a indeks umożliwia wyszukiwanie. Wybrane fragmenty tworzą kontekst promptu. Następnie oceniasz odpowiedź i sprawdzasz, czy wskazane źródła rzeczywiście potwierdzają jej twierdzenia.

Logika pracy przez cały cykl

Plan testów
Określ odbiorcę, zakres pomocy i granice działania. Ustal, czego będziesz wymagać od rozwiązania i jaki dowód pozwoli ocenić wynik. Szczegółowe kontrakty M6 zatwierdź przed końcowym pomiarem.
Zestaw pytań
Zapisz pytania związane z DA-01. Uwzględnij pytania bezpośrednie, parafrazy, pytania zależne od historii oraz sytuacje, w których informacji brakuje. Oczekiwania ustalaj na podstawie właściwej wersji dokumentów.
Retrieval i kontekst
Sprawdź, co wyszukiwarka odnalazła i jakie fragmenty rzeczywiście trafiły do modelu. Ranking top-k oraz końcowy kontekst mogą się różnić; zachowaj oba zapisy.
Odpowiedzi, źródła i zachowanie
Oceń zgodność i kompletność odpowiedzi, potwierdzenie twierdzeń w źródłach, obsługę rozmowy, komunikaty o braku danych oraz kontrolę narzędzi.
Analiza błędów i konfiguracji
Znajdź pierwszy etap, na którym wynik przestaje spełniać oczekiwania. Sprawdź jedną zmianę konfiguracji, porównaj ją z wersją bazową i oceń, czy nie pogorszyła innych przypadków.
Dokumentacja i demonstracja
Zbierz pliki, konfigurację, surowe wyniki, oceny i instrukcję odtworzenia. Pokaż działanie rozwiązania oraz jego ograniczenia i uzasadnij, czy jest gotowe do demonstracji.

Ta logika prowadzi przez cały projekt. Poszczególne moduły dostarczają kolejnych elementów rozwiązania; pełna ocena i porównanie poprawy następują w M6.

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