Baza wiedzy firmy dla agentów AI: pliki zamiast kolejnego systemu

Agent AI jest dokładnie tak dobry jak wiedza, którą dostaje. Ten sam model napisze ogólnikową ofertę, gdy nic nie wie o kliencie, i trafną, gdy zna ustalenia ze spotkania, cennik i sposób, w jaki firma pisze. Dlatego wdrożenie agentów w firmie zaczyna się od bazy wiedzy, a nie od wyboru modelu. W tym tekście pokazujemy, jak zbudować bazę wiedzy firmy dla agentów AI w zwykłych plikach, co do niej trafia, jak ją ułożyć, żeby agent czytał tylko to, czego potrzebuje, i jak sprawić, żeby się nie zestarzała. Przykłady bierzemy z bazy wiedzy, na której sami pracujemy.

Czym jest baza wiedzy firmy dla agentów AI

Baza wiedzy firmy dla agentów AI to uporządkowany zbiór plików tekstowych z tym, co firma wie: o swojej ofercie, klientach, procesach i decyzjach. Czytają ją agenci i ludzie, a agenci dopisują do niej wyniki swojej pracy. Ułożona jest tak, żeby agent zawsze zaczynał od stanu, potem sięgał do mapy, a do szczegółu dopiero wtedy, gdy go potrzebuje.

To nie jest kolejny program, do którego zespół musi się logować. To folder z plikami, które da się otworzyć w zwykłym edytorze, przeczytać, poprawić i porównać z wersją sprzed tygodnia. W systemie agentowym baza wiedzy jest jednym z sześciu elementów, które widzi zespół, i tym, od którego zależą wszystkie pozostałe: agenci, umiejętności i reguły pracują na tym, co jest w plikach. Szerzej o tym, z czego składa się cały system, piszemy w tekście system agentowy: co to jest.

Dlaczego pliki, a nie kolejny system

Pierwszy odruch przy haśle „baza wiedzy dla AI” to wyszukiwarka wektorowa (RAG) albo nowe narzędzie z panelem. Oba mają swoje miejsce, ale w małej i średniej firmie usługowej zwykle zaczynamy od plików.

Pliki wygrywają w małej firmie z trzech powodów. Po pierwsze, są przejrzyste: gdy agent napisze coś dziwnego, da się sprawdzić, na jakim pliku się oparł, i ten plik poprawić. Po drugie, ludzie i agenci pracują na tym samym, więc nie ma dwóch wersji prawdy. Po trzecie, nie dochodzi kolejny abonament ani kolejne miejsce, w którym trzeba coś aktualizować. Wyszukiwanie wektorowe zostawiamy na moment, w którym dokumentów jest tyle, że żaden człowiek nie zrobi im mapy. W większości firm, z którymi rozmawiamy, ten moment jeszcze nie nastąpił.

Co trafia do bazy wiedzy

Do bazy wiedzy trafia wszystko, co dziś wklejasz do czatu za każdym razem od nowa, i wszystko, co wie tylko jedna osoba w firmie.

• Firma: opis usług, cennik, wzory ofert, sposób pisania do klientów, rzeczy, których firma nie obiecuje.
• Klienci: karta klienta z najważniejszymi faktami, ustalenia ze spotkań, co komu obiecano i na kiedy.
• Procesy: opisane krok po kroku jako umiejętności, czyli instrukcje, które agent wczytuje, gdy wykonuje dany proces. Przykład: jak przygotować notatkę przed spotkaniem z klientem albo szkic oferty i follow-upu.
• Reguły: poprawki, które człowiek zrobił w wynikach agenta, zapisane tak, żeby nie trzeba było ich robić drugi raz.
• Decyzje: co firma postanowiła, kiedy, kto o tym rozstrzygnął i dlaczego.
• Stan prac: co jest w toku, co czeka na kogo, co jest zablokowane.

Ostatnie dwie pozycje firmy najczęściej pomijają, a to one najbardziej oszczędzają czas. Agent, który zna decyzje, nie proponuje rozwiązania odrzuconego miesiąc temu. Agent, który zna stan, nie zaczyna od pytania, na czym skończyliśmy.

Jak ułożyć bazę wiedzy: stan, mapa, szczegół

Najważniejsza zasada brzmi: agent czyta w ustalonej kolejności. Najpierw stan, potem mapę, na końcu szczegół, i tylko ten, którego potrzebuje do zadania. Tak wygląda to w jednym z projektów w naszej własnej bazie wiedzy, w projekcie, który prowadzi publikacje w mediach społecznościowych.

Stan to jeden plik, status.md, z tabelą tego, co jest teraz prawdą: co jest zablokowane, po czyjej stronie jest piłka, co zamknięto i kiedy. Agent czyta go na początku pracy w projekcie i od razu wie, czego nie ruszać i na co czekamy.

