Dokumentacja Legion

1. Czym jest Legion

Legion to platforma do symulacji agentowych. Każdy aktor scenariusza jest osobnym agentem AI - z własną rolą opisaną w Markdown, własnymi celami i własnym modelem językowym. Agenci wymieniają wiadomości, negocjują, wywierają na siebie presję, podejmują decyzje, powołują nowych agentów albo odchodzą z gry, a Legion zapisuje każdą wiadomość i każdą decyzję tak, żeby przebieg dało się prześledzić, odtworzyć i porównać z innymi.

Aplikacja posługuje się ogólnymi pojęciami, które w symulacji mają konkretne znaczenie:

• Projekt - scenariusz (świat symulacji) z własnymi danymi wejściowymi i wyjściowymi, odizolowany od innych.
• Agent i jego rola - aktor scenariusza (persona, model AI pod obserwacją albo mistrz gry).
• Uruchomienie sieci agentów - pojedynczy przebieg symulacji.
• Oś czasu, historia uruchomień i podsumowanie - telemetria i zapis przebiegu.

Praca z systemem odbywa się w dwóch głównych miejscach: na stronie głównej (materiały informacyjne o systemie, formularz kontaktowy oraz rozmowa głosowa z asystentem AI - patrz sekcja 23) oraz w samej aplikacji, do której logujesz się i w której zarządzasz projektami, agentami i ustawieniami.

2. Zastosowania

Symulacja odpowiada na dwa rodzaje pytań: jak zachowa się system AI, zanim trafi do produkcji, i jak zareaguje otoczenie, zanim podejmiesz decyzję.

Zachowania AI

Scenariusze biznesowe

3. Jak działa Legion - krok po kroku

Od scenariusza do wniosków w trzech krokach - bez budowania własnego zaplecza do uruchamiania i obserwowania agentów.

Techniczny przebieg tych kroków - zakładanie projektu, konfiguracja agentów, uruchamianie sieci - opisują dalsze sekcje tej dokumentacji (8-10).

4. Możliwości silnika symulacji

Za każdą możliwością stoi konkretny mechanizm systemu, dostępny od razu.

5. Formy współpracy

Zakres współpracy dobieramy do scenariusza - po krótkiej rozmowie o tym, co chcesz sprawdzić.

• Wdrożenie platformy we własnej infrastrukturze lub wskazanej chmurze - dane zostają Twoje.
• Zaprojektowanie i przeprowadzenie symulacji przez nas, zakończone raportem z wnioskami.
• Dobór i integracja dostawców LLM - w chmurze lub lokalnie, także kilku modeli w jednym scenariuszu.
• Wsparcie przy projektowaniu kolejnych scenariuszy po wdrożeniu.

Aby porozmawiać o swoim scenariuszu, opisz go w formularzu na stronie głównej (sekcja „Kontakt”).

6. Najczęściej zadawane pytania (FAQ)

Krótkie odpowiedzi na pytania, które najczęściej pojawiają się przed wdrożeniem - te same, co w sekcji FAQ na stronie głównej.

Czym jest Legion?

Legion to platforma do symulacji agentowych: scenariuszy, w których agenci AI na różnych modelach podejmują decyzje, a każda wiadomość i decyzja jest zapisana i możliwa do odtworzenia.

Czym Legion różni się od frameworków agentowych?

Działa od razu: masz interfejs, telemetrię, oś czasu, replay i raporty. Nie musisz budować własnego zaplecza do uruchamiania i obserwowania agentów.

Jakich modeli mogę użyć?

Dowolnych dostępnych przez API zgodne z OpenAI - komercyjnych (np. OpenAI, Anthropic) lub lokalnych (np. Ollama). W jednej symulacji możesz mieszać modele różnych dostawców.

Czy wyniki są powtarzalne?

Modele językowe są niedeterministyczne, dlatego Legion pozwala uruchamiać serie tego samego scenariusza i porównywać przebiegi, zamiast opierać wnioski na jednym.

Gdzie trafiają dane?

