Budowa asystenta dokumentów: Gdy coś nie działa

9. Przeniesienie na własne dokumenty

9.1. Gdy coś nie działa

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

Objaw	Sprawdź i zrób
Brak połączenia z Ollama	Uruchom lokalną usługę, sprawdź port 11434 i python lokalny.py.
Brak modelu	Porównaj pełną nazwę z config.json z ollama list. Nie zmieniaj modelu embeddingowego bez nowej budowy indeksu.
index.json już istnieje	Zachowaj istniejący plik pod inną nazwą. Nie nadpisuj dowodu poprzedniej konfiguracji.
Niezgodność skrótu danych lub modelu	Sprawdź, co zmieniono. Zbuduj nowy indeks dla aktualnej pary: fragmenty i model.
NotImplementedError	Pracujesz w Start i pozostało nieuzupełnione zadanie. Uzupełnij funkcję z odpowiedniego rozdziału.
Brak rozpoznania „jej”	Sprawdź historię i obsługiwane wzorce. Podaj pełne pytanie; nie dopisuj faktów na siłę.
Niepoprawna propozycja modelu	Otwórz selection_trace: response, parse_error i done_reason. Zapisz błąd, popraw opis lub limit, uruchom nowy test.
Odpowiedź urwana	Sprawdź raw_response.done_reason i ostrzeżenia RAG. Po zmianie num_predict ponów cały porównywany test.
Źródło jest na liście, lecz odpowiedź błędna	Porównaj treść fragmentu, prompt i konkretne zdanie. Obecność źródła nie wystarcza.
Dobra odpowiedź bez cytowania	Zbadaj citation_check i ręcznie potwierdź oparcie. Popraw generację lub sposób prezentacji, nie dopisuj cytowań bez dowodu.
Pokaż źródła pokazuje starszą turę	Po odczycie metadanych to oczekiwane. Sprawdź source_origin; po nowym udanym RAG powinien wskazywać nową turę.

Jeżeli problem dotyczy wyszukiwania, wróć do modułu 3. Jeżeli fragment jest poprawny, a odpowiedź dopisuje treść, wróć do modułu 4. Gdy myli się akcja albo stan, przejrzyj moduł 5. Moduł 6 pomaga zaprojektować porównanie, w którym poprawa jednego przykładu nie ukrywa pogorszenia innych.

Nie ukrywaj awarii: brak wyniku modelu nie jest dowodem braku informacji w dokumentach. Oznacz błąd techniczny oddzielnie i dopiero po usunięciu przyczyny oceniaj odpowiedź.

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