[Intum Pomoc](https://intum.pl/pomoc.md) / [Prompty, przycisk AI i agenci](https://intum.pl/pomoc/noe/prompty-przycisk-ai-i-agenci.md)

# [Agenci AI](https://intum.pl/pomoc/noe/noe-agenci.md)

Ekran agenta daje agentowi AI wejście na konto: gotowy **prompt startowy** z tokenem, który
wklejasz do narzędzia takiego jak Claude Code, oraz **prompt master** z instrukcjami, które
agent pobiera przy każdym przebiegu. Ten sam ekran służy do dwóch różnych rzeczy - warto
na początku zdecydować, o którą chodzi.

> [!PATH]
> [Noe → Agenci AI](app:/noe/agents)
> [Konto → Użytkownicy](app:/account/users) → *użytkownik* → **Agent**

## Dwa zastosowania

**Użytkownik-agent.** Dodajesz na koncie osobnego użytkownika (np. „Asystent sprzedaży"),
oznaczasz go jako agenta i uruchamiasz u siebie agenta AI z jego promptem startowym. Od tej
chwili działa on sam: co ustalony czas budzi się, pobiera instrukcje i wykonuje zadania,
które ludzie mu przypisują w Organizerze. Ma własną rolę, własny token i własne wpisy
w historii konta - jak każdy współpracownik. Tak buduje się stałego pomocnika zespołu.

**Zwykły użytkownik ze swoim agentem.** Ty, jako człowiek, uruchamiasz u siebie Claude Code
albo inne narzędzie i chcesz, żeby zrobiło coś na koncie w Twoim imieniu: przejrzało
zgłoszenia, uporządkowało bazę, założyło aplikację. Wchodzisz na własny ekran agenta,
kopiujesz prompt startowy i wklejasz. Agent działa Twoimi uprawnieniami i podpisuje się
Tobą, a gdy skończysz, po prostu go zamykasz. Nie trzeba niczego oznaczać ani konfigurować -
własny ekran agenta ma każdy użytkownik.

Różnica sprowadza się do tego, kto trzyma agenta uruchomionego: w pierwszym przypadku
działa stale i sam, w drugim tylko wtedy, gdy Ty go odpalasz.

## Użytkownik-agent krok po kroku {#uzytkownik-agent-krok-po-kroku}

1. Załóż użytkownika na koncie (Konto → Użytkownicy) i nadaj mu **rolę** z takimi
   uprawnieniami, jakie agent ma mieć. Token agenta dostaje dokładnie te uprawnienia.
2. Na karcie użytkownika kliknij **Agent**. Zaznacz **Ten użytkownik jest agentem** i ustaw
   **Co ile wykonuje przebieg** - od kilku minut do raz na dobę. Zapisz.
3. Zaloguj się jako ten użytkownik (przejście **zaloguj jako** z karty użytkownika jest
   zapisywane w historii) i wejdź na jego ekran agenta. Dopiero właściciel ekranu widzi
   prompt startowy z tokenem - administracja konta widzi w tym miejscu tylko puste pole
   na token.
4. **Kopiuj do schowka** i wklej prompt do narzędzia-agenta uruchomionego tam, gdzie ma
   pracować (własny komputer, serwer). Agent pobierze prompt master i zacznie pierwszy przebieg.
5. Daj mu zadanie w Organizerze - [Jak pracuje agent](noe/noe-praca-agenta).

Lista [Agenci AI](app:/noe/agents) pokazuje wszystkich użytkowników oznaczonych jako agenci
z ich harmonogramem. Jeśli jest pusta, prowadzi do listy użytkowników.

## Kto to jest i kod agenta

Na górze ekranu agenta stoi karta z tym, czyj to ekran: nazwa, login, rola i oznaczenie, czy
to użytkownik-agent, czy zwykły użytkownik. Jest tam też **Kod agenta** - krótki identyfikator,
domyślnie „agent_" i numer użytkownika. Agent dopisuje go do każdego zapytania w nagłówku
`X-Agent`, więc zadania, komentarze i [treści od AI](noe/noe-tresci-od-ai) mają podpis, od
którego agenta pochodzą, a agent pracujący z kolejki zadań odbiera po nim swoje zadania.
Kod nie jest sekretem - sekretem jest token.

## Prompt startowy

Krótki tekst do jednorazowego wklejenia: kim agent jest, skąd pobrać prompt master, jakim
tokenem się posługiwać i co ile minut wracać do pracy. Zmienne (adres konta, token, nazwa
agenta, interwał) podstawiają się same. Prompt zawiera token, więc traktuj go jak hasło.

Ikona zębatki obok przycisku kopiowania otwiera edycję treści w [Promptach](noe/noe-prompty),
w zakresie tego użytkownika. Zmieniony prompt ma na ekranie znacznik **Zmieniony**.

## Prompt master

Właściwe instrukcje: co robić w przebiegu, komu oddawać zadania, czego nie wolno. Agent
pobiera go na początku każdego przebiegu, więc poprawka działa od następnego uruchomienia.
Edytujesz go wprost na ekranie agenta i zapisujesz przyciskiem **Zapisz**; wyczyszczenie pola
przywraca treść domyślną. Zębatka obok prowadzi do tego samego prompta w Promptach.

Prompt master to dobre miejsce na zasady konta: „odpowiadaj po polsku", „nie ruszaj faktur",
„przy klientach z segmentu A zawsze dopisz osobę prowadzącą".

## Przycisk AI na ekranie agenta

Administracja konta ma na ekranie agenta przycisk AI z promptem, który instruuje agenta AI,
jak założyć albo poprawić prompt startowy i master tego użytkownika: pobrać wersję domyślną,
dopisać zasady, zapisać we właściwym zakresie, nie ruszając tokena i roli. Dopisujesz w nim,
co ma się zmienić, i wklejasz do swojego narzędzia - jak przy każdym [przycisku AI](noe/noe-przycisk-ai).

## Token {#token}

Token agenta powstaje przy pierwszym wejściu właściciela na ekran i jest ważny trzy miesiące.
Sekcja **Token API** pokazuje jego nazwę i termin ważności; wartość widzi wyłącznie
właściciel, w treści prompta startowego.

- **Przedłuż token** - przesuwa termin bez zmiany tokena, agent pracuje dalej na tym, co ma.
- **Unieważnij token** - kasuje token; agent traci dostęp natychmiast. Nowy powstanie, gdy
  właściciel wejdzie tu po świeży prompt.
- Po wygaśnięciu tokena agent przestaje działać. Wejdź na ekran po nowy prompt i wklej go
  ponownie.

Token wydawany z ekranu agenta jest niezależny od ustawienia **Token agenta AI**
w [Ustawieniach Noe](noe/noe-ustawienia) - to ustawienie dotyczy tokenów w promptach
przycisku AI.

## Gdy coś nie działa {#gdy-cos-nie-dziala}

- **Agent nie może się zalogować / dostaje błąd autoryzacji** -
  [Agent stracił dostęp do konta](noe/noe-problem-agent-stracil-dostep).
- **Użytkownik-agent nie odbiera przypisanych mu zadań** -
  [Agent nie robi przypisanych mu zadań](noe/noe-problem-agent-nie-robi-zadan).