Budowa asystenta dokumentów

7. Rozmowa z asystentem w konsoli

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

Orientacyjny czas: 25 min · Tryb pracy: najpierw własna próba, potem przykład

W konsola.py uzupełnij pokaz(result, debug=False), aby wyświetlić wynik w czytelny sposób. Reszta konsoli jest gotowa: odczytuje indeks, tworzy stan, przyjmuje komendy i zapisuje wyniki. Oddziel wygląd komunikatu od logiki krok — zmiana sposobu wyświetlania nie powinna zmieniać odpowiedzi ani pamięci.

Wyświetl status i answer.
Jeśli są źródła, pokaż ich opis, chyba że answer jest już listą źródeł.
Wyświetl numer tury pochodzenia źródeł. Nie zakładaj, że zawsze jest to bieżąca tura.
Pokaż ostrzeżenia, a w trybie debug również pełne pytanie, decyzję i powód wyniku.
Uruchom wariant regułowy, przejdź poniższą rozmowę, a następnie uruchom oddzielną sesję z selektorem modelowym.

python konsola.py --wybor reguly
# Po zakończeniu pierwszej sesji:
python konsola.py --wybor model

/debug
Jak sprawdzić stan usługi docassist-api?
Jak sprawdzić jej stan?
Pokaż źródła
Pokaż metadane DOC-INSTR
Pokaż źródła
/clear
Jak sprawdzić jej stan?
/exit

Po /clear pytanie z „jej” powinno wymagać doprecyzowania. Pamięć jest przechowywana tylko w działającym procesie; ponowne uruchomienie programu nie odtwarza automatycznie poprzedniej rozmowy. Pliki wyników służą do analizy, nie do automatycznego zasilania historii.

Komenda	Działanie
/exit	Kończy program.
/clear	Nowe conversation_id, pusta historia i źródła; wcześniejsze pliki pozostają.
/history	Pokazuje aktualne krótkie okno pamięci.
/sources	Przekazuje do funkcji krok wiadomość „Pokaż źródła”.
/documents	Pokazuje katalog znanych dokumentów lokalnie, poza turą modelu.
/debug	Włącza lub wyłącza podgląd decyzji.

Zapisy sesji: folder wyniki zawiera pytania, odpowiedzi, fragmenty kontekstu i surowe komunikaty modelu. Używaj danych ćwiczeniowych; przed udostępnieniem raportu sprawdź jego zawartość. /clear czyści pamięć procesu, a nie wcześniejsze pliki.

Sprawdź przed przejściem dalej

Potrafię powiązać źródła z numerem wcześniejszej tury.
Widzę różnicę między poleceniami konsoli a narzędziami selektora.
Po /clear asystent nie korzysta z poprzedniej historii.

Materiał uzupełniający do modułów 1–6 · wersja 1.0 · 30.09.2026