Agenci AI i modele językowe

Jak zbudować bazę wiedzy AI? żeby agent odpowiadał z Twoich dokumentów, nie z domysłu

Agent AI jest tak dobry, jak źródło, z którego odpowiada. Ten poradnik jest w całości o źródle: co wchodzi do bazy wiedzy, jak przygotować dokument, żeby dało się go zacytować z dokładnością do sekcji, jak rozstrzygać sprzeczne wersje plików i kto pilnuje, żeby po kwartale baza nadal mówiła prawdę.

9 minut czytania

  • 5 do 10 sekundtyle trwa odpowiedź BOND-a, naszego firmowego agenta AI, z danych firmy, razem ze wskazaniem źródła
  • 300 do 800 tokenówrozmiar fragmentu, na jaki tniemy dokument, czyli mniej więcej od jednego do trzech akapitów
  • 1 pytanie na sekcjęzasada pisania dokumentu do bazy: jeden nagłówek, jedna odpowiedź, wersja i data w stałym miejscu
  • 30 i 90 dnikiedy powtarzamy zestaw pytań kontrolnych, bo dokument dopisany po starcie zmienia odpowiedzi

Krótka odpowiedź

Jak zbudować bazę wiedzy AI krok po kroku?

Zacznij od pytań, nie od dokumentów. Spisz 30 pytań, które zespół zadaje najczęściej, i przy każdym zaznacz, gdzie dziś leży odpowiedź: w pliku na dysku, w systemie CRM, w skrzynce jednej osoby czy w niczyjej głowie. Baza wiedzy to zbiór tych źródeł, a nie kopia całego dysku firmowego.

Potem przygotuj źródła do czytania maszynowego: jeden temat na dokument, nagłówek w formie pytania, jedna odpowiedź pod nagłówkiem, wersja i data obowiązywania w stałym miejscu. Agent ma obowiązek podać, z którego dokumentu i której sekcji wziął odpowiedź. Bez tego nikt nie sprawdzi, czy odpowiedź pochodzi z Twojej firmy, czy z ogólnej wiedzy modelu.

Na koniec wyznacz właściciela każdego dokumentu i termin przeglądu. Baza wiedzy nie psuje się w dniu startu. Psuje się w trzecim miesiącu, gdy obok procedury z marca leży wersja z czerwca i nikt nie oznaczył, która obowiązuje.

Co wchodzi do bazy wiedzy agenta AI?

Baza wiedzy to nie folder z plikami. To lista źródeł, z których agent ma prawo odpowiadać, każde z właścicielem i datą. Część z nich to dokumenty, część to systemy odpytywane dopiero w momencie pytania.

Podział przebiega po tym, jak szybko dane się zmieniają. Treść, która stoi tygodniami (procedura, regulamin, opis produktu, warunki handlowe), trafia do bazy jako dokument. Liczba, która zmienia się w ciągu dnia (stan magazynu, saldo, etap szansy w CRM), idzie zapytaniem do systemu, bo jej kopia jest nieaktualna już w chwili zapisu.

Sposób, w jaki agent sięga po dane z systemu, ma osobny poradnik: standard MCP opisuje, jak podłącza się narzędzia. Tutaj liczy się co innego. BOND, nasz firmowy agent AI, odpowiada z danych firmy w 5 do 10 sekund i podaje źródło odpowiedzi, ale to źródło ktoś musi wcześniej uporządkować.

ŹródłoCo da się z niego wyciągnąćPułapka
Dokumenty na dysku (Google Workspace, Microsoft 365)procedury, regulaminy, oferty, opisy produktów, instrukcjekilka wersji tego samego pliku obok siebie i skany bez warstwy tekstowej, których model nie przeczyta
Baza SQL i hurtownia danych (BigQuery, baza sklepu)liczby na dziś: sprzedaż, stany, salda, terminynazwy kolumn zrozumiałe tylko dla autora; bez opisu tabel agent policzy nie to, o co pytasz
CRM (HubSpot, Pipedrive, Salesforce, LiveSpace)historia kontaktu, etap szansy, ustalenia z klientem, właściciel relacjinotatki pisane skrótami i pola wypełniane po swojemu przez każdego handlowca
Poczta i komunikator (Microsoft 365, Slack)ustalenia, których nikt nie przeniósł do dokumentuwątki prywatne i dane osobowe, a do tego ustalenia odwołane w kolejnej wiadomości
Historia zgłoszeń (system ticketowy, skrzynka wsparcia)prawdziwe pytania klientów i odpowiedzi, które zadziałałyodpowiedzi błędne albo z nieaktualnym cennikiem, powielane potem przez agenta w nieskończoność
ERP i fakturowanie (Comarch Optima, Subiekt, Fakturownia)dokumenty sprzedaży, terminy płatności, warunki dla klientadane rozliczeniowe widoczne dla całej firmy, jeśli nie ustawisz zakresu dostępu

