1. Üç değişikliği ayrı değerlendirin
Protokol, yönetim raporlaması ve çıkarım ayarları ayrı yayın kararları gerektirir. Bunları tek yükseltmede birleştirmek hataların açıklanmasını zorlaştırır.
| Resmî tarih | Doğrulanan güncelleme | Kaynak |
|---|---|---|
| 21 Ekim | Yeni API sürümü ve onu varsayılan kullanan ana SDK sürümleri. | Geçiş kılavuzu |
| 29 Ekim | Kullanım ve Maliyet Analizi API'si beta; eski raporlar desteklenmeye devam ediyor. | Sürüm notları |
| 30 Ekim | Opus 4.8 Fast Mode kullanımdan kaldırılacak; kaldırma tarihi 30 Kasım. Fast Mode'a devam etmek için Opus 5.5'e geçilmeli. | Kaldırma duyurusu |
2. SDK'yı ve iletilen protokolü ayrı inceleyin
Yeni API sürümü temperature, top_p ve top_k parametrelerini reddediyor. SDK, API anahtarını Authorization: Bearer ile gönderiyor; API, X-Api-Key başlığını da kabul etmeye devam ediyor. Geçiş kılavuzunu ve platform istisnalarını kontrol edin.
Önerimiz, kurulu bağımlılığı, gerçek sürüm başlığını, serileştirilmiş gövdeyi ve kimlik doğrulama yolunu birlikte kaydetmektir. Ortak istemciler, vekiller ve yeniden deneme ara katmanları iş kodunda görünmeyen alanlar ekleyebilir. Sağlayıcıya özgü ayrıntıları incelenebilir tutmak için uyarlamayı merkezileştirin.
Testlere hassas bilgileri çıkarılmış kayıtlı konuşmaları da dahil edin. Bir selamlama; yeniden gönderilen eklerin, atıfların veya araç sonuçlarının yanlış dönüştürülüp dönüştürülmediğini ortaya çıkarmaz. Her test örneğinin beklenen iş sonucunu istek yapısının yanında tutun.
3. Her hata için bir sorumlu belirleyin
Önerilen kabul çerçevesi bir mühendislik kontrol listesidir; sağlayıcının test sonucu değildir.
| Katman | Test | Kabul koşulu |
|---|---|---|
| Protokol | Metin ve kayıtlı araç konuşmaları. | Üst API istekleri kabul eder; ayrıştırıcı yanıtları okur. |
| Ağ geçidi | Geçerli, süresi dolmuş ve eksik kimlik bilgileri. | Beklenen erişim kararları; günlüklerde kimlik bilgisi değerleri bulunmaz. |
| Kurtarma | Zaman aşımları, hız sınırları ve kesilen akışlar. | Sınırlı yeniden deneme; yan etkili araçlar bir kez yürütülür. |
| Geri alma | Önceki yapılandırma paketini geri yükleme. | Sürüm, istek uyarlayıcısı ve ayrıştırıcı birlikte geri döner. |
Devreye almadan önce ağ geçidi, uygulama ve raporlama sorumlularını belirleyin. Aksi halde kimlik doğrulama hatası model kararsızlığı, ayrıştırıcı hatası ise sözde kalite gerilemesi olarak etiketlenebilir.
4. Çalışma bütçelerini mutabakattan ayırın
Analiz tutarları, sent biriminde ondalık dizgelerdir. Veriler genellikle dört saat içinde yenilenir; bu süre yirmi dört saate çıkabilir. Resmî birimler ve güncellik kuralları.
Bu nedenle devam eden görevleri uygulama bütçeleri ve istek sınırlarıyla kontrol edin. Mutabakat için geçmiş raporları ayrıca toplayın. Bu kayıtlar arasındaki fark, eksik ücretlerin doğrudan kanıtı değil; inceleme başlatmak için bir sinyaldir.
Özgün birimleri ve hassasiyeti koruyun, gösterim sırasında dönüştürün. Her raporlama aralığını ve gözlemlenen güncelliği kaydedin. Farkları yorumlamadan önce zaman sınırlarını, geciken verileri ve yinelenen toplamayı kontrol edin. Harcamalara iş bağlamı kazandırmak için her görevi modeli, gecikmesi, yeniden denemeleri ve yerel kullanım tahminiyle ilişkilendirin.
5. Gözlemlenebilirlikte çift sayımı önleyin
Claude OpenTelemetry hâlâ beta durumunda. SDK ve API span'ları aynı isteği tanımlayabilir; sayım için tek katman seçin ve yinelenen kayıtları ayıklayın. Resmî token sayma kuralları.
İstekleri ve araç sonuçlarını bir iş görevi kimliğiyle bağlayın; ayrı istek kimliklerini de koruyun. Görev başarısını, görevin toplam süresini ve toplam maliyeti izleyin. Başarısız denemeler de kaynak tüketir; yalnızca başarılı yanıtları saymak güvenilmez bir iş akışının bedelini gizler.
Önerdiğimiz ölçüt, tüm denemelerin maliyetinin bağımsız olarak doğrulanmış tamamlanan görev sayısına bölünmesidir. Doğrulayıcı, gereken ürünü veya durum değişikliğini incelemelidir. HTTP başarısı tek başına görev tamamlandığını göstermez. Bu ölçütü ancak temsili iş yükü verileri toplandıktan sonra yorumlayın.
6. Fast Mode'un kaldırılmasını ayrı yönetin
Yukarıdaki kaldırma tarihine göre model ve hız birleşimlerinin envanterini çıkarın. Model değişikliği çıktıları, hız ayarı değişikliği gecikmeyi etkileyebilir. Seçilen alternatifi her iki gereksinime göre doğrulayın.
Yapılandırmaları denetlenebilir tutun ve geri dönüş yollarına son geçerlilik tarihi koyun. Kaldırılması planlanan eski yapılandırma geçici bir kurtarma imkânıdır. Bu imkân ortadan kalkmadan önce temsili görevlerle doğrulanmış bir alternatif hazırlayın.
7. Aşamalı bir kabul planı uygulayın
- Bağımlılıkları ve yapılandırmayı sabitleyin. Açık kabul koşulları içeren, hassas bilgileri çıkarılmış metin, ek, araç ve uzun konuşma örneklerini toplayın.
- Protokol ve ağ geçidi durumlarını yalıtılmış ortamda test edin. Beklenen retleri beklenmeyen hatalardan ayırın.
- Eski ve yeni yapılandırmaları aynı görevler ve araç izinleriyle karşılaştırın. Başarısızlıkları, yeniden denemeleri ve insan düzeltme emeğini kaydedin.
- Geri alınabilir görevlerle başlayın. Sonuçları incelemeden kapsamı büyütmeyin; kimlik doğrulama hataları, kalite kaybı veya açıklanamayan maliyet değişiklikleri için önceden belirlenmiş geri alma koşulları kullanın.
- Raporlar yenilendikten sonra toplamların mutabakatını yapın. Geçişin tamamlandığını ilan etmeden önce farkları açıklayın ve kanıtları saklayın.
Bu plan iş yükü testi gerektirir. Uyumluluk, doğrulanmış sonuçlar ve mutabakatı yapılmış maliyetler birlikte yükseltmeyi savunulabilir kılar; duyuru tek başına uygulamanızda bu sonuçların hiçbirini kanıtlamaz.