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

# [Rozmowy](https://intum.fr/aide/noe-ai/rozmowy.md) | [API](#api)

## Rozmowy z AI

Rozmowy to historia wiadomości wymienianych z modelem AI. Każda rozmowa zachowuje kontekst, dzięki czemu AI pamięta wcześniejsze pytania i odpowiedzi.

## Modele AI

Rozmowy można prowadzić z różnymi modelami AI poprzez connectory:

- **OpenAI** — GPT-4, GPT-4o i inne
- **Google Gemini** — modele Gemini
- **Anthropic Claude** — Claude Sonnet, Opus, Haiku

## Funkcje

- **Historia wiadomości** — pełna historia rozmowy z podziałem na wiadomości użytkownika i AI
- **System prompts** — instrukcje systemowe definiujące zachowanie AI
- **Kontekst** — AI otrzymuje historię rozmowy i odpowiada w jej kontekście
- **Powiązanie z obiektami** — rozmowa może być powiązana z zadaniem, ticketem lub innym elementem systemu
- **Kaskadowe prompty** — system automatycznie dobiera prompt: najpierw szuka ustawień użytkownika, potem zespołu, departamentu, konta, a na końcu używa domyślnego

---

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

# Rozmowy — API

**Autoryzacja:** `Authorization: Bearer TOKEN`
**Content-Type:** `application/json`

## Endpoints rozmów

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/noe/conversations.json` | Lista rozmów |
| GET | `/noe/conversations/:id.json` | Szczegóły rozmowy |
| POST | `/noe/conversations.json` | Tworzenie rozmowy |
| PATCH | `/noe/conversations/:id.json` | Aktualizacja rozmowy |
| DELETE | `/noe/conversations/:id.json` | Usunięcie rozmowy |
| POST | `/noe/conversations/create_for_ai` | Tworzenie rozmowy (JSON) |
| POST | `/noe/conversations/:id/send_message` | Wysłanie wiadomości |

## Pola rozmowy

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa rozmowy |
| `connector_id` | integer | nie | ID konektora AI |

## POST — Tworzenie rozmowy

```json
POST /noe/conversations.json

{
  "conversation": {
    "name": "Analiza projektu",
    "connector_id": 123
  }
}
```

## Wysłanie wiadomości

```json
POST /noe/conversations/:id/send_message

{
  "content": "Jakie są główne cechy produktu?"
}
```

Odpowiedź:

```json
{
  "user_message": {
    "id": "uuid",
    "role": "user",
    "content": "Jakie są główne cechy produktu?"
  },
  "assistant_message": {
    "id": "uuid",
    "role": "assistant",
    "content": "Główne cechy produktu to: ..."
  }
}
```

## Endpoints wiadomości

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/noe/conversations/:id/messages.json` | Lista wiadomości |
| POST | `/noe/conversations/:id/messages.json` | Dodanie wiadomości |
| PATCH | `/noe/conversations/:id/messages/:id.json` | Aktualizacja |
| DELETE | `/noe/conversations/:id/messages/:id.json` | Usunięcie |

## Pola wiadomości

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `role` | string | tak | Rola: `user`, `assistant`, `system` |
| `content` | text | tak | Treść wiadomości |

---

## Powiązane

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