~/tools / Structured Output Schema Checker
Structured Output Schema Checker — Bir JSON Schema'yı OpenAI, Anthropic ve Gemini sınırlarına göre denetleyin
Bir JSON Schema'yı OpenAI, Anthropic ve Gemini'nin yapılandırılmış çıktı için belgelenmiş sınırlarına göre denetleyin. Şemayı API'ye göndermeden önce hangi anahtar sözcüklerin kabul edilmediğini, yok sayıldığını ya da belgelenmediğini görün. Hiçbir şey tarayıcınızdan çıkmaz.
Kurallar, her sağlayıcının belgelerine göre 2026-10-23 tarihinde denetlendi.
Denetlenmeyenler: iç içe geçme derinliği, uzun enum sınırı ve sağlayıcıların belgelemediği her şey. Sağlayıcılar bu kuralları değiştirir; bu yüzden güncel belgelerden doğrulayın.
Her şey tarayıcınızda çalışır. Şema yüklenmez.
Yapay zekâ API'leri bir modelin yanıtını bir JSON Schema'ya uymaya zorlayabilir, ancak her sağlayıcı JSON Schema'nın yalnızca bir bölümünü kabul eder ve bu bölümler birbirinden farklıdır. Bir sağlayıcıda çalışan şema başka bir sağlayıcıda reddedilebilir ya da kabul edilip bazı kuralları sessizce atılabilir. Bu araç şemanızı okur ve her sağlayıcının belgelerinde yazanlara göre denetler: additionalProperties değerinin false olması gibi zorunlu kurallar, desteklenmeyen anahtar sözcükler, kabul edilen ama uygulanmayan anahtar sözcükler ve yayımlanmış boyut sınırları. Bulgular üç türe ayrılır; böylece belgelenmiş bir hatayı, belgelerin yalnızca listelemediği bir anahtar sözcükten ayırt edebilirsiniz. Kurallar, aracın altında gösterilen tarihte sağlayıcıların belgelerine göre denetlenmiştir.
Kullanım örnekleri
- Bir şemayı yapılandırılmış çıktı isteği olarak göndermeden önce denetlemek; böylece sorunu bir 400 hatasından öğrenmezsiniz
- Hangi anahtar sözcükleri şemadan çıkarıp kendi doğrulama kodunuza taşımanız gerektiğini bulmak
- Aynı şema için OpenAI, Anthropic ve Gemini'nin her birinin neyi kabul ettiğini karşılaştırmak
Nasıl kullanılır
- Göndermeyi planladığınız JSON Schema'yı yapıştırın ya da örneği yükleyin.
- Her sağlayıcı için sonucu okuyun. Kabul edilmiyor, belgelere göre şemanın başarısız olacağı ya da değiştirilmesi gerektiği anlamına gelir. Yok sayılır, anahtar sözcüğün kabul edildiği ama uygulanmadığı anlamına gelir. Belgelenmemiş, anahtar sözcüğün sağlayıcının desteklenen anahtar sözcük listesinde yer almadığı anlamına gelir.
- Kabul edilmiyor olarak işaretlenenleri düzeltin, gerisini gerçek bir istek çalıştırarak denetleyin.
SSS
Temiz bir sonuç, API'nin şemamı kabul edeceği anlamına mı gelir?
Hayır. Araç, sağlayıcıların belgelediği kuralları denetler. Hiçbir API'yi çağırmaz ve belgeler her şeyi kapsamaz; bu yüzden bir şema yine de reddedilebilir. Temiz bir sonucu 'bilinen bir sorun yok' diye düşünün ve gerçek bir istekle deneyin.
Kabul edilmiyor, Yok sayılır ve Belgelenmemiş ne anlama gelir?
Kabul edilmiyor: belgeler anahtar sözcüğün desteklenmediğini ya da bir kurala uyulması gerektiğini söyler; örneğin additionalProperties false olmalıdır. Yok sayılır: belgeler anahtar sözcüğün kabul edildiğini ama uygulanmadığını söyler, bu yüzden model kuralı çiğneyebilir. Belgelenmemiş: anahtar sözcük sağlayıcının desteklenen anahtar sözcük listesinde yoktur; reddedilebilir ya da yok sayılabilir, belgeler hangisi olduğunu söylemez.
OpenAI neden her özelliğin required içinde olmasını istiyor?
Strict modda OpenAI, tüm özelliklerin required içinde listelenmesini ve additionalProperties değerinin false olmasını ister. Bir alanı isteğe bağlı yapmak için belgeler null ile bir birleşim kullanmayı söyler; örneğin ["string", "null"] türü.
Şemam minimum, maxLength ya da benzerlerini kullanıyor. Ne yapmalıyım?
Anthropic sayısal kısıtları ve dize uzunluğu sınırlarını desteklemez, Gemini ise uzunluk sınırlarını uygulamaz. Bunları şemadan kaldırın, sınırı description alanında anlatın ve yanıt geldikten sonra değeri kendiniz denetleyin. JSON Schema Validator aracı bu denetimi yapabilir.
Bu araç özyinelemeyi denetliyor mu?
Evet, belgeleri özyinelemeli şemaları desteklenmeyen olarak listeleyen Anthropic için. OpenAI ve Gemini özyinelemeli şemaları belgelediği için işaretlenmez.
Neler denetlenmiyor?
İç içe geçme derinliği, uzun enum sınırı ve sağlayıcıların belgelemediği her şey. Araç ayrıca daha yeni modelleri ya da denetim tarihinden sonra eklenen özellikleri bilmez; önemli olduğunda güncel belgelerden doğrulayın.
Şemam bir sunucuya gönderiliyor mu?
Hayır. Denetim tarayıcınızda çalışır.