[Intum](https://intum.fr/aide.md) / [Organizacja](https://intum.fr/aide/organizacja.md)

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

## AI w module Organizacja

Moduł Organizacja wykorzystuje sztuczną inteligencję w kilku miejscach — od poprawy pisowni po automatyczne generowanie raportów pracy na podstawie aktywności systemowych i commitów z repozytoriów Git.

---

## AI w edytorze zadań

Przy tworzeniu lub edycji zadania edytor treści ma wbudowany **przycisk AI**. Wystarczy wpisać ogólny opis zadania — np. *"zrób landing page dla nowego produktu"* — a AI przekształci go w uporządkowany opis z:

- Celem zadania
- Krokami do wykonania
- Kryteriami akceptacji

AI automatycznie formatuje tekst w Markdown, poprawia błędy językowe i nadaje profesjonalną strukturę.

## AI w komentarzach

Przy dodawaniu komentarza do zadania również dostępny jest przycisk AI. Wpisz szkic komentarza, a AI poprawi go — nada profesjonalny ale bezpośredni ton, poprawi pisownię i gramatykę, zachowa zwięzłość.

## Toolbar edytora — poprawki i uładnianie

Każdy edytor tekstu w module Organizacja (zadania, komentarze, workinfo) ma w pasku narzędzi rozwijane menu AI z trzema opcjami:

- **Popraw pisownię i gramatykę** — szybka korekta bez zmian w treści
- **Uładnij z minimalnymi zmianami** — delikatna poprawa stylu i czytelności
- **Kreatywne AI** — pełna przeróbka treści na podstawie opisu lub instrukcji

---

## AI w edytorze WorkInfo

Przy ręcznym wypełnianiu raportu pracy (WorkInfo) edytor treści ma przycisk AI. Wpisz luźne notatki — np. *"robiłem review PR-ów, poprawiałem bugi w module mail, spotkanie z zespołem"* — a AI przekształci je w czytelny, profesjonalny raport pracy.

---

## Agent AI do automatycznego generowania WorkInfo

To najbardziej zaawansowana funkcja AI w module Organizacja. Na stronie tworzenia i podglądu WorkInfo dostępny jest **przycisk Agent AI**, który automatycznie wypełnia raport pracy za wybrany dzień.

### Jak działa?

Po kliknięciu przycisku AI agent:

1. **Pobiera aktywności systemowe** za dany dzień — zadania które stworzyłeś, edytowałeś, zamknąłeś, komentarze, wysłane e-maile, wiadomości na czacie
2. **Pobiera commity z Git** (jeśli skonfigurowane) — analizuje co zostało zmienione w repozytoriach
3. **Oblicza czas pracy** — na podstawie pierwszej i ostatniej aktywności w ciągu dnia
4. **Generuje raport** — grupuje aktywności tematycznie, tworzy zwięzły opis wykonanej pracy w Markdown
5. **Zapisuje wpis** — tworzy nowy WorkInfo lub aktualizuje istniejący

### Inteligentne przerwy

Jeśli między aktywnościami jest przerwa dłuższa niż 30 minut, agent tworzy **osobne wpisy** dla każdego bloku pracy — np. osobny wpis na poranną i popołudniową sesję.

### Rozpoznawanie Pull Requestów

Agent rozróżnia:
- **Twoje PR-y** — pull requesty, które sam stworzyłeś
- **Zmerge'owane PR-y** — pull requesty innych osób, które zatwierdziłeś

---

## Konfiguracja repozytoriów Git

Aby agent AI mógł uwzględniać commity przy generowaniu WorkInfo, administrator musi skonfigurować linki do repozytoriów:

1. Przejdź do **Organizacja → Ustawienia**
2. W sekcji **Repozytoria Git** wpisz adresy URL — jeden na linię

### Obsługiwane formaty

```
https://github.com/firma/projekt1
https://github.com/firma/projekt2
https://gitlab.com/firma/projekt
```

### Wildcard dla organizacji

Można użyć znaku `*` aby automatycznie uwzględnić **wszystkie repozytoria** w organizacji GitHub:

```
https://github.com/mojafirma/*
```

Agent sam pobierze listę repozytoriów i przeszuka je pod kątem commitów danego użytkownika.

---

## Podsumowanie

- **Edytor zadań** — przycisk AI strukturyzuje opis zadania
- **Komentarze** — przycisk AI poprawia ton i pisownię
- **Toolbar edytora** — korekta pisowni, uładnianie, kreacja
- **Edytor WorkInfo** — formatuje luźne notatki w raport
- **WorkInfo Agent** — auto-generuje raport z aktywności systemowych i commitów Git

---

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