# Agenci

## Czym są agenci?

Agenci to izolowani asystenci AI, którzy rozwiązują problemy, wykonują zadania i komunikują się na wielu platformach. Każdy agent ma własną przestrzeń roboczą, historię sesji, konfigurację modelu i powiązania z kanałami.

## Izolacja agentów

Każdy agent otrzymuje:

- **Przestrzeń robocza** -- Dedykowany katalog dla plików, notatek i danych specyficznych dla agenta
- **Sesje** -- Niezależna historia rozmów i transkrypty
- **Konfiguracja** -- Wybór modelu, uprawnienia narzędzi, limity wydatków
- **Tożsamość** -- Unikalna persona zdefiniowana w pliku `AGENTS.md` agenta
- **Profile uwierzytelniania** -- Konfiguracje kluczy API i uwierzytelniania per agent

## Persony agentów

Przestrzeń robocza każdego agenta zawiera plik `AGENTS.md`, który definiuje osobowość, instrukcje i wytyczne behawioralne. Ten trwały prompt systemowy kształtuje sposób odpowiadania agenta -- ton, wiedzę domenową, formatowanie, użycie narzędzi i zasady bezpieczeństwa.

## Kierowanie wieloagentowe

Podczas uruchamiania wielu agentów przychodzące wiadomości są automatycznie kierowane na podstawie **powiązań**:

- **Powiązanie kanału** -- Kieruj wszystkie wiadomości z platformy (np. wszystkie Telegram → agent `osobisty`)
- **Powiązanie serwera/przestrzeni roboczej** -- Kieruj konkretny serwer Discord lub przestrzeń roboczą Slack do dedykowanego agenta
- **Powiązanie typu czatu** -- Kieruj wiadomości prywatne do jednego agenta, a wiadomości grupowe do innego
- **Powiązanie kontaktu/peera** -- Kieruj wiadomości od konkretnych kontaktów do konkretnych agentów

Powiązania są oceniane w kolejności priorytetów. Wygrywa pierwsze dopasowanie. Niedopasowane wiadomości trafiają do domyślnego agenta.

## Podagenci i delegowanie

Agenci mogą tworzyć podagentów do wyspecjalizowanych zadań:

- **Delegowanie zadań** -- Rozkładaj złożone zadania i deleguj części do wyspecjalizowanych podagentów
- **Izolowane wykonanie** -- Podagenci działają w swoim własnym kontekście sesji
- **Rozmowy ping-pong** -- Agenci mogą prowadzić wymiany tam i z powrotem (do 5 tur), aby współpracować
- **Ogłaszanie wyników** -- Wyniki podagentów mogą być publikowane z powrotem do oryginalnego kanału

## Zespoły i orkiestracja

Wieloagentowe zespoły umożliwiają skoordynowane przepływy pracy:

- **Równoległe wykonanie** -- Uruchamiaj wielu agentów jednocześnie nad różnymi aspektami zadania
- **Sekwencyjne potoki** -- Łącz agentów, gdzie każdy buduje na poprzednim wyjściu
- **Tryb hybrydowy** -- Łącz wykonanie równoległe i sekwencyjne
- **Śledzenie zadań** -- Monitoruj status pracy każdego agenta (w kolejce, uruchomione, ukończone, błąd, anulowane)

## Profile narzędzi

Kontroluj, co każdy agent może robić:

| Profil | Dostępne narzędzia |
|--------|-------------------|
| **minimalny** | Tylko status sesji |
| **kodowanie** | We/Wy pliku, wykonanie, sesje, pamięć, obrazy |
| **komunikacja** | Wysyłanie wiadomości, historia sesji |
| **pełny** | Wszystkie narzędzia (domyślnie) |

Niestandardowe listy dozwolone/zabronione mogą być ustawiane per agent i per dostawca modelu.

## Tryb bezpieczny

Tryb bezpieczny zapewnia piaskownicę wykonawczą:

- **Główny przełącznik** -- Włącz lub wyłącz globalnie
- **Kontrole per agent** -- Wyłącz dla zaufanych agentów, pozostaw włączone dla innych
- **Zatwierdzanie wykonania** -- Wrażliwe operacje wymagają wyraźnej zgody użytkownika
- **Synchronizacja zasad** -- Ustawienia synchronizowane we wszystkich połączonych klientach w czasie rzeczywistym

## Pamięć agenta

Każdy agent ma dostęp do systemu pamięci:

- **MEMORY.md** -- Trwałe notatki i ważne informacje między sesjami
- **Pliki pamięci** -- Dodatkowa ustrukturyzowana wiedza w katalogu `memory/`
- **Wyszukiwanie wektorowe** -- Przeszukaj pamięć za pomocą zapytań w języku naturalnym

Szczegółowe informacje znajdziesz w artykule [Sesje i pamięć](sessions-memory.md).