Mapa to plik catalog.md, który mówi, jakie pliki są w projekcie i co zawiera każdy z nich, w jednym zdaniu na plik. Agent nie otwiera dwudziestu plików, żeby znaleźć właściwy. Czyta mapę i otwiera jeden.

Szczegół to pliki tematyczne. Każda decyzja ma u nas osobny plik z nagłówkiem: numer, data, stan, kto rozstrzygnął, a pod nim decyzja i powód. Każdy temat do publikacji ma swój folder, a etap, na którym jest, zapisujemy jako pole w nagłówku pliku. Nic nie przenosimy między folderami przy zmianie etapu, bo w bazie pracuje kilka sesji naraz, a przenoszenie plików w trakcie czyjejś edycji to prosta droga do konfliktu.

Z tego wynikają cztery praktyczne zasady:

1. Jeden plik na jeden temat. Plik „wszystko o kliencie X” z czasem rośnie do rozmiaru, którego nikt nie czyta. Lepiej karta klienta i osobne pliki ze spotkań.
2. Opis w nagłówku. Każdy plik zaczyna się od jednego zdania, kiedy go czytać. Po tym zdaniu agent decyduje, czy w ogóle otworzyć resztę.
3. Stan oddzielnie od wiedzy. To, co się zmienia co dzień, trzymamy w pliku stanu. To, co jest prawdą przez miesiące, w plikach wiedzy. Dzięki temu pliki wiedzy nie starzeją się od każdej zmiany statusu.
4. Daty zamiast „wczoraj”. Wpis „w zeszłym tygodniu klient zgodził się na zakres” po miesiącu nic nie znaczy. Wpis z datą zawsze da się umieścić w czasie.

Dlaczego kolejność czytania oszczędza limity

Agenci na Claude Team pracują w ramach limitów subskrypcji. Każdy plik, który agent wczyta bez potrzeby, zużywa część limitu i zostawia mniej na pracę w ciągu dnia. Baza wiedzy ułożona w kolejności stan, mapa, szczegół sprawia, że agent przygotowujący ofertę wczytuje plik stanu, mapę, kartę klienta, ustalenia z ostatniego spotkania i cennik, a nie całą historię firmy. To samo zadanie kosztuje mniej, a wynik jest lepszy, bo w kontekście nie ma szumu, który odciąga uwagę modelu od tego, co ważne.

Ta sama zasada działa w drugą stronę. Wszystko, co da się sprawdzić bez modelu, na przykład czy plik ma wymagane pola w nagłówku albo czy mapa wymienia każdy plik z folderu, sprawdza u nas skrypt. Jest tańszy i za każdym razem daje ten sam wynik.

Ludzie i agenci na tej samej wiedzy

Baza wiedzy w plikach nie jest „pamięcią AI”. Jest pamięcią firmy, z której korzystają też agenci. Nowa osoba w zespole czyta te same karty klientów i te same opisy procesów co agent, więc od pierwszego dnia wie, jak firma pisze oferty i co komu obiecała. Gdy ktoś idzie na urlop, ustalenia z jego spotkań nie znikają w jego skrzynce.

U nas baza wiedzy żyje w repozytorium git, więc każda zmiana ma autora i datę, a każdą da się cofnąć. W firmie, która nie pracuje z gitem, ten sam efekt daje wspólny folder z historią wersji. Ważne jest to, żeby zmiana w bazie wiedzy była widoczna i dała się odwrócić.

Jak baza wiedzy się aktualizuje

Baza wiedzy, którą trzeba ręcznie uzupełniać, po kilku tygodniach przestaje odpowiadać rzeczywistości. Dlatego w systemie agentowym większość aktualizacji robią agenci w trakcie pracy:

• po spotkaniu agent zapisuje ustalenia i zadania przy kliencie,
• po poprawce człowieka zmiana trafia do bazy jako reguła, żeby ten sam błąd nie wrócił,
• po decyzji powstaje plik decyzji z datą i powodem,
• zadania porządkowe regularnie sprawdzają, czy mapa zgadza się z plikami, a wpisy w stanie nie są przeterminowane.

Ten ostatni punkt nie jest teorią. W naszym własnym pliku stanu zdarzyło się, że wiersz o blokadzie stał na tablicy, choć sprawa była rozwiązana od tygodni. Agent, który go czytał, uznawał blokadę za aktualną. Od tamtej pory pilnujemy, żeby każdy wiersz stanu miał datę i właściciela, a przegląd stanu jest stałym zadaniem, a nie dobrą wolą.

Od czego zacząć

Nie od porządkowania całej wiedzy firmy. To projekt, który się nie kończy. Zacznij od jednego procesu i zbierz tylko wiedzę, której ten proces potrzebuje.

