Zarządzanie kontekstem - jak nie utopić agenta w szumie

Context window to nie dysk twardy - to RAM. Im więcej tam wrzucisz, tym wolniej agent „myśli“ i tym częściej się myli. Ten tutorial pokazuje, jak utrzymać kontekst czysty i skuteczny.

Zarządzanie kontekstem jest jedną z czterech warstw Agent Engineering dla zespołów software. Pozostałe to rola, kontrola wyniku i miara pełnego kosztu pracy.

Zasada #1: Jedno zadanie = Jeden czat

To najważniejsza zasada pracy z agentami AI.

Dlaczego?

Każdy nowy prompt dodaje tokeny do okna kontekstowego. Po 10-15 wymianach agent ma w pamięci:

Twoje pierwsze (już nieaktualne) polecenie
3 nieudane próby
Kod, który usunąłeś
Kontekst z zadania, które skończyłeś godzinę temu

Model próbuje brać pod uwagę wszystko - stary kontekst zaczyna kolidować z nowym.

Praktyczna reguła

✅ Nowy czat gdy:
- Kończysz jedno zadanie, zaczynasz drugie
- Agent zaczyna „mulić" lub powtarzać stare błędy
- Zmieniasz temat (z backendu na frontend, z kodu na testy)
- Kontekst stał się „brudny" (dużo prób i błędów)

❌ Kontynuuj czat gdy:
- Iterujesz nad tym samym zadaniem
- Agent potrzebuje kontekstu z wcześniejszej odpowiedzi
- Poprawiasz konkretny fragment kodu z poprzedniej wymiany

Zasada #2: Wklejaj selektywnie

❌ Nie rób tego

User: [wkleja 500 linii kodu]
      Napraw buga.

✅ Rób to

User: W pliku OrderService.cs, metoda CreateAsync (linie 45-80)
      rzuca NullReferenceException.

      Oto metoda:
      [wklej 35 linii]

      Oto interfejs, który implementuje:
      [wklej 10 linii]

      Error: [stack trace]

Reguła kciuka: Wklejaj minimum potrzebne do zrozumienia problemu. Agent nie potrzebuje całego pliku, żeby naprawić jedną metodę.

Zasada #3: Screenshoty zamiast opisów

Modele multimodalne rozumieją obrazy. Zamiast opisywać UI bug słowami, wklej screenshot.

Kiedy screenshot > tekst

Sytuacja	Tekst	Screenshot
UI bug	„Przycisk nachodzi na tekst“	Widać dokładnie co i gdzie
Layout problem	„Grid się nie wyrównuje na mobile“	Widać problem w kontekście
Error w przeglądarce	„Konsola rzuca błędy“	Widać wszystkie errory + kontekst
Porównanie z mockupem	„Nie wygląda jak design“	Widać różnice

Jak dać screenshot agentowi

User: [wklej screenshot]
      Na tym screenie widzisz formularz rejestracji.
      Problemy:
      1. Przycisk "Zarejestruj" jest obcięty na mobile
      2. Walidacja nie pokazuje się przy polu email
      3. Spacing między polami jest nierówny

      Zaproponuj fix w CSS (Tailwind).

Protip: screenshot + opis = najlepsza kombinacja

Sam screenshot bez opisu - agent może nie wiedzieć, co jest problemem (bo to Ty wiesz, że „tak nie powinno wyglądać“). Dodaj 1-2 zdania kontekstu.

Zasada #4: Resetuj kontekst strategicznie

Jeśli nie chcesz otwierać nowego czatu, możesz „zresetować“ kontekst w istniejącym:

User: Zapomnij o poprzednim zadaniu. Nowy kontekst:

      Projekt: ASP.NET Core 9 API
      Stack: EF Core + PostgreSQL
      Architektura: Clean Architecture

      Nowe zadanie: Stwórz endpoint GET /api/reports/monthly
      zwracający raport sprzedaży za wybrany miesiąc.

To nie jest idealne rozwiązanie (stary kontekst wciąż zajmuje tokeny), ale pomaga, gdy przełączenie czatu nie jest wygodne.

Zasada #5: Struktura plików jako kontekst

Zamiast opisywać architekturę słowami, pokaż strukturę katalogów:

User: Oto struktura mojego projektu:

      src/
        Domain/
          Entities/
          ValueObjects/
          Events/
        Application/
          Commands/
          Queries/
          Interfaces/
        Infrastructure/
          Persistence/
          Services/
        API/
          Controllers/
          Middleware/
          Filters/

      Dodaj funkcjonalność eksportu raportów.
      Które pliki trzeba utworzyć i gdzie je umieścić?

Agent widzi architekturę i dopasowuje się do niej - nie wymyśla własnej struktury.

Zasada #6: Kontekst negatywny oszczędza tokeny

Zamiast opisywać 10 rzeczy, które agent MA robić, powiedz 3 rzeczy, których NIE MA robić. To krócej i skuteczniej:

User: Stwórz komponent React do wyświetlania listy produktów.

      NIE:
      - Nie używaj class components
      - Nie dodawaj state management (to prop-driven component)
      - Nie styluj inline - użyj Tailwind

3 linie negatywnego kontekstu eliminują 80% niepożądanych wzorców.

Podsumowanie

Zasada	Co robić	Co daje
1 zadanie = 1 czat	Nowy czat na nowe zadanie	Czysty kontekst, lepsza precyzja
Selektywne wklejanie	Minimum kodu potrzebnego	Mniej szumu, szybsze odpowiedzi
Screenshoty	Obraz zamiast opisu UI	Precyzyjna diagnoza
Reset kontekstu	Jawne „zapomnij + nowy brief“	Lepsza fokusacja agenta
Struktura plików	Drzewo katalogów jako kontekst	Agent dopasowuje się do architektury
Kontekst negatywny	„NIE rób X“ zamiast długiego opisu	Mniej tokenów, mniej błędów

Najważniejsze to pamiętać: im mniej szumu w kontekście, tym lepszy wynik. Agent nie jest mądrzejszy, gdy dasz mu więcej - jest mądrzejszy, gdy dasz mu to, co istotne.