Claude-api-guard, Claude/OpenAI SDK ihlal değişiklikleri için CI kontrolü

Bilinen, eski bir API değişikliği nedeniyle bozulan veya bozulmak üzere olan Claude/Anthropic ve OpenAI API'lerin kullanımı açısından kod tabanınızı tarayan ve mekanik olanları otomatik olarak düzelten bir GitHub eylemi. Her sağlayıcının resmi sürüm notlarını bir programa göre okuyarak ve bir LLM ile yeni önemli değişiklikleri çıkararak kendi kural kümesini güncel tutar, böylece elle tutulan bir liste gibi bayatlamaz. LLM sağlayıcı SDK'ları hızla değişiyor ve "geçen ay işe yaradı" ile "hala çalışıyor" aynı şey değil. Bir örnekleme parametresi kaldırılır, bir HTTP istemcisi değiştirilir, bir yanıt şekli yeniden adlandırılır ve bunu ilk duyan kişi bir değişiklik günlüğü değil, bir üretim hatasıdır. Bu aracın, bunu gönderilmeden önce CI'da yakalayan şey olması amaçlanıyor. Şu anda en güçlü olduğu yer ve gittiği yer: Claude-api-guard, Anthropic'nin Claude API'si olarak başladı ve hala en derinindedir — her kural, gerçek alt koda göre doğrulanır (yalnızca yazılıp doğru kabul edilmez; bulunan ve düzeltilen gerçek hatalı pozitifler için aşağıdaki mühendislik günlüğüne bakın) ve kural seti, Anthropic'nin canlı sürüm notlarından kendisini günceller. OpenAI desteği de aynı çizgiyi takip etti: OpenAI'in kendi değişiklik günlüğü ve geçiş kılavuzlarından elle çıkarıldı, ardından her bulgu kontrol edilene kadar büyük bir gerçek kod tabanına (litellm) göre tamamen önceliklendirildi.

Buradaki plan, sağlayıcı kapsamını aynı temelden dışarıya doğru genişletmeye devam etmektir - bunun amacı, tek sağlayıcılı bir niş komut dosyası olarak kalmak değil, daha geniş bir "projenizin bağlı olduğu her API için çığır açan değişiklik koruması" aracına dönüşmektir. Zaten her kuralda yerleşik olan "sağlayıcı" alanı ve senkronizasyon_rules.py dosyasındaki sağlayıcı başına PROVIDERS yapılandırması özel olarak mevcuttur, dolayısıyla bir sonraki sağlayıcıyı eklemek, aracı yeniden yapılandırmak değil, kurallarını ve değişiklik günlüğü ayrıştırıcısını yazmaktır. Kullanmak için API anahtarına gerek yoktur. Kodunuzu taramanın hiçbir maliyeti yoktur ve çalışma zamanında LLM'yi çağırmaz; her kural bu depoda önceden hazırlanmış olarak gönderilir. Anthropic API anahtarı yalnızca bu deponun kendi bakım tarafında, sağlayıcı sürüm notlarını okuyan ve yeni kurallar öneren haftalık işi güçlendirmek için kullanılır (önerilen her kural, yayınlanmadan önce yine de insan tarafından incelenen bir PR'den geçer; aşağıdaki "Kural senkronizasyonu" bölümüne bakın). Bunu, korumak istediğiniz depodaki bir iş akışı dosyasına ekleyin (ör. .github/workflows/claude-api-guard.yml): İşte bu; sır yok, yapılandırma dosyası yok, kayıt yok.