Do Twojej infrastruktury. Legion jest wdrażany self-hosted, a pełna historia symulacji jest zapisana w plikach projektu, do których masz pełny dostęp.

7. Logowanie i konta

Dostęp do aplikacji wymaga zalogowania się na indywidualne konto. Każde konto ma przypisaną rolę, która określa zakres dostępnych działań.

Po zalogowaniu w prawym górnym rogu dostępny jest identyfikator zalogowanej osoby wraz z menu, z którego można zmienić własne hasło lub się wylogować. Ze względów bezpieczeństwa liczba nieudanych prób logowania w krótkim czasie jest ograniczona.

8. Projekty

Projekt to podstawowa jednostka pracy w Legion - wyodrębniony obszar roboczy z własnym zespołem agentów, własnymi danymi wejściowymi i wyjściowymi oraz własną historią wiadomości i uruchomień.

Nowy projekt zakłada się z poziomu paska bocznego, podając jego nazwę oraz opcjonalnie cel - opis tego, co zespół agentów ma osiągnąć. Aktywny projekt wybiera się z listy rozwijanej; wszystkie pozostałe ekrany aplikacji (agenci, wiadomości, dane, ustawienia) dotyczą zawsze projektu aktualnie wybranego.

Panel sterowania projektem

Nad listą agentów znajduje się panel z akcjami dotyczącymi całego projektu:

• Start - uruchamia sieć agentów. Przed startem system porządkuje projekt: czyści poprzednie wiadomości, logi, pamięć agentów i dane wyjściowe, tak aby każde uruchomienie zaczynało się od czystego stanu.
• Stop - zatrzymuje działającą sieć agentów w dowolnym momencie.
• Wznów - funkcja wznawiania przerwanego uruchomienia (obecnie tymczasowo wyłączona, wróci w kolejnej aktualizacji).
• Dane wejściowe / Dane wyjściowe - szybki dostęp do plików projektu (opisane w dalszych sekcjach).
• Zmień model wszystkim - pozwala jednym działaniem zmienić dostawcę i model językowy używany przez wszystkich agentów w projekcie naraz.
• Harmonogram - otwiera ustawienia automatycznego uruchamiania projektu.
• Podsumowanie - pokazuje statystyki zakończonego lub trwającego uruchomienia.
• Wyczyść dane projektu - resetuje wiadomości, logi i dane wyjściowe projektu, zachowując konfigurację agentów.
• Usuń projekt - trwale usuwa projekt wraz z jego danymi.

Status sieci jest zawsze widoczny jako odznaka („sieć: zatrzymana” / uruchomiona), a w trakcie pracy dodatkowo pokazywane jest zużycie tokenów przez sieć od momentu jej uruchomienia.

9. Agenci i role

Agent to uczestnik zespołu - wirtualny „pracownik” z przypisaną rolą, opisem obowiązków i własną konfiguracją modelu językowego.

Każdy agent posiada nazwę, opis roli (czym się zajmuje i jakie ma zadania w zespole) oraz indywidualnie wybrany dostawca i model AI - dzięki temu różni agenci w tym samym projekcie mogą korzystać z różnych modeli, dobranych do charakteru ich pracy. Agentów dodaje się, edytuje i usuwa z poziomu siatki agentów w widoku projektu.

Przy tworzeniu nowego agenta można skorzystać z zapisanego wcześniej szablonu (patrz sekcja 20 - Panel administracyjny) - automatycznie uzupełni on nazwę, treść roli oraz domyślnego dostawcę i model, które można jeszcze dowolnie zmienić przed zapisaniem agenta.

Jeden z agentów może pełnić specjalną rolę menedżera procesu - koordynatora, który rozdziela zadania pomiędzy pozostałych agentów; taka karta jest wyróżniona wizualnie w siatce agentów. W trakcie pracy sieci dostępna jest opcja wysłania do menedżera procesu wiadomości natychmiastowej, która zostanie obsłużona w pierwszej kolejności, przed innymi zaległymi wiadomościami w kolejce.

10. Uruchamianie sieci agentów

