[Intum](https://intum.fr/aide.md) / [CMS](https://intum.fr/aide/cms.md)

# [AI](https://intum.fr/aide/cms/ai.md) | [API](#api)

## Asystent AI w CMS

Moduł CMS posiada wbudowanego asystenta AI, który pomaga w tworzeniu i edycji treści. Przycisk AI jest dostępny przy edycji stron, paragrafów, artykułów, szablonów i witryn.

## Jak działa?

Przy edycji dowolnego elementu CMS (strona, paragraf, artykuł, szablon) kliknij **przycisk AI** — otworzy się okno dialogowe, w którym możesz opisać w języku naturalnym co chcesz zmienić. Asystent AI przeanalizuje aktualną treść i wykona modyfikację zgodnie z instrukcją.

## Co AI może zrobić?

- **Napisać treść od zera** — opisz temat, a AI wygeneruje pełną treść strony lub artykułu
- **Zmodyfikować istniejącą treść** — np. *"Dodaj sekcję o cenach"*, *"Skróć tekst o połowę"*, *"Przetłumacz na angielski"*
- **Poprawić styl i gramatykę** — np. *"Popraw błędy językowe"*, *"Nadaj bardziej profesjonalny ton"*
- **Zmienić strukturę** — np. *"Podziel na mniejsze akapity"*, *"Dodaj nagłówki"*, *"Zamień na listę punktowaną"*
- **Edytować pola formularza** — AI może modyfikować zarówno treść (`content`), jak i własne pola (`fields`)

## Gdzie jest dostępny?

- **Strony** — edycja treści strony
- **Paragrafy** — edycja treści paragrafu
- **Artykuły** — edycja treści artykułu
- **Szablony** — edycja kodu szablonu
- **Witryny** — edycja ustawień witryny

## Wskazówki

- Pisz instrukcje po polsku lub angielsku — AI rozumie oba języki
- Im bardziej szczegółowa instrukcja, tym lepszy wynik
- AI zachowuje istniejącą strukturę i formatowanie, modyfikując tylko to, o co prosisz
- Możesz wielokrotnie uruchamiać AI na tym samym elemencie, stopniowo dopracowując treść

---

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

## API — CMS AI (Replace)

Wszystkie główne zasoby CMS obsługują endpoint `/replace.json` do modyfikacji treści przez AI/LLM.

### Endpointy Replace

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| PATCH | `/cms/pages/:id/replace.json` | Zamiana treści strony |
| PATCH | `/cms/paragraphs/:id/replace.json` | Zamiana treści paragrafu |
| PATCH | `/cms/layouts/:id/replace.json` | Zamiana treści szablonu |
| PATCH | `/cms/articles/:id/replace.json` | Zamiana treści artykułu |
| PATCH | `/cms/sites/:id/replace.json` | Zamiana treści witryny |

### Dozwolone pola

Endpoint `replace` akceptuje tylko dwa pola:

- `content` — główna treść zasobu
- `fields` — własne pola JSONB

### Przykład

```
PATCH /cms/pages/123/replace.json
Authorization: Bearer TOKEN
Content-Type: application/json
```

```json
{
  "page": {
    "content": "<h1>Nowa treść wygenerowana przez AI</h1>\n<p>Zaktualizowany opis strony.</p>",
    "fields": {
      "title": "Nowy tytuł",
      "description": "Zaktualizowany opis"
    }
  }
}
```

### Zastosowanie

Endpoint `replace` jest używany przez asystenta AI w interfejsie CMS. Przycisk AI dostępny przy edycji strony, paragrafu, szablonu i artykułu pozwala modyfikować treść za pomocą instrukcji w języku naturalnym.