[Intum Pomoc](https://intum.pl/pomoc.md) / [AI w bazie wiedzy](https://intum.pl/pomoc/baza-wiedzy/ai-w-bazie-wiedzy.md)

# [Asystent AI dla czytelników](https://intum.pl/pomoc/baza-wiedzy/asystent-ai-w-bazie-wiedzy.md)

Baza wiedzy umie odpowiadać zdaniami zamiast listą linków. Czytelnik wpisuje pytanie w pole
„Zapytaj lub szukaj...", a strona pokazuje odpowiedź AI razem z listą źródeł - wpisów, z których
odpowiedź powstała. Pod odpowiedzią jest pytanie „Czy odpowiedź była pomocna?", więc od razu
widać, czy treść działa.

Asystent opłaca się, gdy baza ma już kilkadziesiąt wpisów, a czytelnicy pytają własnymi słowami
(„jak zmienić hasło, gdy nie pamiętam maila"), które nie pokrywają się z tytułami artykułów.
Przy kilku wpisach zwykła wyszukiwarka wystarczy.

> [!PATH]
> [Baza wiedzy → Bazy wiedzy](app:/kb/knowledge_bases) → *Twoja baza* → **Edytuj** → **NoeAI**

## Co trzeba mieć {#co-trzeba-miec}

Asystent czyta wyłącznie Twoją treść, więc potrzebuje dwóch rzeczy:

- **konektora AI z embeddingami** (np. OpenAI) - dodaje się go raz na konto w module Konektory.
  Bez niego zakładka NoeAI pokaże ostrzeżenie i nic się nie włączy,
- **bazy wektorowej**, w której leżą przetworzone wpisy. Pole **Baza wektorowa (RAG)** zostaw
  puste, a baza utworzy się sama przy zapisie.

Wpisy trafiają do bazy wektorowej automatycznie - nowy i poprawiony wpis jest indeksowany po
zapisie, więc nie trzeba niczego odświeżać ręcznie.

## Włączenie {#wlaczenie}

W zakładce **NoeAI** zaznacz **Odpowiedzi AI** i zapisz bazę. Pozostałe pola są opcjonalne:

- **Konektor AI (chat)** - którym modelem generować odpowiedź; puste = ten z bazy wektorowej,
- **Timeout AI** - ile sekund czekamy na odpowiedź, zanim strona wróci do zwykłego wyszukiwania
  (domyślnie 15),
- **System prompt** - instrukcja, jak asystent ma odpowiadać: językiem, tonem, długością, czego
  nie obiecywać. To najważniejsze pole, jeśli odpowiedzi są poprawne, ale nie w Twoim stylu,
- **Disclaimer AI** - zdanie nad odpowiedzią, informujące czytelnika, że tekst wygenerowała
  maszyna. Puste = domyślny tekst.

## Skąd asystent bierze treść {#skad-asystent-bierze-tresc}

Domyślnie z wpisów tej bazy wiedzy. W zakładce NoeAI jest też link do **źródeł** bazy
wektorowej - można dołożyć kolejne, jeśli asystent ma znać coś spoza bazy.

Zasada jest prosta: **asystent odpowiada tylko z tego, co ma w źródłach**. Gdy nie znajdzie
odpowiedzi, mówi to wprost („Niestety, nie znalazłem odpowiedzi na to pytanie") zamiast
zmyślać. Braki w odpowiedziach leczy się dopisaniem wpisu, nie zmianą promptu.

## Co pytają czytelnicy

Na karcie bazy wiedzy jest przycisk **Logi AI** - lista pytań, odpowiedzi i użytych źródeł.
To najszybszy sposób, żeby zobaczyć, czego ludzie szukają, a czego w bazie nie ma. Pytania bez
dobrej odpowiedzi są gotową listą tematów na nowe wpisy.

## Asystent a wyszukiwarka {#asystent-a-wyszukiwarka}

Odpowiedzi AI nie wyłączają zwykłego wyszukiwania - pod odpowiedzią zawsze są wyniki, a przycisk
**Wróć do wyszukiwania** przełącza widok. Gdy AI nie odpowie w czasie z pola **Timeout AI**,
czytelnik dostaje po prostu wyniki wyszukiwania i nie widzi żadnego błędu.

## Gdy asystent odpowiada źle {#gdy-cos-nie-dziala}

- **„Nie znalazłem odpowiedzi", choć temat jest w bazie** - sprawdź, czy wpis nie jest szkicem:
  wpisy z zaznaczonym polem **Prywatny** nie trafiają do asystenta. Pomaga też tytuł
  i pierwszy akapit napisane słowami, których używa klient, a nie nazwą funkcji,
- **odpowiedź poprawna, ale za długa, zbyt oficjalna albo w złym języku** - to zadanie dla pola
  **System prompt**, np. „Odpowiadaj krótko, maksymalnie w pięciu zdaniach, po polsku",
- **odpowiedź sprzeczna z inną** - zwykle dwa wpisy mówią różne rzeczy o tym samym. Popraw albo
  połącz wpisy; przycisk **Wyszukaj podobne** na karcie wpisu pokazuje takie pary,
- **zawsze same wyniki wyszukiwania, bez odpowiedzi** - odpowiedź nie mieści się w czasie
  z pola **Timeout AI** albo zakładka NoeAI pokazuje ostrzeżenie o braku konektora.