Wątki wiadomości w Claude API. Agent wysyła tylko nowe wiadomości

Jak działają wątki wiadomości w Claude API

Do tej pory Messages API było bezstanowe. Każde zapytanie musiało zawierać pełną rozmowę, prompt systemowy i definicje narzędzi, a API za każdym razem sprawdzało i dzieliło na tokeny cały ten materiał. W agencie, który wykonuje kilkadziesiąt kroków, oznaczało to coraz większe zapytania i rosnący czas oczekiwania na pierwszy fragment odpowiedzi.

Wątek zmienia ten schemat. Pierwsze zapytanie wygląda jak dotąd, ale ma dodatkowy parametr thread z typem create. API zapisuje rozmowę razem z odpowiedzią Claude pod identyfikatorem tej odpowiedzi. W kolejnych krokach aplikacja wysyła tylko nowe wiadomości i parametr thread z typem continue, wskazując identyfikator poprzedniej odpowiedzi. Prompt systemowy i narzędzia zostają takie, jak w pierwszym zapytaniu.

Co trzeba zrobić, aby użyć wątków

Według dokumentacji Anthropic wdrożenie sprowadza się do kilku kroków. SDK ma pomocnika thread, który sam dodaje nagłówek, tworzy wątek i odtwarza rozmowę po błędzie.

1. Dodaj nagłówek beta message-threads-2026-08-12 do każdego zapytania w wątku.
2. Wyślij pierwsze zapytanie z pełną rozmową, promptem systemowym, narzędziami i parametrem thread typu create.
3. W kolejnych krokach wysyłaj tylko nowe wiadomości z parametrem thread typu continue i identyfikatorem ostatniej odpowiedzi.
4. Przechowuj własną kopię całej rozmowy, bo wątek może wygasnąć, a API zwróci wtedy błąd 404 z kodem thread_not_found.
5. Po takim błędzie wyślij pełną rozmowę w nowym zapytaniu create i kontynuuj od nowej odpowiedzi.

Ograniczenia i ryzyka

Anthropic opisuje wątek jako mechanizm typu best-effort. Wygasa 5 minut po ostatnim zapytaniu, a każda zapisana odpowiedź odnawia ten czas. API nie zapisuje m.in. odpowiedzi przerwanej limitem max_tokens w trakcie wywołania narzędzia ani odpowiedzi napisanej przez model zapasowy (fallback). Wątek działa też tylko w obrębie tej samej organizacji, przestrzeni roboczej i konta, które go utworzyło.

Wątek przyjmuje wyłącznie dopisywanie wiadomości, więc nie da się w nim zastąpić starszej części rozmowy streszczeniem. Kompakcja na żądanie, Message Batches i liczenie tokenów nie działają z parametrem thread. Po odmowie modelu (stop_reason równy refusal) dokumentacja zaleca rozpoczęcie nowego wątku zamiast kontynuacji.

Dla firm w Polsce najważniejsza jest kwestia danych. Wątki nie kwalifikują się do zerowej retencji danych (ZDR) i nie są dostępne dla organizacji z włączonym trybem HIPAA. Anthropic zapewnia, że treść wątku jest szyfrowana kluczem serwera, trzymana tylko w pamięci i usuwana najpóźniej godzinę po ostatnim użyciu. Organizacja, która ma umowę ZDR albo przetwarza dane szczególnie chronione w rozumieniu RODO, powinna przed włączeniem funkcji sprawdzić, czy krótkotrwałe przechowywanie rozmowy na serwerze mieści się w jej ocenie ryzyka.

Dla kogo to ma znaczenie

Największą korzyść odniosą zespoły budujące długie pętle agentów, na przykład asystentów programistycznych, agentów obsługi klienta i automatyzacje wykonujące wiele wywołań narzędzi. Krótkie, jednorazowe zapytania praktycznie nic nie zyskają. Anthropic nie podał liczbowych wyników skrócenia czasu odpowiedzi, więc realny efekt warto zmierzyć na własnym ruchu.

Wątki nie zastępują buforowania promptów. Dokumentacja zaleca łączenie obu mechanizmów, bo wątek zmniejsza ilość przesyłanych danych, a buforowanie obniża koszt ponownie przetwarzanych tokenów. Podobny model stanowej rozmowy od dawna oferuje OpenAI w Responses API, więc w naszej ocenie to raczej wyrównanie możliwości niż zupełnie nowe podejście.