Kolejność podłączania ustal po tym, ile pytań z Twojej listy trzydziestu obsłuży dane źródło. Zwykle dwa pierwsze zamykają jej większą część niż pozostałe cztery razem, a każde kolejne źródło to osobna praca z uprawnieniami.

Jak przygotować dokument, żeby agent umiał go zacytować?

Model czyta tekst, nie układ graficzny. Dokument z ramkami, tabelą rozbitą na kolumny i skanem podpisu jest dla niego gorszy niż zwykły plik tekstowy z nagłówkami. Sprawdza się jeden temat na dokument, nagłówek w formie pytania i jedna odpowiedź pod tym nagłówkiem.

Różnicę widać dopiero przy cytowaniu. Bez przygotowanego źródła odpowiedź brzmi: termin płatności to 14 dni. Z przygotowanym: termin płatności to 14 dni, Regulamin sprzedaży, wersja 3, sekcja „Płatności”, obowiązuje od 1 marca 2026. Pierwszą trzeba sprawdzać od zera, drugą sprawdzasz w kilkanaście sekund, więc ktoś faktycznie to robi.

Wymuszenie cytatu zmienia też to, czego agent nie napisze. Gdy instrukcja brzmi „odpowiadaj wyłącznie z podanych fragmentów i podaj nazwę dokumentu”, pytanie bez pokrycia w bazie kończy się odmową zamiast gładkim zdaniem z wiedzy ogólnej. Osobno piszemy o tym w poradniku halucynacje AI.

  • Jeden temat na dokument, nagłówek w formie pytania, jedna odpowiedź pod nagłówkiem
  • Wersja, data obowiązywania i właściciel w stałym miejscu pliku, na górze albo na dole
  • Skróty i nazwy wewnętrzne rozwinięte przy pierwszym użyciu, bo pytający użyje innego słowa niż autor
  • Zamiast „patrz załącznik” pełna treść w dokumencie: agent nie otworzy załącznika za Ciebie
  • Skan bez warstwy tekstowej przepuszczony przez rozpoznawanie tekstu albo przepisany, inaczej jest niewidoczny

Po co dzielić dokumenty na fragmenty?

Agent nie wysyła modelowi całego dysku. Do pytania dobiera kilka najlepiej pasujących fragmentów i dopiero z nich powstaje odpowiedź. Dlatego dokument tnie się na kawałki, a od tego cięcia zależy, czy agent trafi w konkretną sekcję, czy poda ogólnik z pierwszej strony.

W naszych wdrożeniach fragment liczy od 300 do 800 tokenów, czyli mniej więcej od jednego do trzech akapitów, i niesie ze sobą nazwę dokumentu oraz nagłówek sekcji. Bez nagłówka fragment „termin wynosi 14 dni” nie mówi, o który termin i którą umowę chodzi.

  • Fragment od 300 do 800 tokenów: krótszy gubi kontekst, dłuższy rozmywa pytanie
  • Nazwa dokumentu i nagłówek sekcji dopisane do każdego fragmentu, żeby dało się go zacytować
  • Cięcie po nagłówkach, nie co tyle samo znaków: procedura przecięta w połowie kroku daje połowę odpowiedzi
  • Tabela zostaje w całości albo idzie do bazy jako dane; wiersz bez nagłówków kolumn jest bezużyteczny

Wyszukiwanie po znaczeniu czy po słowach?

To dwa różne mechanizmy i każdy z nich osobno zawodzi. Wyszukiwanie po słowach szuka dokładnego ciągu znaków: trafi w numer faktury i nie znajdzie nic, gdy pytający pisze o urlopie na żądanie, a procedura nazywa to wolnym na telefon. Wyszukiwanie po znaczeniu robi odwrotnie: rozumie parafrazę, gubi numer.

