Zarządzanie kontekstem agenta AI

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.

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

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

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.