Agent as code: co to jest i jak definiować agentów w gicie

Wdrożenia produkcyjneOperacje i wdrażanieOpublikowano Zaktualizowano Autor: Simon Budziak

Agent as code, czyli agents as code, to definiowanie agentów AI w plikach pod kontrolą wersji, a nie w konsoli. Pliki zawierają instrukcje agenta, jego model, narzędzia i uprawnienia, więc zmiana trafia jako zrecenzowany pull request z autorem i datą i można ją wycofać. To zastosowanie nawyków z infrastructure as code do konfiguracji agentów.

Co zawiera plik agent-as-code?

Wszystko, co zmienia zachowanie agenta, czyli więcej niż sam prompt. W praktyce plik to YAML w gicie. Agenci Paradime to „a YAML file in your repo” z nazwą, wersją, rolą, celem i listą dozwolonych narzędzi (Paradime, dostęp 13 listopada 2026). Agenci Ellipsis ustawiają prompt, model, środowisko i budżet, a plik może dodać wyzwalacz (dokumentacja Ellipsis, dostęp 13 listopada 2026). Test kompletnej definicji: czy dwie osoby, które zastosują te same pliki, dostaną agentów zachowujących się tak samo.

Jak agent as code wypada na tle konfiguracji w konsoli?

Gdy agent działa na produkcji, pliki w gicie wygrywają w każdym punkcie, który się liczy.

Konsola Pliki w gicie
Kto to zmienił i dlaczego Często nie wiadomo Autor, opis, data
Recenzja przed wdrożeniem Rzadko Pull request
Wycofanie Ponowne wpisanie starych wartości Cofnięcie commita
Liczenie agentów Ankieta Lista repozytorium
Dryf między środowiskami Częsty Da się porównać diffem

Każdy wiersz sprowadza się do jednej cechy: plik da się porównać diffem, ustawienia w konsoli nie.

Dlaczego ma to znaczenie, gdy agenci działają na produkcji?

Bo typowe pytanie na produkcji brzmi, co się zmieniło, a odpowiada na nie tylko diff. Paradime ujmuje to wprost: zmiany agenta przechodzą recenzję PR jak każda inna zmiana (to samo źródło). Zrecenzowana zmiana rozszerza wersjonowanie promptów na resztę definicji. Pozwala też policzyć cały zasób agentów, bo repozytorium definicji agentów jest realnym źródłem dla inwentarza AI, a nie ankiety.

Jak zmiana trafia do działającego agenta?

Zmiana trafia do działającego agenta przez commit, który pełni rolę wdrożenia. Commit jest krokiem wdrożenia w modelu Ellipsis, a nieprawidłowa aktualizacja zostawia działającą ostatnią poprawną wersję, podczas gdy strona agenta pokazuje błąd (dokumentacja Ellipsis, to samo źródło). Tego zachowania należy oczekiwać od każdego narzędzia: zły plik nie może położyć działającego agenta. Połącz to ze zdefiniowanym cyklem życia agenta, ścieżką promocji przez wdrażanie agentów i zachowaniami przekrojowymi trzymanymi w middleware agenta, zamiast kopiowanych do każdej definicji.

Jak w Soba Labs uruchamiamy własnych agentów jako kod?

Każdy z naszych agentów działających według harmonogramu to jeden plik markdown w gicie, w repozytorium, do którego ten agent należy. Plik zawiera pełne instrukcje agenta, a scheduler przechowuje tylko jednolinijkowy wskaźnik do niego, więc zmiana agenta to zawsze pull request, nigdy edycja w schedulerze. Taki pull request przechodzi tę samą bramkę co kod: najpierw testy deterministyczne, potem LLM judge, a scalany jest dopiero wtedy, gdy każdy test jest zielony. Zmieniony krok jest też uruchamiany na sucho na prawdziwym przypadku z przeszłości, zanim nadejdzie jego kolejny zaplanowany przebieg. Agenta zdefiniowanego tylko na ekranie schedulera nie da się porównać diffem, zrecenzować ani odtworzyć, więc traktujemy go jak defekt do naprawy. Jeden celowy wyjątek: plik nigdy nie podaje nazwy modelu, bo model ustawia się w schedulerze i zmienia z każdym wydaniem, więc nazwa w pliku by się zdezaktualizowała. Wiedza wielokrotnego użytku znajduje się w agent skills zapisanych w formacie Agent Skills, który Anthropic opracował i udostępnił jako otwarty standard dla „portable, version-controlled folders” (przegląd Agent Skills, dostęp 16 listopada 2026). U nas jeden plik skilla działa bez zmian w Claude Code, Codex i OpenCode.

Napisane z pomocą AI i sprawdzone przez Simona Budziaka. Uwagi z produkcji pochodzą z systemów, które Soba Labs buduje i utrzymuje.

Najczęściej zadawane pytania

Dlaczego nie konfigurować agentów po prostu w konsoli dostawcy?

Konsola nie ma diffa, recenzenta ani wycofania. Gdy agent zachowuje się źle, pytanie brzmi, co się zmieniło, a konsola rzadko potrafi na nie odpowiedzieć. Pliki zamieniają zmianę zachowania w zrecenzowany pull request z autorem i datą.

Czy agents as code to to samo co wersjonowanie promptów?

Wersjonowanie promptów obejmuje jedną część definicji. Agents as code obejmuje całą jednostkę: prompt, model, listę narzędzi, uprawnienia i backend pamięci, bo zmiana któregokolwiek z nich zmienia zachowanie i wszystkie potrzebują tej samej ścieżki recenzji.

Co zawiera plik agent-as-code?

Zwykle plik YAML. Przykład jednego dostawcy ustawia nazwę, wersję, rolę, cel i listę dozwolonych narzędzi; przykład innego ustawia prompt, model, środowisko i budżet oraz opcjonalny wyzwalacz.

Podsumuj tę stronę w

Przeszkol zespół, aby sam to zbudował