Dlatego w praktyce puszcza się oba naraz i łączy wyniki. Kosztuje to jedno dodatkowe zapytanie do bazy i zdejmuje najbardziej irytującą klasę błędów: agenta, który nie znajduje dokumentu, o którym wiesz, że istnieje.

Pytanie z zespołuWyszukiwanie po znaczeniuWyszukiwanie po słowach
Ile mamy dni na reklamację?trafi w sekcję o zwrotach, nawet gdy słowa „reklamacja” w niej nie maznajdzie tylko dokumenty z tym jednym słowem
Jakie warunki ma faktura FV/2026/0912?zwróci przypadkowe faktury o podobnej treścitrafi w dokładny numer dokumentu
Jak rozliczyć wyjazd służbowy?znajdzie procedurę nazwaną „Delegacje krajowe”nie znajdzie nic, bo nazwy się nie pokrywają
Kto prowadzi klienta Kowalski sp. z o.o.?pomyli podobnie brzmiące nazwy firmtrafi w dokładną nazwę zapisaną w CRM
Czy możemy dać rabat 15 procent?znajdzie politykę rabatową, choć pytanie jest o liczbętrafi tylko wtedy, gdy w polityce stoi dokładnie ta liczba

Wniosek bierz z własnej listy pytań. Pytania z nazwami własnymi, numerami dokumentów i symbolami produktów potrzebują wyszukiwania po słowach, pytania „jak się to robi” wyszukiwania po znaczeniu. Zwykle na liście są oba rodzaje, więc oba mechanizmy zostają włączone.

Która wersja dokumentu obowiązuje?

To błąd numer jeden w bazach zbudowanych przez podłączenie dysku firmowego. Leżą na nim trzy cenniki: „cennik”, „cennik nowy” i „cennik nowy FINAL 2”. Agent znajdzie wszystkie trzy i wybierze ten, który lepiej pasuje do pytania, bo z treści nie wynika, który jest ważny.

Rozstrzygnięcie nie jest techniczne, tylko organizacyjne. Ktoś musi powiedzieć, która wersja obowiązuje, a pozostałe mają wypaść z bazy. Kopia zapasowa ma prawo leżeć na dysku, w bazie wiedzy agenta nie ma prawa się znaleźć.

  • Data obowiązywania w treści dokumentu, nie w nazwie pliku: nazwę zmieni każdy, kto kliknie kopiuj
  • Jeden obowiązujący dokument na jeden temat, reszta poza bazą albo w archiwum bez dostępu dla agenta
  • Dokument wygasły oznaczony wprost, żeby agent umiał powiedzieć, że warunki już nie obowiązują
  • Sprzeczność zgłoszona człowiekowi: agent pokazuje obie wersje i pyta, zamiast wybierać za Ciebie
  • Nowa wersja wchodzi do bazy tego samego dnia, w którym zaczyna obowiązywać, a nie po kwartale

Kto ma widzieć który dokument?

Baza wiedzy dziedziczy problem, który firma miała wcześniej: na wspólnym dysku leżą pliki, których połowa zespołu nie powinna otwierać. Agent ujawnia to w tydzień, bo odpowiada każdemu, kto zapyta, i robi to szybciej, niż ktokolwiek zdążyłby przejrzeć folder ręcznie.

Zakres ustawia się po stronie źródeł i osoby pytającej, a nie w instrukcji dla modelu. Zdanie „nie odpowiadaj na pytania o wynagrodzenia” jest sugestią, którą da się obejść innym sformułowaniem pytania. Brak dostępu do folderu kadr jest faktem. RODO nazywa to minimalizacją: przetwarzasz tylko dane niezbędne do celu (art. 5 ust. 1 lit. c rozporządzenia 2016/679).

  • Agent widzi tyle, ile widzi pytający, a nie tyle, ile widzi konto techniczne integracji
  • Kadry, płace i sprawy pracownicze w osobnym zakresie, z własną listą osób i własnym logiem
  • Dane osobowe klientów tylko tam, gdzie są potrzebne do odpowiedzi, reszta wycięta przed wejściem do bazy
  • Log pytań i odpowiedzi razem z tym, który dokument został pokazany i komu
  • Odmowa z powodu uprawnień brzmi jak odmowa, nie jak brak danych: pytający ma wiedzieć, kogo zapytać