„Sieć agentów” to uruchomiony zespół danego projektu - od momentu startu agenci wymieniają się wiadomościami i wykonują swoje zadania samodzielnie, bez dalszej ingerencji z Twojej strony.

Po uruchomieniu widok projektu aktualizuje się na bieżąco: karty agentów pokazują, kto aktualnie pracuje, oś czasu wypełnia się nowymi wiadomościami, a licznik tokenów rośnie wraz z postępem pracy. Jeśli w trakcie działania pojawi się błąd któregoś z agentów lub usługi, na której polega (np. brak połączenia z wybranym dostawcą modelu), zostanie on pokazany w widocznej liście błędów usługi nad siatką agentów.

Sieć kończy działanie samodzielnie, gdy agenci uznają zadanie za wykonane, albo można ją zatrzymać ręcznie przyciskiem Stop w dowolnym momencie.

11. Oś czasu wiadomości

Wszystkie wiadomości wymieniane między agentami danego projektu są rejestrowane i widoczne w chronologicznej osi czasu.

Każda wiadomość ma jeden z trzech statusów: nowa (oczekuje na odebranie), w trakcie (agent aktualnie ją przetwarza) lub zakończona. Nad listą widoczne są zbiorcze liczniki dla każdego statusu - kliknięcie licznika filtruje listę do wiadomości w danym stanie. Kliknięcie pojedynczej wiadomości otwiera jej pełną treść, nadawcę, odbiorcę i znacznik czasu.

12. Aktywność narzędzi

Osobna sekcja pokazuje w czasie rzeczywistym, które narzędzie i przez którego agenta jest aktualnie wykorzystywane.

Dzięki temu widać na żywo, że np. agent Developer w tej chwili zapisuje plik, a agent CEO wysyła e-mail - co jest szczególnie przydatne przy diagnozowaniu, na czym sieć aktualnie „utknęła”, jeśli praca trwa dłużej niż oczekiwano.

13. Dane wejściowe

Pliki wejściowe to materiały, które przekazujesz zespołowi agentów przed uruchomieniem projektu - specyfikacje, briefy, dane referencyjne czy dokumenty źródłowe.

Panel „Dane wejściowe” pozwala dodawać nowe pliki tekstowe, przeglądać i edytować istniejące oraz je usuwać. Agenci mają do tych plików dostęp przez cały czas trwania sieci - mogą je odczytać w dowolnym momencie, jeśli zajdzie taka potrzeba.

14. Dane wyjściowe

Wszystko, co agenci wygenerują - kod, raporty, pliki tekstowe, obrazy - trafia do folderu danych wyjściowych projektu, zorganizowanego w podfoldery zgodnie z tym, jak zdecydowali agenci.

Panel „Dane wyjściowe” pozwala przeglądać tę strukturę katalogów, otwierać podgląd plików (w tym obrazów) oraz pobierać je na dysk. Pliki w formacie Markdown (.md) oraz HTML (.html) można dodatkowo wyeksportować bezpośrednio do formatu PDF, gotowego np. do przesłania dalej - pliki HTML są renderowane tak, jak wyglądają w przeglądarce, wraz ze stylami i układem strony.

15. Historia uruchomień

System zachowuje pełną historię wszystkich uruchomień sieci agentów, dla wszystkich projektów.

Historia jest dostępna w oknie „Harmonogramy sieci” (ikona 📅 w panelu bocznym), pod listą harmonogramów. Pokazuje osobno uruchomienia aktualnie trwające oraz archiwalne, z możliwością filtrowania po zakresie dat (lub szybkiego filtra „Dziś”). Dla każdego uruchomienia widoczny jest projekt, czas trwania, zużycie tokenów i status zakończenia.

16. Harmonogramy

Zamiast uruchamiać sieć ręcznie, projekt można zaplanować do automatycznego startu.

Harmonogram można ustawić jako jednorazowy (konkretna data i godzina) albo cykliczny - z interwałem podawanym w minutach, godzinach, dniach, tygodniach lub miesiącach. Podobnie jak ręczny start, każde zaplanowane uruchomienie najpierw porządkuje projekt (czyści wiadomości, logi, pamięć i dane wyjściowe), a następnie startuje sieć agentów automatycznie, bez potrzeby obecności użytkownika. Zbiorczy widok harmonogramów pokazuje wszystkie zaplanowane uruchomienia we wszystkich projektach naraz.

