[Intum](https://intum.pl/pomoc.md) / [Baza Wiedzy](https://intum.pl/pomoc/baza-wiedzy.md)

# [AI w bazie wiedzy - automatyczne odpowiedzi](https://intum.pl/pomoc/baza-wiedzy/ai-w-bazie-wiedzy-automatyczne-odpowiedzi.md) | [API](#api)

Baza wiedzy może automatycznie odpowiadać na pytania użytkowników za pomocą AI. Działa to przez widget KB - ten sam, który wyświetla artykuły.

## Jak to działa

Gdy użytkownik wpisze pytanie w widgecie i kliknie "Zapytaj", system przeszukuje bazę wektorową (RAG), znajduje najlepiej pasujące fragmenty artykułów i generuje odpowiedź przez LLM. Użytkownik widzi odpowiedź bezpośrednio w widgecie, ze źródłem (linkiem do artykułu).

Oprócz AI, widget nadal pozwala na zwykłe wyszukiwanie artykułów przyciskiem "Szukaj".

## Włączanie AI

1. Wejdź w ustawienia bazy wiedzy (Baza wiedzy > lista > kliknij bazę > Edytuj)
2. Przejdź do zakładki **NoeAI**
3. Zaznacz checkbox "AI włączone"
4. Wybierz bazę wektorową lub zostaw puste - system utworzy ją automatycznie i doda artykuły z tej bazy wiedzy jako źródło
5. Opcjonalnie wybierz konektor AI (chat) i ustaw timeout
6. Zapisz

Po włączeniu AI widget zmieni placeholder na "Zapytaj lub szukaj..." i pojawią się dwa przyciski: Zapytaj (niebieski) i Szukaj (biały).

## System prompt

Domyślny system prompt instruuje AI jak odpowiadać na pytania. Możesz go zmienić w zakładce NoeAI w ustawieniach bazy wiedzy, w polu "System prompt". Jeśli zostawisz puste, użyty zostanie prompt z bazy wektorowej.

## Logi AI

Każde pytanie zadane przez AI w widgecie jest logowane. Logi zawierają pytanie, odpowiedź, użyty model, czas odpowiedzi i feedback użytkownika (kciuk w górę/dół).

Logi AI znajdziesz na stronie bazy wiedzy - przycisk "AI Logs" w górnym pasku (widoczny gdy AI jest włączone). Można filtrować po statusie, feedbacku i typie źródła.

Logowane jest też każde wyszukiwanie w widgecie (bez AI) - z liczbą znalezionych wyników. Dzięki temu wiesz czego szukają użytkownicy i czy znajdują odpowiedzi.

## Feedback

Po otrzymaniu odpowiedzi AI, użytkownik widzi dwa przyciski - kciuk w górę i kciuk w dół. Kliknięcie zapisuje ocenę do loga. To pomaga ocenić jakość odpowiedzi i ulepszać bazę wiedzy.

## Wymagania

AI wymaga skonfigurowanego konektora AI (np. OpenAI, Claude, Gemini) w sekcji Konektory. Baza wektorowa potrzebuje też konektora do embeddingów.

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**



---

## Powiązane

- [Zakładka Bazy Wiedzy (Widget)](https://intum.pl/pomoc/baza-wiedzy/zakladka-bazy-wiedzy-widget.md)
- [Baza Wiedzy](https://intum.pl/pomoc/baza-wiedzy/baza-wiedzy.md)