Terminal Agent (Agent terminalowy)

1. Przegląd koncepcji i problem systemowy

Graficzne edytory kodu (VS Code, JetBrains) świetnie sprawdzają się przy lokalnym tworzeniu interfejsów, ale okazują się całkowicie bezradne w przypadku administracji systemowej, debugowania klastrów chmurowych, pracy na zdalnych serwerach czy automatyzacji pipeline'ów CI/CD. Inżynierowie muszą logować się przez SSH, ręcznie przypominać sobie złożone konstrukcje składniowe awk, sed, grep, systemctl oraz pisać kruche skrypty bash do jednorazowych operacji.

Terminal Agent (agent terminalowy) przenosi inteligencję modelu językowego bezpośrednio do powłoki systemowej (Bash, Zsh, Fish). Traktuje on wiersz poleceń jako natywne środowisko wykonania: analizuje system plików, samodzielnie uruchamia komendy, przechwytuje strumienie wyjścia STDOUT i STDERR, odczytuje status zakończenia (Exit Code) i iteracyjnie koryguje własne błędy aż do osiągnięcia wymaganego stanu systemu.

2. Taksonomia architektoniczna i model mentalny

Szkielet architektoniczny agenta terminalowego opiera się na podsystemie pseudo-terminalowym i socketach strumieniowych:

┌─────────────────────────────────────────────────────────────┐
│                 ARCHITEKTURA AGENTA TERMINALOWEGO           │
├─────────────────────────────────────────────────────────────┤
│ 1. Host CLI / TUI (binaria Node.js / Rust / Go)             │
│    • Pseudoterminal PTY (node-pty, portable-pty)            │
│    • Zarządzanie strumieniami wejścia-wyjścia STDIN/STDOUT  │
├─────────────────────────────────────────────────────────────┤
│ 2. Kontroler podprocesów i sygnałów                         │
│    • Limit czasowy procesów oraz limity bufora (Anti-Flood) │
│    • Obsługa sygnałów SIGINT / SIGTERM / SIGHUP             │
├─────────────────────────────────────────────────────────────┤
│ 3. Warstwa wiązania narzędzi                                │
│    • Narzędzia systemu plików (dokładne fragmenty dopasowania, │
│      zastępowanie AST)                                      │
│    • Narzędzie wykonania powłoki (w środowisku nieinteraktywnym) │
│    • Inspektor środowiska (uname, whoami, pwd, git status)  │
├─────────────────────────────────────────────────────────────┤
│ 4. Silnik wnioskowania: pętla ReAct z analizą kodu wyjścia  │
└─────────────────────────────────────────────────────────────┘

1. Emulator pseudo-terminala (Warstwa PTY):
   • Emuluje zachowanie prawdziwego terminala (TTY). Pozwala to programom (np. git diff lub kolorowym narzędziom testującym) działać poprawnie z obsługą kolorów ANSI.
2. Kontroler strumieni i ochrona bufora (Buffer & Truncation Manager):
   • Zapobiega utracie kontekstu modelu, gdy komenda zwraca megabajty tekstu (np. przypadkowy dump gigabajtowego logu). Tekst jest przycinany do rozsądnego limitu (pierwsze i ostatnie 100 linii) wraz z metadanymi rozmiaru.
3. Zmienne środowiskowe nieinteraktywne:
   • Automatyczne montowanie flag TERM=dumb, PAGER=cat, GIT_TERMINAL_PROMPT=0 w celu zagwarantowania, że żadne narzędzie nie zablokuje procesu oczekiwaniem na naciśnięcie klawisza.
4. Ewaluator kodów wyjścia (Exit Code Evaluator):
   • Status 0 interpretowany jest jako sukces; status != 0 automatycznie przekazuje błąd do kolejnej pętli rozumowania modelu w celu autokorekty.

3. Pipeline techniczny i mechanika wewnętrzna

Cykl życia wykonania komendy inżynierskiej w agencie terminalowym:

