~/tools / Tool Definition Checker
Tool Definition Checker — OpenAI, Anthropic ve Gemini için araç ve fonksiyon tanımlarını denetleyin
OpenAI, Anthropic veya Gemini'ye gönderdiğiniz araç (fonksiyon) tanımlarını her API'nin belgelenmiş biçimine göre denetleyin: adlar, açıklamalar, parametre şemaları, strict mode ve girdi örnekleri. İstek başarısız olmadan önce hataları bulun. Hiçbir şey tarayıcınızdan çıkmaz.
Kurallar 2026-10-23 tarihinde belgelerle karşılaştırılarak denetlendi.
Belgeler: OpenAI / Anthropic / Gemini API başvuru belgesi
Denetlenmeyenler: bir modelin aracı destekleyip desteklemediği, Anthropic için strict tool use ayrıntıları, Anthropic'in kendi sağladığı araçlar ve belgelerin belirtmediği kurallar.
Her şey tarayıcınızda çalışır. Tanımlar yüklenmez.
Araç kullanımı (tool use), diğer adıyla fonksiyon çağırma (function calling), modelin kodunuzdan bir fonksiyonu çalıştırmasını istemesini sağlar. Her fonksiyonu bir JSON tanımıyla anlatırsınız ve üç büyük API farklı yapılar bekler: OpenAI Chat Completions fonksiyonu bir function nesnesinin içine yerleştirir, OpenAI Responses alanlarını tek düzeyde tutar, Anthropic name ve input_schema kullanır, Gemini ise fonksiyon bildirimlerini (functionDeclarations) kullanır. Ad kuralları da farklıdır. Bu araç yapıştırdığınız tanımı okur, hangi API için yazıldığını belirler ve o sağlayıcının belgelerinde yazanlara göre denetler: ad, açıklama, parametre şeması, strict mode ve Anthropic için her girdi örneğinin şemayla uyuşup uyuşmadığı. Ayrıca bir API'de çalışan bir adın başka bir API tarafından reddedileceğini de gösterir. Kurallar, aracın altında gösterilen tarihte belgelerle karşılaştırılarak denetlenmiştir.
Kullanım örnekleri
- Bir araç tanımını isteğe eklemeden önce denetlemek; böylece hatalı bir ad ya da yanlış bir yapı çağrının başarısız olmasına yol açmaz
- strict mode'un bir fonksiyon şemasını neden reddettiğini bulmak
- Bir aracı bir sağlayıcıdan diğerine taşırken nelerin değişmesi gerektiğini görmek
Nasıl kullanılır
- Tek bir araç tanımı, bir araç dizisi ya da tools dizisi içeren bir istek gövdesi yapıştırın ya da örneği yükleyin.
- Her aracın hangi API olarak tanındığını, ardından bulguların listesini okuyun. Düzelt, belgelere göre reddedileceği ya da geçersiz olduğu anlamına gelir; Kontrol et, bir göz atmaya değer demektir; Not ise yalnızca bilgi içindir.
- Tanımları düzeltip yeniden yapıştırın. strict mode sorunları için Structured Output Schema Checker her birini ayrıntılı gösterir.
SSS
Bir tanımın hangi API için olduğunu nasıl anlıyor?
Yapısından. input_schema içeren bir tanım Anthropic olarak okunur. type değeri function olan ve iç içe bir function nesnesi bulunan tanım OpenAI Chat Completions, type değeri function olup alanları en üst düzeyde olan tanım ise OpenAI Responses olarak okunur. functionDeclarations içeren ya da name, description ve parameters bulunan bir nesne Gemini olarak okunur. Sonuç, her aracın neyle eşleştirildiğini gösterir.
Ad kuralları nelerdir?
OpenAI harfleri, rakamları, alt çizgileri ve tireleri, en çok 64 karakter olmak üzere belgeler. Anthropic harfleri, rakamları, alt çizgileri ve tireleri, en çok 128 karakter olmak üzere belgeler. Gemini harfleri, rakamları, alt çizgileri, iki noktaları, noktaları ve tireleri, en çok 128 karakter olmak üzere belgeler. Bir API için geçerli olan ad başka bir API tarafından reddedilebilir; araç bu durumda sizi uyarır.
strict true olduğunda şemayı neden yeniden denetliyor?
OpenAI, strict mode için her nesnede additionalProperties değerinin false olması, her özelliğin required içinde listelenmesi ve isteğe bağlı değerlerin null değerine de izin veren bir türle yazılması gerektiğini belirtir. Bu kuralları bozan bir şema reddedilir. Araç sorunları sayar ve ilkinin nerede olduğunu gösterir.
input_examples içinde neyi denetliyor?
Anthropic, her örneğin aracın input_schema şemasına uygun olması gerektiğini ve geçersiz bir örneğin 400 hatası döndürdüğünü belirtir. Araç her örneği şemaya göre denetler ve hangisinin başarısız olduğunu söyler.
Neleri denetlemiyor?
Belirli bir modelin aracı destekleyip desteklemediğini, Anthropic için strict tool use ayrıntılarını, Anthropic'in kendi sağladığı araçları ve belgelerin belirtmediği her şeyi. Hiçbir API'yi çağırmaz; bu yüzden denetimi geçen bir tanım gerçek bir istekte yine de başarısız olabilir.
Tanımım bir sunucuya gönderiliyor mu?
Hayır. Denetim tarayıcınızda çalışır.