Referans

#Hata kodları

Tanık, hataları çağıranın konuştuğu biçimde döner: OpenAI uçlarında error.code, Anthropic ucunda error.type alanında. Mevcut hata yönetiminiz çalışmaya devam eder; Tanık'ın kendi redleri aşağıdaki kodlarla ayırt edilir.

#Çağıranın düzeltebileceği

HTTP	Kod	Anthropic `type`	Anlamı
400	`invalid_request`	`invalid_request_error`	İstek gövdesi beklenen şekilde değil; mesaj hangi alan olduğunu söyler
401	`unauthenticated`	`authentication_error`	Tanık anahtarı yok, geçersiz ya da iptal edilmiş
404	`not_found`	`not_found_error`	Böyle bir uç yok
429	`rate_limited`	`rate_limit_error`	Dakikalık istek limiti aşıldı; `Retry-After` başlığı gelir
429	`insufficient_quota` (`budget_exhausted`)	`rate_limit_error`	Aylık token bütçesi doldu; hangisi olduğu mesajda. `Retry-After` yok, ay başında sıfırlanır

OpenAI biçiminde bütçe aşımı, OpenAI'nin kendi kota hatasıyla aynı şekilde döner (type: insufficient_quota), böylece kredi bitince ne yapıyorsanız onu yapan bir istemci aynı şeyi yapar.

#Politika redleri

HTTP	Kod	Anthropic `type`	Anlamı
403	`policy_blocked`	`permission_error`	Bir kural reddetti: bölge, model, araç, kişisel veri ya da injection. Gerekçe kayıtta; mesajda reddedilen model adı varsa o kadar
403	`request_held`	`permission_error`	Yönetici onayı bekleniyor; mesajda istek kimliği. Bkz. Onaya bekletme
403	`tenant_inactive`	`permission_error`	Kurum hesabı askıda ya da kayıtlı değil (yalnız bulut kurulumunda)
403	`upstream_destination_forbidden`	`permission_error`	Hedef adres iç ağa işaret ediyor (yalnız bulut kurulumunda)

#Yöneticinin düzeltebileceği

HTTP	Kod	Anthropic `type`	Anlamı
502	`upstream_not_configured`	`api_error`	Bu istek için tanımlı hedef yok
502	`upstream_credential_missing`	`api_error`	Hedef var, sağlayıcı anahtarı okunamıyor. Değişkenin adı günlükte, çağırana söylenmez
502	`buffered_response_too_large`	`api_error`	Tamponlu modda yanıt sınırı aştı ve taranmadan iletilmedi; ya da eşzamanlı akış sınırı dolu
503	`auth_backend_unavailable`	`api_error`	Yapılandırma veritabanına ulaşılamıyor; tekrar denenebilir

#Sağlayıcı kaynaklı

HTTP	Kod	Anthropic `type`	Anlamı
502	`upstream_unreachable`	`api_error`	Sağlayıcıya bağlanılamadı
504	`upstream_timeout`	`api_error`	Sağlayıcı `UPSTREAM_TIMEOUT_MS` içinde cevap vermedi
500	`internal`	`api_error`	Tanık'ta beklenmeyen hata; günlüğe yazılır

Sağlayıcının kendi hataları (geçersiz model, sağlayıcı kotası, içerik politikası) olduğu gibi iletilir; Tanık bunları yeniden yazmaz.

#Kayıt

Her red bir kayıt bırakır: outcome alanı blocked, held ya da error; hedef alanı boş (istek hiçbir yere gitmedi). Hangi adımın hangi gerekçeyle durdurduğu decisions listesindedir.