Kto i jak często aktualizuje bazę wiedzy?

Baza wiedzy to nie projekt z datą końcową, tylko rejestr z właścicielami. Jeśli po trzech miesiącach nikt nie dopisał ani jednego dokumentu i nikt niczego nie wycofał, to znaczy, że zespół przestał z niej korzystać, a nie że firma stoi w miejscu.

  1. Rejestr dokumentów

    Jedna tabela: nazwa dokumentu, właściciel, data ostatniego przeglądu, termin kolejnego. Dokument bez właściciela nie wchodzi do bazy, bo nie ma kogo zapytać w dniu, w którym przestanie być prawdziwy.

  2. Przegląd w rytmie zmian

    Cennik i warunki handlowe co miesiąc, procedury co kwartał, regulaminy przy zmianie przepisu. Termin siedzi w kalendarzu właściciela, nie w notatce z warsztatu.

  3. Luki z prawdziwych pytań

    Pytania, przy których agent nie znalazł dokumentu, spływają na jedną listę. Raz w tygodniu ktoś decyduje: dopisujemy dokument, poprawiamy istniejący czy zostawiamy temat poza zakresem.

  4. Kontrola po 30 i 90 dniach

    Ten sam zestaw pytań co przed startem, zadany ponownie na tych samych źródłach. Odpowiedź, która zmieniła się bez powodu, oznacza, że do bazy wszedł dokument, którego nikt nie zatwierdził.

Najczęstsze błędy

Sześć błędów, przez które baza wiedzy odpowiada nieprawdę

  • Podłączenie całego dysku firmowego naraz

    Agent cytuje kopie, wersje robocze i notatki ze spotkania sprzed dwóch lat. Odpowiedzi są sprzeczne, a zespół po tygodniu wraca do pytania kolegi z pokoju obok.

  • Dokumenty w formie skanów i prezentacji

    Skan bez warstwy tekstowej jest dla agenta pustą stroną. Slajd z trzema hasłami daje odpowiedź złożoną z trzech haseł, a pytający i tak musi otworzyć plik.

  • Brak wersji i daty obowiązywania w treści

    Agent nie ma po czym rozstrzygnąć, który cennik jest ważny, więc wybiera lepiej pasujący do pytania. Odpowiedź jest poprawnie zacytowana i nieprawdziwa.

  • Odpowiedź bez wskazania dokumentu i sekcji

    Sprawdzenie takiej odpowiedzi zajmuje kwadrans, więc nikt jej nie sprawdza. Po pierwszej pomyłce zespół przestaje ufać całej bazie, także tej części, która była w porządku.

  • Baza wiedzy bez właściciela dokumentów

    Po kwartale część treści jest nieaktualna, a odpowiedzialność rozmywa się między dział IT a autorów plików. Nikt nie wie, kto ma prawo wycofać procedurę.

  • Uprawnienia ustawione instrukcją dla modelu

    Wystarczy inaczej sformułowane pytanie, żeby agent pokazał dokument z folderu kadr. Ograniczenie działa tylko wtedy, gdy leży po stronie dostępu do źródła.

Lista kontrolna

Lista kontrolna przed podłączeniem bazy wiedzy do agenta AI

Jeśli któryś punkt jest na „nie”, agent odpowie, ale tej odpowiedzi nie da się obronić.

  • Lista 30 prawdziwych pytań zespołu, z zaznaczeniem, gdzie dziś leży odpowiedź
  • Każdy dokument w bazie ma właściciela, wersję i datę obowiązywania w treści
  • Stare wersje wypchnięte poza bazę, jeden obowiązujący dokument na temat
  • Skany przepuszczone przez rozpoznawanie tekstu albo przepisane ręcznie
  • Fragmenty niosą nazwę dokumentu i nagłówek sekcji, a agent podaje je w odpowiedzi
  • Wyszukiwanie po słowach włączone obok wyszukiwania po znaczeniu
  • Zakres agenta równy zakresowi pytającego, kadry i płace osobno
  • Termin przeglądu wpisany w kalendarz właściciela, nie w notatkę z warsztatu