1. Zbieranie kontekstu środowiska systemowego: Przed pierwszym zapytaniem agent wykonuje lekką diagnostykę: bieżącą ścieżkę (pwd), aktywną gałąź (git branch --show-current), system operacyjny (uname -a) oraz dostępne menedżery pakietów.
2. Tłumaczenie języka naturalnego na sekwencję komend shell: Inżynier wpisuje: „Znajdź wszystkie porzucone obrazy Docker zajmujące miejsce i usuń je, ale nie ruszaj kontenerów projektu gotburnout”.
3. Generowanie strukturalnego wywołania: Model generuje konkretną komendę:

   docker image prune -a --filter "until=168h" --force
   

4. Warstwa bezpieczeństwa i potwierdzenia (Safety Interceptor): Jeśli komenda zawiera modyfikację dysku lub sieci, agent wyświetla ją użytkownikowi z kolorowym podświetleniem składni i żąda potwierdzenia.
5. Wykonanie w procesie potomnym (Child Process Execution): Komenda jest wykonywana z ustawionym timeoutem (np. maksymalnie 60 sekund). Strumienie wyjścia są przesyłane do terminala użytkownika w czasie rzeczywistym.
6. Analiza wyniku i dalsze działania: Jeśli komenda zakończyła się sukcesem, agent raportuje ilość zwolnionego miejsca na dysku. Jeśli wystąpił błąd uprawnień (permission denied), agent proponuje poprawne rozwiązanie bez ślepego uruchamiania niebezpiecznego sudo.

4. Praktyczne scenariusze inżynierskie w produkcji

01. Operacyjne usuwanie awarii na serwerze produkcyjnym przez SSH

Strona internetowa zwraca błąd 502 Bad Gateway. Inżynier łączy się z VPS i uruchamia agenta terminalowego:

• Komenda: „Sprawdź, dlaczego padł serwer webowy, przejrzyj logi systemd i zrestartuj wymagane usługi”.
• Agent czyta systemctl status nginx, widzi w logach błąd przepełnienia gniazd PHP-FPM, zwiększa limit połączeń w konfiguracji, sprawdza walidność configu (nginx -t) i bezpiecznie restartuje usługę.

02. Złożone rozwiązywanie konfliktów Git Rebase

Inżynier aktualizuje długotrwałą gałąź względem main i napotyka 15 konfliktów:

• Agent terminalowy analizuje pliki z markerami <<<<<<< HEAD, rozumie logikę obu gałęzi, ostrożnie scalia zmiany, uruchamia lokalne testy po każdym rozwiązaniu konfliktu i wykonuje git rebase --continue.

03. Masowa konwersja i optymalizacja zasobów multimedialnych

Zadanie DevOps dotyczące optymalizacji tysięcy obrazów w repozytorium:

• Agent pisze i wykonuje jednowierszowy pipeline oparty na find, xargs i narzędziu cwebp, konwertując obrazy do formatu WebP z zachowaniem struktury katalogów i aktualizacją odwołań w kodzie źródłowym.

5. Pułapki, typowe błędy i bezpieczeństwo

• Uruchamianie z uprawnieniami superusera (Root Vulnerability): Nigdy nie uruchamiaj agentów terminalowych ze stałymi uprawnieniami root. Jakakolwiek halucynacja lub błąd w ścieżce pliku może prowadzić do zniszczenia katalogów systemowych (/bin, /etc).
• Zawieszenie w potokach nieinteraktywnych: Próba uruchomienia komendy typu htop, vim lub skryptu interaktywnego żądającego hasła bez PTY prowadzi do bezterminowego zawieszenia agenta.
• Ataki przepełnienia bufora (Token Bomb): Komendy generujące gigabajty tekstu (np. cat /dev/urandom lub niekontrolowany dump bazy danych) mogą zablokować pracę modelu lub spowodować nagłe wyczerpanie limitów pamięci. Zawsze ograniczaj wyjście za pomocą narzędzi head -n 100.
• Wyciek zmiennych środowiskowych przez komendę env: Jeśli agent wypisuje wszystkie zmienne systemowe do celów diagnostycznych, klucze tajne i tokeny mogą trafić do kontekstu zapytania do API modelu językowego.