> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brosbots.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Baza wiedzy

> Wgraj dokumenty (cenniki, regulaminy, instrukcje), z których agent korzysta w trakcie rozmowy. Kilka plików naraz, do 100 MB każdy.

## Wprowadzenie

Baza wiedzy to dokumenty, z których agent czerpie odpowiedzi w trakcie
rozmowy. Platforma dzieli każdy dokument na fragmenty, a podczas rozmowy
wyszukuje te, które pasują do pytania rozmówcy. Dzięki temu dokument może
być długi: do promptu trafiają tylko potrzebne fragmenty.

To coś innego niż pole **Baza wiedzy** w
[kreatorze szablonów](/pl/voice-agent/onboarding-templates#baza-wiedzy-i-faq).
Tamten tekst trafia do promptu w całości, więc jest ograniczony do 2 MB.

<Note>
  Baza wiedzy jest dostępna w planach płatnych.
</Note>

## Wgrywanie dokumentów

1. Otwórz **Pliki / Baza wiedzy** w menu i przejdź do zakładki **Wgraj nowy**.
2. Przeciągnij pliki na pole albo kliknij **Wybierz pliki**. Możesz zaznaczyć
   kilka plików naraz.
3. Każdy plik ma na liście własny pasek postępu. Wgrywają się po dwa naraz,
   reszta czeka w kolejce.

| | |
| - | - |
| **Formaty** | PDF, DOCX, PPTX, XLSX, TXT, MD, HTML, CSV |
| **Rozmiar** | do 100 MB na plik |

Starsze pliki Word (`.doc`) zapisz najpierw jako DOCX. Plik w innym formacie
albo większy niż 100 MB od razu pojawi się na liście z błędem i nie zostanie
wysłany. Gdy wgrywanie się nie uda (np. przez zerwane połączenie), kliknij
ikonę ponowienia przy pliku.

Plik trafia prosto do magazynu plików, bez pośrednictwa serwera aplikacji,
więc duże dokumenty wgrywają się szybciej. Jeśli w Twojej sieci to
niemożliwe, wgrywanie automatycznie przechodzi przez serwer aplikacji. Nie
musisz niczego ustawiać.

## Przetwarzanie

Po wgraniu dokument jest przetwarzany w tle: zamiana na tekst, podział na
fragmenty i indeksowanie. Trwa to od kilku sekund do kilku minut. Status
zobaczysz w zakładce **Wszystkie pliki**:

* **Oczekuje** / **Przetwarzanie**: dokument jest w kolejce albo w trakcie,
* **Gotowy**: agent może z niego korzystać,
* **Błąd**: np. plik jest uszkodzony albo jest duplikatem dokumentu, który
  już masz w bazie (porównujemy zawartość, nie nazwę).

## Jak dokument jest dzielony

Fragment ma do około 480 tokenów, liczonych tym samym tokenizerem, którego
używa model wyszukiwania. To mniej więcej strona tekstu po polsku. Platforma
pilnuje, żeby nie rozcinać tego, co należy do siebie:

* **Tabela** (np. cennik) trafia do jednego fragmentu, jeśli się mieści.
  Dłuższa jest dzielona między wierszami, a każdy kawałek dostaje nagłówek
  tabeli, więc wiersz „Wymiana oleju | 150 zł” nigdy nie traci kolumny ceny.
* **Lista** i akapity pod tym samym nagłówkiem są łączone, dopóki mieszczą
  się w jednym fragmencie.
* Kolejne fragmenty tej samej sekcji **zachodzą na siebie** o około 15%:
  koniec poprzedniego powtarza się na początku następnego, więc pozycja
  z granicy jest cała przynajmniej w jednym z nich.

Na każde pytanie agent dostaje **6 najlepiej pasujących fragmentów**. Cennik
na 40 pozycji mieści się w dwóch, trzech fragmentach, więc agent widzi go
w całości.

<Note>
  Dokumenty wgrane przed 19 października 2026 były dzielone na znacznie mniejsze
  kawałki. Indeksujemy je ponownie po naszej stronie, nie musisz ich wgrywać
  jeszcze raz. W tym czasie agent dalej korzysta ze starego podziału.
</Note>

## Podpięcie dokumentów do agenta

Gotowe dokumenty wybierasz w zakładce **Baza wiedzy** w
[edytorze agenta](/pl/voice-agent/agent-editor). Agent korzysta tylko z
dokumentów, które są do niego podpięte.

<Tip>
  Lepiej działa kilka mniejszych dokumentów na konkretne tematy (cennik,
  regulamin, instrukcja) niż jeden plik ze wszystkim. Agent łatwiej trafia
  wtedy na właściwy fragment.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.