1. Wybierz proces, który powtarza się co tydzień, na przykład przygotowanie do spotkań z nowymi klientami.
2. Zbierz to, co już istnieje: cennik, dwie, trzy dobre oferty, opis usług, notatki o kilku aktywnych klientach. Nie muszą być uporządkowane.
3. Ułóż to w plikach według zasady stan, mapa, szczegół i dopisz do każdego pliku zdanie, kiedy go czytać.
4. Opisz proces jako umiejętność: skąd agent bierze dane, w jakiej kolejności czyta pliki, jak wygląda wynik.
5. Uruchom i poprawiaj. Każda poprawka, która się powtarza, staje się regułą w bazie.

Gdy pierwszy proces działa, kolejne dochodzą na tej samej bazie i są łatwiejsze, bo większość wiedzy już w niej jest. Więcej o kolejności kroków piszemy w tekście o wdrożeniu Claude w firmie.

Najczęstsze błędy

• Wrzucenie wszystkiego naraz. Folder z pięciuset dokumentami bez mapy to nie baza wiedzy, tylko archiwum. Agent albo przeczyta za dużo, albo nie to, co trzeba.
• Brak pliku stanu. Bez niego agent za każdym razem odtwarza, na czym skończyliśmy, i robi to gorzej niż człowiek.
• Wiedza tylko dla agentów. Gdy ludzie pracują w innym miejscu niż agenci, obie wersje szybko się rozjeżdżają.
• Poprawki bez zapisu. Poprawiony wynik bez reguły w bazie oznacza ten sam błąd w przyszłym tygodniu.
• Nikt nie odpowiada za bazę. Bazę wiedzy uzupełniają agenci, ale ktoś musi decydować, co jest prawdą, gdy dwa pliki mówią co innego.

A co z danymi firmy?

Baza wiedzy zawiera informacje o klientach, więc przed jej zbudowaniem warto ustalić trzy rzeczy: jakie dane do niej trafią, kto ma do niej dostęp i jakie warunki przetwarzania obowiązują w wybranym planie Claude. Warunki planów opisuje Anthropic. Ten tekst nie jest poradą prawną: decyzję o zakresie danych podejmuje firma, a my pomagamy przełożyć ją na układ bazy i uprawnienia.

Najczęstsze pytania

Czy baza wiedzy dla agentów AI wymaga bazy wektorowej albo RAG?

Nie na początku. W małej i średniej firmie wiedza mieści się zwykle w dziesiątkach lub setkach plików, a agent dobrze je znajduje po mapie i opisach plików. Wyszukiwanie wektorowe ma sens, gdy dokumentów jest tyle, że nikt nie zrobi im mapy.

Czy mogę trzymać bazę wiedzy w Google Drive, Notion albo SharePoint?

Możesz trzymać tam dokumenty źródłowe. Agent potrzebuje jednak wiedzy w formie, którą czyta szybko i w ustalonej kolejności, dlatego bazę dla agentów układamy w plikach tekstowych, a z dokumentów źródłowych wyciągamy to, czego potrzebuje proces.

Ile czasu zajmuje zbudowanie bazy wiedzy?

Zależy od tego, ile wiedzy już istnieje poza głowami ludzi. Bazę dla pierwszego procesu budujemy w ramach wdrożenia, kolejne procesy dokładają do niej swoje pliki.

Kto utrzymuje bazę wiedzy po wdrożeniu?

Większość aktualizacji robią agenci w trakcie pracy, a zadania porządkowe pilnują, żeby się nie zestarzała. Po stronie firmy potrzebna jest osoba, która rozstrzyga, co jest prawdą, i rozwija system. Tę część można też zlecić nam.

Ile kosztuje wdrożenie bazy wiedzy i agentów?

Wdrożenie systemu agentowego, w tym bazy wiedzy dla pierwszego procesu, zaczyna się od 9 000 zł netto, zależnie od zakresu. Po stronie firmy jest abonament Claude Team dla każdej osoby pracującej w systemie. Składniki ceny rozpisujemy w tekście ile kosztuje wdrożenie agentów AI.

Podsumowanie

Baza wiedzy firmy dla agentów AI nie musi być nowym systemem. Wystarczą pliki tekstowe ułożone w kolejności stan, mapa, szczegół, z jednym tematem na plik, opisem w nagłówku i datami zamiast „wczoraj”. Czytają je ludzie i agenci, agenci dopisują do nich wyniki, a poprawki zamieniają się w reguły. Zacznij od wiedzy potrzebnej w jednym procesie i rozbudowuj bazę razem z kolejnymi.

Chcesz sprawdzić, jaką wiedzę Twoja firma już ma i od którego procesu zacząć? Umów spotkanie w dogodnym terminie. Trwa około godziny i kończy się wyborem pierwszego procesu. Wolisz najpierw napisać? hello@200iqlabs.io.