Budowa asystenta dokumentów

1. Zanim zaczniesz

1.1. Kontrakt asystenta i plan pracy

Lokalne chatboty, agenci i systemy RAG z własną bazą wiedzy

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

Chatbot opisuje sposób rozmowy z użytkownikiem. Asystent ma dodatkowo określoną rolę, stan i dopuszczalne działania. Wariant, w którym model proponuje narzędzie, zawiera prosty element agentowy. Nie budujemy pętli autonomicznego planowania wielu działań: każda wiadomość kończy się najwyżej jedną próbą narzędzia.

Element	Ustalenie projektu
Rola	Pomoc w czytaniu dokumentacji DocAssist; bez wykonywania operacji administracyjnych.
Pamięć	Do trzech ostatnich poprawnych wiadomości użytkownika wraz z wynikiem; osobno źródła ostatniego wykonanego RAG.
Narzędzia	answer_from_documents, show_last_sources, get_document_metadata.
Wybór działania	Najpierw jawne reguły; potem propozycja JSON od modelu i te same kontrole aplikacji.
Granice	Brak powłoki, zapisu dokumentów, dostępu do sieci przez narzędzia i automatycznych ponowień.
Dowód	Identyfikator wyniku, pochodzenie źródeł, surowa odpowiedź modelu i konfiguracja sesji w plikach JSON.

Prześledź jedną turę

wiadomość → walidacja → doprecyzowanie odniesienia
          → wybór działania → sprawdzenie nazwy i argumentów
          → najwyżej jedna próba narzędzia → wynik → aktualizacja pamięci

Źródła przechowujemy niezależnie od historii. Pokazanie metadanych nie może sprawić, że poprzednie źródła zaczną wyglądać jak źródła nowej odpowiedzi RAG. Po błędzie nowego, wykonanego RAG usuwamy stare źródła, aby nie przypisać ich do nieudanej odpowiedzi.

Granica uproszczenia: pamięć w tej instrukcji pomaga rozwinąć dwa wybrane wzorce pytań o usługę DocAssist. Nie jest ogólnym mechanizmem rozumienia wszystkich zaimków. Jeśli odniesienie jest niejednoznaczne, program prosi o pełne pytanie.

Zapisz własnymi słowami rolę asystenta.
Wypisz trzy dozwolone działania i po jednym przykładzie działania niedozwolonego.
Zdecyduj, jak rozpoznasz, że źródła należą do konkretnej wcześniejszej tury.

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