[Intum](https://intum.pl/pomoc.md) / [Organizacja](https://intum.pl/pomoc/organizacja.md)

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

Gdy do zadań trafiają całe odpowiedzi wklejone z ChatGPT albo Claude, robią się z nich ściany tekstu, których nikt nie czyta. Treści od AI rozwiązują ten problem: wklejka ląduje w osobnym, domyślnie zwiniętym bloku pod treścią, a samo zadanie pozostaje krótkie i czytelne.

## Jak włączyć

Opcja jest domyślnie wyłączona. Włączysz ją w ustawieniach Organizera (Zadania - Ustawienia), zaznaczając "Treści od AI w zadaniach i komentarzach". Ustawienie działa dla całej firmy.

## Jak dodać treść od AI

Po włączeniu opcji w formularzu zadania i komentarza, pod polem treści, pojawia się zwijany odnośnik "Dodaj treść od AI". Kliknij go, wklej tekst z AI, a własne podsumowanie napisz normalnie w polu treści. Po zapisaniu treść pokaże się jako zwinięty blok "Treść od AI" z informacją, kto i kiedy go dodał.

Do jednego zadania można dodawać kolejne treśćy w miarę pracy - każdy będzie osobnym blokiem.

## Jak to wygląda dla czytających

Treść zadania i komentarze wyglądają jak zwykle. Treści od AI są zwinięte i rozwijasz je tylko wtedy, gdy chcesz zajrzeć do źródła. Na listach zadań, w powiadomieniach i skrótach widać wyłącznie treść napisaną przez człowieka.

Wyszukiwarka zadań przeszukuje także treść treści, więc zadanie znajdziesz również po tym, co jest w wklejce.

## Usuwanie i przegląd

Treść może usunąć jego autor albo osoba z uprawnieniem do edycji komentarzy - przycisk Usuń jest w rozwiniętym bloku. Wszystkie treśćy w firmie przejrzysz na liście w module Noe, w pozycji "Treści od AI".

## Dobra praktyka

Treść od AI to tło, nie treść. Zanim go wkleisz, napisz od siebie 2-3 zdania: co z treści wynika i czego oczekujesz. Osoba, która ma 30 sekund, powinna zrozumieć zadanie bez rozwijania wklejki.

Więcej o tym, dlaczego warto tak pracować z treściami od AI: [Treści z AI w zadaniach - jak wklejać, żeby dało się je czytać](https://intum.dev/ai-w-praktyce/tresci-z-ai-w-zadaniach).

---

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

- [AI](https://intum.pl/pomoc/organizacja/ai.md)
- [Zadania](https://intum.pl/pomoc/organizacja/zadania.md)