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

# [Baza Wiedzy](https://intum.fr/aide/baza-wiedzy/baza-wiedzy.md) | [API](#api)

## Moduł Baza Wiedzy

Baza Wiedzy (KB) pozwala tworzyć publiczne lub prywatne centra pomocy, dokumentację i FAQ. Artykuły są dostępne pod własną domeną lub ścieżką na Twoim koncie.

## Jak to działa

1. Tworzysz bazę wiedzy z wybranym szablonem i językiem
2. Dodajesz [kategorie](kategorie-kb) do organizacji treści
3. Tworzysz [wpisy](wpisy-do-bazy-wiedzy) — artykuły z treścią w Markdown
4. Baza jest dostępna publicznie pod skonfigurowanym adresem URL

## Główne elementy

- **[Wpisy](wpisy-do-bazy-wiedzy)** — artykuły z treścią, tagami i metadanymi SEO
- **[Kategorie](kategorie-kb)** — grupowanie wpisów tematycznie
- **[Komentarze](komentarze-kb)** — dyskusja pod wpisami
- **[Helplinki](helplinki)** — kontekstowa pomoc w aplikacji powiązana z wpisami KB

## Szablony

Każda baza wiedzy używa szablonu wizualnego:

- **Protocol Basic** — nowoczesny szablon z paskiem bocznym, wyszukiwarką i przyciskiem AI (zalecany)
- **Default** — podstawowy szablon
- **Marsian** — szablon pełnej szerokości
- **Syntax** — z podświetlaniem składni kodu

## Funkcje publicznego widoku

- **Wyszukiwarka** — wyszukiwanie pełnotekstowe po artykułach
- **Nawigacja** — spis treści z nagłówków artykułu
- **Ocenianie** — odwiedzający mogą oceniać artykuły (pomocne/niepomocne)
- **Komentarze** — odwiedzający mogą dodawać komentarze
- **Przycisk AI** — otwieranie artykułu w Claude lub ChatGPT
- **Wersja Markdown** — endpoint `.md` zwracający treść jako czysty Markdown

## Wielojęzyczność

Można tworzyć bazy wiedzy w różnych językach i łączyć je w grupy tłumaczeń (`multilang_code`). Wpisy między bazami również można łączyć jako tłumaczenia.

## Własna domena

Bazę wiedzy można podpiąć pod własną domenę (np. `pomoc.firma.pl`) lub prefix (np. `/pomoc/artykul`).

## Prywatność

Baza i poszczególne wpisy mogą być prywatne — widoczne tylko dla zalogowanych użytkowników z odpowiednimi uprawnieniami.

---

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

Moduł Baza Wiedzy udostępnia API dla baz wiedzy, wpisów, kategorii, komentarzy i helplinków.

## Endpointy baz wiedzy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/kb/knowledge_bases.json` | Lista baz wiedzy |
| GET | `/kb/knowledge_bases/:id.json` | Pojedyncza baza |
| POST | `/kb/knowledge_bases.json` | Utworzenie bazy |
| PATCH | `/kb/knowledge_bases/:id.json` | Aktualizacja bazy |
| DELETE | `/kb/knowledge_bases/:id.json` | Usunięcie bazy |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **kb**)

## Pola knowledge_base

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `title` | string | tak | Nazwa bazy wiedzy |
| `description` | string | nie | Opis |
| `lang` | string | nie | Język: `pl`, `en`, `fr`, `cs`, `sk`, `de`, `es`, `uk` |
| `template` | string | nie | Szablon: `protocol_basic`, `default`, `marsian`, `syntax` |
| `prefix` | string | nie | Prefix URL (np. `pomoc`) |
| `private` | boolean | nie | Czy prywatna |
| `category_in_url` | boolean | nie | Kategoria w URL wpisu |
| `content_api` | string | nie | Dokumentacja API (Markdown) |
| `multilang_code` | string | nie | Kod grupy tłumaczeń |

Szczegółowa dokumentacja poszczególnych zasobów w osobnych wpisach:

- [Wpisy](wpisy-do-bazy-wiedzy) — `/kb/entries`
- [Kategorie](kategorie-kb) — `/kb/categories`
- [Komentarze](komentarze-kb) — `/kb/comments`
- [Helplinki](helplinki) — `/kb/helplinks`

---

## Powiązane

- [AI w bazie wiedzy - automatyczne odpowiedzi](https://intum.fr/aide/baza-wiedzy/ai-w-bazie-wiedzy-automatyczne-odpowiedzi.md)
- [Zasilanie bazy wiedzy z ticketów helpdesku](https://intum.fr/aide/baza-wiedzy/zasilanie-bazy-wiedzy-z-ticketow.md)