[Intum](https://intum.fr/aide.md) / [Noe AI](https://intum.fr/aide/noe-ai.md)

# [Źródła wiedzy dla agenta AI](https://intum.fr/aide/noe-ai/zrodla-wiedzy-dla-agenta-ai.md) | [API](#api)

## Czym są źródła wiedzy AI?

Źródła wiedzy to dane, z których agent AI czerpie informacje odpowiadając na pytania użytkowników. System wykorzystuje mechanizm **RAG** (Retrieval-Augmented Generation) — zamiast polegać wyłącznie na wiedzy wbudowanej w model AI, wyszukuje najbardziej trafne fragmenty z Twojej bazy danych i przekazuje je jako kontekst do odpowiedzi.

Dzięki temu agent AI:

- Odpowiada na podstawie **aktualnych danych** z Twojej firmy
- Zna specyfikę Twoich produktów, procesów i procedur
- Może cytować konkretne artykuły z bazy wiedzy lub treści ticketów

## Jakie źródła można podłączyć?

Każda baza wektorowa może mieć podłączone wiele źródeł różnych typów:

| Typ źródła | Opis | Przykład zastosowania |
|---|---|---|
| **Baza wiedzy** | Artykuły z bazy wiedzy (KB) | FAQ, dokumentacja produktu, instrukcje |
| **Helpdesk (Desk)** | Tickety helpdesku z komentarzami | Wcześniejsze rozwiązania zgłoszeń |
| **Skrzynka e-mail** | Wiadomości e-mail | Historia korespondencji z klientami |
| **Zespół** | Posty w zespole | Wewnętrzna dokumentacja, notatki |
| **Projekt** | Posty w projekcie | Dokumentacja projektowa |

## Jak dodać źródło?

1. Przejdź do **Noe → Bazy wektorowe** i wybierz bazę
2. Kliknij przycisk **Źródła NoeAI**
3. Kliknij **+ Dodaj źródło**
4. Wybierz typ źródła (np. Baza wiedzy, Helpdesk)
5. Z listy wybierz konkretne źródło do podłączenia

Po podłączeniu źródło pojawi się na liście "Podłączone źródła".

## Zarządzanie źródłem

Dla każdego podłączonego źródła możesz:

### Indeksowanie

- **Indeksuj wszystko** — dodaje wszystkie elementy ze źródła do bazy wektorowej (w tle). Po zakończeniu dostaniesz powiadomienie
- **Usuń wszystko** — usuwa zaindeksowane wpisy z tego źródła
- **Odłącz źródło** — odłącza źródło i kasuje powiązane wpisy

### Ustawienia

- **Auto-indeksowanie** — nowe i edytowane elementy indeksują się automatycznie po zapisaniu
- **Indeksuj od daty** — tylko elementy utworzone od podanej daty będą uwzględniane

### Auto-indeksowanie

Gdy włączysz tę opcję w ustawieniach źródła:
- **Nowy wpis** w bazie wiedzy / nowy ticket / nowy post → automatycznie trafia do bazy wektorowej
- **Edycja wpisu** (zmiana treści lub tytułu) → stary embedding jest usuwany i tworzony nowy
- Działa dla baz wiedzy, helpdesku i postów. Dla skrzynek e-mail auto-indeksowanie nie jest dostępne (zbyt duży wolumen)

### Wykluczanie i edycja treści

W widoku zarządzania źródłem widzisz listę wszystkich elementów z informacją:

- **Zielona ikonka** przy numerze → element zaindeksowany (kliknij aby zobaczyć wpis wektorowy)
- **Numer #ID** → link do oryginalnego źródła (np. wpis KB)
- **Badge "Wykluczony"** → element pominięty w indeksowaniu
- **Badge "Własna treść"** → oryginalna treść nadpisana

Dla każdego elementu możesz:
- **Wyklucz** — element nie będzie indeksowany (np. nieaktualna informacja)
- **Edytuj treść** — zastąp oryginalną treść własną wersją (np. uprość lub uzupełnij)
- **Przywróć domyślne** — cofnij wykluczenie lub edycję

### Błędy indeksowania

Jeśli indeksowanie nie powiedzie się dla niektórych elementów (np. pusta treść, błąd API embeddingu), na stronie zarządzania źródłem zobaczysz **czerwony box** z listą problemów — numer elementu i opis błędu.

Błędy indeksowania są też widoczne w **aktywności konta** (moduł Noe) — z linkiem do bazy wektorowej i problematycznego elementu.

Najczęstsze przyczyny:
- **Pusta treść** — wpis nie ma treści do zaindeksowania
- **Przekroczenie limitu tokenów** — tekst jest zbyt długi dla modelu embeddingu (rozwiązanie: włącz chunking w ustawieniach bazy wektorowej)
- **Błąd API** — problem z połączeniem do dostawcy embeddingu

## Przykład: Helpdesk Desk z AI

Gdy włączysz AI w ustawieniach Desku helpdesku:

1. System automatycznie tworzy **bazę wektorową** przypisaną do tego Desku
2. **Tickety Desku** są domyślnie dodawane jako źródło — agent AI uczy się z historii zgłoszeń
3. Możesz podłączyć dodatkowe źródła (np. bazę wiedzy z FAQ lub inny Desk)

Dzięki temu agent AI odpowiadający na widgecie helpdesku:

- Zna odpowiedzi z wcześniejszych ticketów
- Ma dostęp do artykułów z bazy wiedzy
- Może korzystać z wiedzy z wielu źródeł jednocześnie

## Zaindeksowane wpisy

W zakładce "Zaindeksowane wpisy" widzisz wszystkie elementy aktualnie znajdujące się w bazie wektorowej. Możesz je filtrować po typie źródła, edytować treść lub usuwać.

Każdy wpis z własną (edytowaną) treścią jest oznaczony badge'em **Własna treść**.

Licznik "12/12 zaindeksowanych" pokazuje unikalne źródła — jeśli jeden wpis został podzielony na chunki, nadal liczy się jako jeden zaindeksowany element.

---

## 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

- [Bazy wektorowe](https://intum.fr/aide/noe-ai/bazy-wektorowe.md)
- [Desk](https://intum.fr/aide/helpdesk/desk.md)