Budowa asystenta dokumentów
1. Zanim zaczniesz
Lokalne chatboty, agenci i systemy RAG z własną bazą wiedzy
Praktyka po kursie · bez GUI
Asystent dokumentów w konsoli
Od działającego RAG do rozmowy i kontrolowanych narzędzi
W tym projekcie zbudujesz lokalnego asystenta, który odpowiada na pytania na podstawie dokumentów, rozumie wybrane dopowiedzenia w rozmowie i korzysta z trzech narzędzi tylko do odczytu. Całość uruchomisz w konsoli. Punktem wyjścia jest prosty RAG poznany w poradniku chatbota; potrzebny kod bazowy znajduje się również w tym pakiecie.
Najpierw spróbuj sam. Przeczytaj zadanie i kontrakt funkcji, uzupełnij pliki w katalogu Start, a dopiero po własnej próbie zajrzyj do podrozdziału z kodem lub katalogu Rozwiazanie. Nie musisz przepisywać gotowego zaplecza RAG. Twoim zadaniem jest dobudowanie warstwy asystenta.
Co będzie gotowe na końcu
| Możliwość | Przykład |
|---|---|
| Nowe pytanie do dokumentów | Jak sprawdzić stan usługi docassist-api? |
| Dopowiedzenie z historii | Jak sprawdzić jej stan? — po jednoznacznym pytaniu o usługę |
| Źródła wcześniejszej odpowiedzi | Pokaż źródła |
| Metadane znanego dokumentu | Pokaż metadane DOC-INSTR |
| Doprecyzowanie lub odmowa | Brak ID, niejasne „jej”, prośba o wykonanie restartu |
DocAssist to przykład dydaktyczny zaczerpnięty z materiałów kursu. Występujące w dokumentach polecenia administracyjne są treścią do objaśnienia. Nie wykonuj ich na swoim komputerze tylko dlatego, że znalazły się w odpowiedzi asystenta.
Czas i wymagania
Zaplanuj około 6–8 godzin pracy z własnymi próbami, porównaniem kodu i oceną wyników. Podane czasy części sumują się do około 7 godzin; tempo zależy od doświadczenia w Pythonie. Instalacja środowiska i pobieranie modeli mogą wydłużyć pracę. Samo uruchomienie gotowego rozwiązania zajmie zwykle 30–60 minut przy przygotowanym środowisku.
Potrzebujesz umiejętności uruchamiania skryptów, czytania JSON i podstaw funkcji oraz słowników Pythona. Wracaj do modułów 1–4, jeśli problem dotyczy lokalnego modelu, fragmentów dokumentów, indeksu lub odpowiedzi RAG. Moduł 5 wyjaśnia pamięć i narzędzia, a moduł 6 — ocenę i diagnozę.
Sprawdź przed przejściem dalej
- Wiem, że buduję program konsolowy bez GUI.
- Mam czas na samodzielne uzupełnienie kodu i ocenę odpowiedzi.
- Rozróżniam uruchomienie programu od potwierdzenia jakości jego odpowiedzi.
Materiał uzupełniający do modułów 1–6 · wersja 1.0 · 30.09.2026