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

# [Pomoc AI w zarządzaniu Bazą Wiedzy](https://intum.fr/aide/baza-wiedzy/ai-dla-operatora.md) | [API](#api)

## AI w Bazie Wiedzy

Moduł Bazy Wiedzy ma wbudowane narzędzia AI, które działają z dwóch perspektyw — pomagają **operatorowi** tworzyć i zarządzać treścią oraz dają **użytkownikom końcowym** narzędzia do pracy z dokumentacją.

---

## Strona operatora — tworzenie treści z AI

### Przycisk AI w edytorze

Przy tworzeniu lub edycji wpisu w edytorze treści dostępny jest **przycisk AI**. Wystarczy opisać temat wpisu w kilku słowach — np. *"jak skonfigurować integrację z API"* — a AI przygotuje pełną treść artykułu ze strukturą, nagłówkami i krokami.

AI automatycznie:
- Formatuje tekst w Markdown z nagłówkami i listami
- Tworzy krok po kroku procedury
- Poprawia błędy i formatowanie
- Pisze w odpowiednim języku bazy wiedzy

### Modalne okno AI — edycja i masowe tworzenie

Na widoku publicznym bazy wiedzy (widoczne tylko dla operatora) przy każdym wpisie, kategorii i bazie jest przycisk **"Edycja z AI"** lub **"Nowy wpis z AI"**. Kliknięcie otwiera okno dialogowe, w którym można wydać polecenie w języku naturalnym:

- *"Popraw treść wpisu i dodaj sekcję o bezpieczeństwie"*
- *"Przetłumacz wpis na angielski"*
- *"Dodaj 5 nowych wpisów o funkcjach modułu CRM"*
- *"Napisz artykuł poradnikowy o konfiguracji webhooków"*

AI działa jako **agent** — ma dostęp do API bazy wiedzy i wykonuje operacje samodzielnie. Może w jednej rozmowie utworzyć wiele wpisów, przypisać je do kategorii, ustawić tagi i powiązania między wpisami.

### Prompty systemowe

System zawiera gotowe prompty dla różnych operacji:
- **Tworzenie wpisu** — generuje treść artykułu na podstawie opisu tematu
- **Edycja wpisu** — modyfikuje istniejącą treść według instrukcji
- **Tworzenie w kategorii** — masowe dodawanie wpisów w wybranej kategorii

Prompty są konfigurowalne — mogą być dostosowane na poziomie użytkownika, zespołu, działu lub konta.

### Dokumentacja API (content_api)

Każdy wpis ma dodatkowe pole **Dokumentacja API** — oddzielne od treści głównej. Pozwala to utrzymywać równolegle:
- **Treść dla użytkownika** — opis funkcji, poradnik, FAQ
- **Dokumentacja techniczna** — endpointy API, parametry, przykłady żądań

Dokumentacja API jest widoczna po dodaniu suffixu `.api` do adresu wpisu.

---

## Strona użytkownika — przyciski AI na widoku publicznym

Każdy wpis w publicznej bazie wiedzy ma przycisk **AI** z rozwijanym menu. Dzięki niemu użytkownicy końcowi mogą pracować z dokumentacją w nowy sposób.

### Kopiuj stronę

Kopiuje pełną treść wpisu w formacie **Markdown** do schowka. Użytkownik może wkleić ją do dowolnego narzędzia AI, notatnika lub edytora.

### Markdown

Otwiera wersję `.md` wpisu w nowej karcie — czysty Markdown z nagłówkami, linkami i strukturą breadcrumb. Idealna do odczytu maszynowego i przetwarzania przez narzędzia AI.

### Otwórz w Claude

Jednym kliknięciem otwiera [claude.ai](https://claude.ai) z treścią wpisu załadowaną jako kontekst rozmowy. Użytkownik może od razu zadawać pytania o dokumentację, prosić o wyjaśnienia lub przykłady kodu.

### Otwórz w ChatGPT

To samo co powyżej, ale otwiera [chatgpt.com](https://chatgpt.com) z treścią wpisu. Użytkownik wybiera preferowanego asystenta AI.

### Widok API

Jeśli wpis ma dokumentację techniczną (pole `content_api`), w menu pojawia się dodatkowy przycisk **API**. Prowadzi do widoku `.api`, który pokazuje wyłącznie dokumentację techniczną — endpointy, parametry, przykłady żądań i odpowiedzi.

---

## Korzyści

### Dla operatora
- Szybkie tworzenie treści — zamiast pisać od zera, opisujesz temat i AI generuje artykuł
- Masowe operacje — jeden prompt może utworzyć wiele wpisów naraz
- Tłumaczenia — AI przetłumaczy wpis na dowolny język
- Utrzymanie dwóch warstw dokumentacji (użytkownik + API) w jednym wpisie

### Dla użytkownika końcowego
- Dokumentacja staje się **interaktywna** — zamiast czytać, można rozmawiać z AI o treści
- Klienci Twoich klientów otrzymują nowoczesne narzędzia do pracy z bazą wiedzy
- Eksport Markdown umożliwia łatwą integrację z własnymi narzędziami i workflow
- Bezpośredni dostęp do Claude i ChatGPT bez kopiowania tekstu

---

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