Zacznijmy od Twoich dokumentów

Bazę wiedzy układa się na prawdziwych pytaniach, nie na spisie folderów

Na bezpłatnej konsultacji (30 minut) bierzemy dziesięć pytań, które Twój zespół zadaje najczęściej, i sprawdzamy, gdzie dziś leży na nie odpowiedź. Warsztat procesowy kosztuje 2500 zł netto za tydzień i kończy się listą źródeł, właścicieli i porządkiem w dokumentach, który zostaje u Ciebie niezależnie od tego, czy cokolwiek wdrożymy. Prowadzimy najwyżej dwa wdrożenia równocześnie, więc mówimy wprost, kiedy jest miejsce.

Umów bezpłatną konsultację

Opisz swoje wyzwanie

Piszesz bezpośrednio do Pawła. Zero spamu.

Najczęstsze pytania

Czym jest baza wiedzy AI?

To lista źródeł, z których agent AI ma prawo odpowiadać: dokumenty, procedury, oferty, historia zgłoszeń oraz systemy odpytywane na bieżąco, takie jak CRM czy hurtownia danych. Każde źródło ma właściciela i datę. To nie to samo co folder na dysku, bo do bazy wchodzi wyłącznie wersja obowiązująca.

W jakim formacie przygotować dokumenty do bazy wiedzy?

Najlepiej czysty tekst ze strukturą: nagłówek w formie pytania, jedna odpowiedź pod nagłówkiem, wersja i data w stałym miejscu. Model czyta treść, nie układ graficzny, więc ramki, kolumny i osadzone obrazy przeszkadzają. Skan bez warstwy tekstowej trzeba wcześniej rozpoznać albo przepisać.

Po co dzieli się dokument na fragmenty?

Agent nie podaje modelowi całego pliku, tylko kilka fragmentów najlepiej pasujących do pytania. Dokument tnie się więc po nagłówkach na kawałki od 300 do 800 tokenów, a do każdego dopisuje nazwę dokumentu i nagłówek sekcji. Dzięki temu odpowiedź da się zacytować z dokładnością do sekcji, a nie do pliku.

Czym różni się wyszukiwanie po znaczeniu od wyszukiwania po słowach?

Wyszukiwanie po znaczeniu dopasowuje sens pytania do sensu fragmentu, więc na pytanie o rozliczenie wyjazdu znajdzie procedurę nazwaną „Delegacje krajowe”. Wyszukiwanie po słowach szuka dokładnego ciągu znaków i jako jedyne trafi w numer faktury albo symbol produktu. W praktyce włącza się oba i łączy wyniki.

Co zrobić, gdy w bazie są dwie sprzeczne wersje dokumentu?

Rozstrzyga człowiek, nie agent. Jedna wersja zostaje jako obowiązująca, z datą i właścicielem, pozostałe wychodzą z bazy do archiwum. Jeśli sprzeczność ma zostać, bo na przykład inne warunki obowiązują dwa rynki, agent ma pokazać obie i zapytać, o który przypadek chodzi.

Czy każdy pracownik ma widzieć całą bazę wiedzy?

Nie. Zakres ustawia się na poziomie źródeł i osoby pytającej, a nie instrukcją dla modelu, bo instrukcję da się obejść innym sformułowaniem pytania. Kadry, płace i dane osobowe idą do osobnego zakresu z własną listą osób, zgodnie z zasadą minimalizacji z art. 5 rozporządzenia 2016/679.

Jak często aktualizować bazę wiedzy?

W rytmie, w jakim zmieniają się dane: cennik i warunki handlowe co miesiąc, procedury co kwartał, regulaminy przy zmianie przepisu. Termin przeglądu wpisz w kalendarz właściciela dokumentu. Po 30 i 90 dniach od startu powtórz zestaw pytań kontrolnych i sprawdź, które odpowiedzi się zmieniły.

Czy do bazy wiedzy potrzebna jest osobna baza wektorowa?

Nie zawsze. Przy kilkuset dokumentach wystarcza rozszerzenie wektorowe w bazie, którą już masz, albo mechanizm wbudowany w platformę agenta. Osobne narzędzie ma sens przy dużych zbiorach i wysokim ruchu. Wybór narzędzia to ostatnia decyzja, nie pierwsza: najpierw porządek w źródłach.