17. Podsumowanie działania sieci

Po zakończeniu (lub w trakcie) pracy sieci dostępny jest ekran podsumowania z kluczowymi statystykami danego uruchomienia.

Podsumowanie zawiera m.in. łączne zużycie tokenów w podziale na poszczególnych agentów, zestawienie tego, które narzędzia i jak często były wykorzystywane, oraz ogólne dane o czasie trwania i liczbie wymienionych wiadomości.

18. Czat testowy (Playground)

Playground to niezależny czat, w którym można porozmawiać bezpośrednio z wybranym modelem AI w kontekście danego projektu, z pełnym dostępem do tych samych narzędzi, którymi dysponują agenci - łącznie z podłączonymi integracjami zewnętrznymi.

Służy przede wszystkim do szybkiego sprawdzenia, jak konkretny model lub narzędzie zachowa się w praktyce, zanim skonfiguruje się docelowego agenta - bez potrzeby uruchamiania całej sieci. Sesję rozpoczyna się, wybierając projekt (czyli folder roboczy, do którego czat będzie miał dostęp), dostawcę modelu oraz konkretny model.

19. Narzędzia dostępne agentom

Każdy agent samodzielnie decyduje, kiedy i jak skorzystać z poniższych narzędzi w trakcie realizacji swojego zadania. Zestaw narzędzi nie jest zamknięty - każdemu agentowi można dodatkowo podłączyć własne integracje zewnętrzne.

Operator decyduje, z których narzędzi mogą korzystać agenci danego projektu, w panelu 🧰 Narzędzia dostępnym z menu akcji projektu - przełącznik przy każdym narzędziu, plus zbiorcze „Włącz wszystkie” / „Wyłącz wszystkie”. Narzędzia oznaczone jako zawsze włączone (send_message_to_agent, check_new_messages) nie mają przełącznika - sieć agentów nie działa bez nich.

Nowo tworzony projekt ma domyślnie wszystkie narzędzia wyłączone - łącznie z tymi, które zostaną dodane do tego zestawu w przyszłości - operator sam decyduje, które z nich odblokować. Projekty utworzone przed wprowadzeniem tego ustawienia zachowują dotychczasowe zachowanie: wszystkie narzędzia włączone, poza tymi, które ktoś wyłączył ręcznie.

20. Panel administracyjny

Panel administracyjny (dostępny dla kont z rolą Administrator) zbiera w jednym miejscu ustawienia obowiązujące w całej aplikacji, niezależnie od pojedynczego projektu.

Użytkownicy

Zarządzanie kontami: dodawanie nowych użytkowników, edycja danych, przypisywanie roli (Administrator / Editor / Reader) oraz dezaktywacja lub usuwanie kont, które nie są już potrzebne.

Dostawcy LLM

Zapisane połączenia do modeli językowych (np. OpenAI, Anthropic albo lokalnie uruchomiony model), z których mogą korzystać projekty i agenci. Dla każdego dostawcy podaje się adres API oraz klucz dostępowy, dzięki czemu staje się on dostępny do wyboru przy konfiguracji agentów.

Web search

Konfiguracja usługi wyszukiwania internetowego wykorzystywanej przez narzędzie wyszukiwania agentów - klucz dostępowy oraz maksymalna liczba wyników zwracanych dla jednego zapytania.

Email (SMTP)

Konfiguracja serwera pocztowego, przez który agenci wysyłają wiadomości e-mail: host, port, dane logowania, adres nadawcy oraz opcja szyfrowanego połączenia. Ustawienia można zweryfikować, wysyłając wiadomość testową na wskazany adres.

Asystent głosowy (Gemini Live)

