Python SDK 0.84.0: Anthropic zmienia domyślny format tablic
- Anthropic opublikował 25 lutego 2026 Python SDK v0.84.0 ze zmianą domyślnego formatu kodowania tablic w żądaniach HTTP.
- Parametr array_format przyjmuje teraz domyślnie wartość brackets, co oznacza format items[]=1 zamiast dotychczasowego items=1.
- Zmiana uderza głównie w projekty parsujące surowe żądania HTTP, własne warstwy cache i middleware przetwarzający parametry URL.
Jedna linijka konfiguracji, potencjalnie spore kłopoty
Anthropic opublikował 25 lutego 2026 Python SDK v0.84.0 z jedną zmianą, która wygląda niewinnie: parametr array_format ma teraz domyślną wartość brackets zamiast poprzedniego formatu. Tablice w żądaniach HTTP są teraz kodowane z nawiasami kwadratowymi — items[]=1&items[]=2 zamiast items=1&items=2. Wizualnie mała różnica, skutki niekoniecznie.
Kogo to uderzy?
Większości projektów ta zmiana nie tknie. Jeśli jednak kod zakłada konkretny kształt parametrów URL w komunikacji z API Anthropic, czeka Cię nieprzyjemna niespodzianka.
Najbardziej narażone są cztery typy integracji. Projekty parsujące lub logujące surowe żądania HTTP — tam format URL bywa sztywno zakodowany w regułach. Własne warstwy cache’owania oparte na URL, gdzie klucz cache’a buduje się ze stringa zapytania. Middleware przetwarzający parametry zapytań, który może nie ogarniać notacji z nawiasami. Systemy monitoringu analizujące ruch sieciowy z regułami opartymi na wzorcach URL.
Jeśli żadna z tych rzeczy Cię nie dotyczy — aktualizuj bez stresu.
Jak nie wpaść w pułapkę
Zanim wrzucisz 0.84.0 na produkcję, zrób cztery rzeczy.
Przeszukaj projekt pod kątem miejsc, gdzie cokolwiek zależy od formatu parametrów URL wysyłanych do Anthropic. Grep zrobi robotę szybciej niż ręczny przegląd kodu. Potem odpal pełny zestaw testów integracyjnych na środowisku deweloperskim — nie wybiórczo, cały suite. Nową wersję wdróż najpierw na staging i zostaw ją tam na kilka godzin pod obciążeniem zbliżonym do produkcyjnego. Na koniec monitoring przez pierwsze godziny po przejściu na produkcję — logi i metryki powiedzą Ci szybciej niż użytkownicy, czy coś się posypało.
Jeśli musisz zostać przy starym formacie, sprawdź dokumentację SDK — może istnieć opcja konfiguracyjna przywracająca poprzednie zachowanie.
Tempo wydań jest brutalne
Wersja 0.83.0 ukazała się zaledwie kilka dni przed 0.84.0. Anthropic utrzymuje tempo aktualizacji, które zmusza do regularnego czytania changelogów — inaczej zmiany wpływające na kompatybilność wsteczną złapią Cię z zaskoczenia. Anthropic nie publikuje oficjalnej roadmapy dla swoich bibliotek, więc changelog to jedyne źródło wiedzy o nadchodzących zmianach.
Pinuj wersje, nie ufaj otwartym zakresom
Przy tak częstych aktualizacjach kilka praktyk ratuje czas i nerwy.
W requirements.txt lub pyproject.toml wpisuj anthropic==0.84.0, nie anthropic>=0.84.0. Otwarte zakresy to zaproszenie do problemów przy automatycznym instalowaniu zależności — szczególnie kiedy Anthropic potrafi wypuścić dwie wersje w ciągu tygodnia.
Skonfiguruj Dependabota lub Renovate do automatycznego otwierania PR-ów z aktualizacjami, ale z wymaganym code review przed merge’em. Dostajesz powiadomienie i kontrolę bez ręcznego śledzenia GitHuba Anthropic.
Release notes traktuj jak dokumentację, nie jak opcjonalną lekturę. Każda aktualizacja SDK to kilka minut czytania, które mogą oszczędzić kilka godzin debugowania produkcji.
Pełne release notes dla v0.84.0 są dostępne na GitHubie Anthropic — tam znajdziesz też historię poprzednich wydań, jeśli chcesz sprawdzić, kiedy dokładnie wjechała wersja 0.83.0.
