[Intum Pomoc V1](https://intum.intum.pl/kb/intum-kb-v1.md) / [Organizacja](https://intum.intum.pl/kb/intum-kb-v1/organizacja.md)

# [Treści od AI w zadaniach i komentarzach](https://intum.intum.pl/kb/intum-kb-v1/organizacja/tresci-od-ai-w-zadaniach-i-komentarzach.md) | [API](#api)

Sugester oferuje zestaw narzędzi opartych na sztucznej inteligencji, które pomagają w szybszym tworzeniu opisów zadań, pisaniu komentarzy, redagowaniu wpisywanych treści oraz komunikacji z zewnętrznymi agentami AI.
Funkcje AI są dostępne zarówno podczas **tworzenia/edycji zadań**, jak i przy **dodawaniu komentarzy**.

![](bcbd0c03e23b-Screenshot - 2026-08-26T172744.437.png)

## 1. Przycisk AI w pasku narzędzi edytora (Formatowanie i generowanie)
W lewym górnym rogu paska narzędzi edytora tekstowego znajduje się rozwijane menu **AI** z ikona gwiazdek. Oferuje ono trzy automatyczne funkcje wspierające pisanie:
- **Popraw pisownię i gramatykę:** Koryguje błędy ortograficzne, literówki oraz interpunkcję w zaznaczonym wpisie bez ingerencji w jego treść.
- **Uładnij z minimalnymi zmianami:** Poprawia styl oraz płynność tekstu, zachowując jego pierwotny sens.
- **Kreatywne AI:** Generuje rozwiniętą treść zadania lub komentarza na podstawie wpisanego zarysu/konceptu.

![](71cc9b274145-Screenshot - 2026-08-26T172800.403.png)

## 2. Przycisk AI w prawym górnym rogu (Prompt i agenci AI)
W prawym górnym rogu formularza zadania znajduje się dedykowany przycisk **AI**. Pozwala on na szybkie wygenerowanie kodu lub promptu do użycia w zewnętrznych narządziach programistycznych i agentach AI (m.in. *Claude Code*, *OpenAI Codex*, *Copilot CLI*, *Gemini CLI* czy *OpenCode*).
1. Kliknij przycisk **AI** w prawym górnym rogu formularza.
2. W oknie wpisz, co chcesz osiągnąć (np. utworzenie zadania z priorytetem, przypisanie użytkownika czy dodanie checklisty).
3. Kliknij **Kopiuj do schowka** i wklej wygenerowany wywód do swojego agenta AI.

![](51a959a209d1-Screenshot - 2026-08-26T172821.090.png)

### 3. Dodaj treść od AI (Wywód agenta i tło techniczne)
Tuż pod głównym oknie edytora tekstowego znajduje się sekcja **▼ Dodaj treść od AI**. Jest to dedykowane pole przeznaczone do wklejania odpowiedzi oraz wywodów technicznych generowanych przez zewnętrzne narzędzia i agenty AI (*Claude Code*, *OpenAI Codex*, *Copilot CLI*, *Gemini CLI*, *OpenCode*).
- **Przejrzystość wpisu:** Pozwala oddzielić podsumowanie napisane własnymi słowami (w głównym edytorze) od surowego kodu czy logów działania sztucznej inteligencji.
- **Widok po zapisaniu:** Cała treść wklejona w to pole po zapisaniu zadania lub komentarza wyświetla się jako **zwinięta sekcja (zwinięte tło)**. Dzięki temu nie blokuje widoku, a pełny wywód agenta jest zawsze dostępny do wglądu po rozwinęciu.

## AI w sekcji komentarzy
Te same możliwości formatowania oraz pole **▼ Dodaj treść od AI** znajdziesz również podczas dodawania komentarza do dowolnego zadania. Dzięki temu możesz sprawnie redagować odpowiedzi lub dołączać wywody agentów bezpośrednio w dyskusji.

---

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

## Treści od AI (agent_notes) - API

Wpisy podpinane do zadań i komentarzy (polimorficzny `subject`). Działają tylko przy włączonej opcji `organize.task.agent_background` w ustawieniach Organizera.

### Nagłówek X-Agent

Agent wysyłający requesty powinien dodawać nagłówek `X-Agent: <nazwa>`. Wtedy przy `POST /organize/comments.json` treść z `content` trafia automatycznie do treści od AI (źródło `api` + nazwa agenta), a komentarz dostaje pustą treść. Przy `POST /organize/tasks.json` przeniesienie działa tylko, gdy podano osobny `title`.

### Jawne pole

W `task` i `comment` dostępny jest parametr `agent_note_content` (Markdown) - tworzy wpis obok treści głównej:

```json
{
  "comment": {
    "content": "Podsumowanie od człowieka",
    "agent_note_content": "## Analiza\n\nDługi wywód agenta...",
    "commentable_id": 123,
    "commentable_type": "Organize::Task"
  }
}
```

### Endpoints

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/noe/agent_notes.json?subject_type=Organize::Task&subject_id=ID` | lista wpisów obiektu (database ID) |
| GET | `/noe/agent_notes/:id.json` | pojedynczy wpis |
| POST | `/noe/agent_notes.json` | dodanie wpisu (`agent_note`: `content`, `subject_type`, `subject_id`) |
| PATCH | `/noe/agent_notes/:id.json` | aktualizacja (tylko autor) |
| DELETE | `/noe/agent_notes/:id.json` | usunięcie (tylko autor) |

### Odczyt

- `GET /organize/tasks/:sid.json` - zadanie zawiera tablicę `agent_notes`
- `GET /organize/tasks/:sid.md` - markdown zadania ma sekcję "Treści od AI" oraz treśćy przy komentarzach

---

## Powiązane

- [Zarządzanie zadaniami w Sugesterze - tworzenie, obsługa i wyszukiwanie](https://intum.intum.pl/kb/intum-kb-v1/organizacja/zadania.md)