Konfiguracja asystenta głosowego dostępnego na stronie głównej (opisanego szerzej w sekcji 23): wyłącznik pozwalający natychmiast zablokować nowe rozmowy, klucz API i model Gemini Live, instrukcja systemowa określająca styl i wiedzę asystenta, opcjonalny wybór głosu oraz limity chroniące przed nadmiernymi kosztami - maksymalny czas pojedynczej rozmowy oraz maksymalna liczba równoczesnych rozmów (łącznie i na jeden adres IP). Przycisk „Testuj połączenie” sprawdza, czy podany klucz API i model faktycznie nawiązują sesję z Gemini Live.

Serwery MCP

Lista zewnętrznych serwerów integracyjnych rozszerzających możliwości agentów o dodatkowe narzędzia i źródła danych - z adresem serwera oraz wymaganymi nagłówkami uwierzytelniającymi.

Szablony agentów

Gotowe zestawy startowe do tworzenia nowych agentów: nazwa, treść roli oraz domyślny dostawca i model AI. Szablon wybiera się z listy podczas dodawania nowego agenta w projekcie - uzupełnia on pola formularza, które nadal można dowolnie zmienić przed zapisaniem.

Bazy wiedzy i model embeddingowy

Zarządzanie bazami wiedzy (opisane szerzej w kolejnej sekcji) oraz konfiguracja modelu, który zamienia treści dokumentów na reprezentację wykorzystywaną przy wyszukiwaniu semantycznym.

Wiadomości stron

Podgląd wiadomości publikowanych dla poszczególnych stron (kategoria, tytuł, data utworzenia, status Aktualna lub Nieaktualna) - najnowsze wpisy pokazują się jako pierwsze. Listę można zawęzić do jednej strony, wybierając jej klucz z listy rozwijanej. Pełną treść wiadomości widać po najechaniu kursorem na wiersz.

21. Bazy wiedzy

Baza wiedzy to zbiór dokumentów, które agenci mogą przeszukiwać nie tylko po dopasowaniu słów, ale po znaczeniu treści.

Dzięki skonfigurowanemu modelowi embeddingowemu system potrafi wskazać agentowi fragmenty dokumentów najbardziej związane tematycznie z zadanym pytaniem, nawet jeśli nie zawierają dokładnie tych samych słów co zapytanie. Bazy wiedzy tworzy się i zarządza nimi z poziomu panelu administracyjnego - mogą powstać osobne bazy dla różnych dziedzin czy projektów.

22. Wygląd i dostępność

Cały interfejs - od strony logowania po panel administracyjny - dostępny jest w motywie ciemnym i jasnym.

Przełącznik motywu (ikona 🌙 / ☀️) znajduje się zarówno na ekranie logowania, jak i w górnym pasku aplikacji. Wybrany motyw jest zapamiętywany i stosowany automatycznie przy kolejnych wizytach. Interfejs dostosowuje się również do węższych ekranów urządzeń mobilnych.

23. Asystent głosowy na stronie głównej

Przycisk „Rozmowa” w górnym pasku strony głównej, obok „Kontakt”, otwiera panel rozmowy głosowej z Leonem - asystentem AI opartym o Gemini Live (Google), odpowiadającym na pytania odwiedzających o system Legion.

Po kliknięciu „Rozpocznij rozmowę” przeglądarka prosi o dostęp do mikrofonu, a Leon pierwszy zabiera głos krótkim powitaniem. Dla najlepszej jakości dźwięku (bez echa własnego głosu) zalecane są słuchawki. Treść rozmowy nie jest wyświetlana na ekranie - panel pokazuje tylko status połączenia oraz pasek postępu z pozostałym czasem.

Każda rozmowa ma ustawiony maksymalny czas trwania (patrz sekcja 20 - Panel administracyjny); pasek postępu w panelu pokazuje, ile czasu zostało i o której godzinie rozmowa zostanie automatycznie zakończona. Ze względu na koszty rozmów głosowych liczba jednoczesnych połączeń - zarówno łącznie, jak i z jednego adresu IP - jest również ograniczona; po wyczerpaniu limitu panel informuje o tym wprost i podpowiada odczekanie kilku minut przed ponowną próbą.