~/tools / Tool Definition Checker
Tool Definition Checker — Verifica le definizioni di strumenti e funzioni per OpenAI, Anthropic e Gemini
Verifica le definizioni degli strumenti (funzioni) che invii a OpenAI, Anthropic o Gemini rispetto al formato documentato da ciascuna API: nomi, descrizioni, schemi dei parametri, strict mode ed esempi di input. Trova gli errori prima che la richiesta fallisca. Nulla lascia il tuo browser.
Regole verificate sulla documentazione il 2026-10-23.
Documentazione: OpenAI / Anthropic / Riferimento dell'API Gemini
Non controllato: se un modello supporta lo strumento, i dettagli dell'uso strict degli strumenti per Anthropic, gli strumenti forniti direttamente da Anthropic e le regole che la documentazione non afferma.
Tutto viene eseguito nel tuo browser. Le definizioni non vengono caricate.
L'uso di strumenti (tool use), detto anche chiamata di funzioni (function calling), permette a un modello di chiedere al tuo codice di eseguire una funzione. Descrivi ogni funzione in una definizione JSON, e le tre grandi API si aspettano forme diverse: OpenAI Chat Completions annida la funzione dentro un oggetto function, OpenAI Responses tiene i campi su un solo livello, Anthropic usa name e input_schema, e Gemini usa le dichiarazioni di funzione. Anche le regole sui nomi cambiano. Questo strumento legge la definizione che incolli, stabilisce per quale API è scritta e la confronta con quanto afferma la documentazione di quel fornitore: il nome, una descrizione, lo schema dei parametri, lo strict mode e, per Anthropic, se ogni esempio di input corrisponde allo schema. Segnala anche quando un nome che funziona per un'API verrebbe rifiutato da un'altra. Le regole sono state verificate sulla documentazione alla data indicata sotto lo strumento.
Casi d'uso
- Controllare la definizione di uno strumento prima di aggiungerla a una richiesta, in modo che un nome sbagliato o una forma errata non facciano fallire la chiamata
- Capire perché lo strict mode rifiuta lo schema di una funzione
- Spostare uno strumento da un fornitore a un altro e vedere cosa va cambiato
Utilizzo
- Incolla una definizione di strumento, un array di strumenti o un corpo di richiesta con un array tools, oppure carica l'esempio.
- Leggi per quale API è stato riconosciuto ciascuno strumento, poi l'elenco dei risultati. Correggi indica che secondo la documentazione verrà rifiutato o non è valido, Verifica indica che merita un'occhiata e Nota è solo informativa.
- Correggi le definizioni e incollale di nuovo. Per i problemi dello strict mode, lo Structured Output Schema Checker mostra ciascuno in dettaglio.
FAQ
Come capisce per quale API è scritta una definizione?
Dalla sua forma. Una definizione con input_schema viene letta come Anthropic. Una con type function e un oggetto function annidato viene letta come OpenAI Chat Completions, mentre una con type function e i campi al livello superiore viene letta come OpenAI Responses. Un oggetto con functionDeclarations, oppure con name, description e parameters, viene letto come Gemini. Il risultato mostra come è stato riconosciuto ogni strumento.
Quali sono le regole sui nomi?
OpenAI documenta lettere, numeri, trattini bassi e trattini, fino a 64 caratteri. Anthropic documenta lettere, numeri, trattini bassi e trattini, fino a 128 caratteri. Gemini documenta lettere, numeri, trattini bassi, due punti, punti e trattini, fino a 128 caratteri. Un nome valido per un'API può essere rifiutato da un'altra, e lo strumento ti avvisa quando succede.
Perché ricontrolla lo schema quando strict è true?
OpenAI afferma che lo strict mode richiede additionalProperties impostato su false in ogni oggetto e ogni proprietà elencata in required, con i valori facoltativi scritti come un tipo che ammette anche null. Uno schema che viola queste regole viene rifiutato. Lo strumento conta i problemi e mostra dove si trova il primo.
Cosa controlla in input_examples?
Anthropic afferma che ogni esempio deve essere valido rispetto all'input_schema dello strumento e che un esempio non valido restituisce un errore 400. Lo strumento controlla ogni esempio rispetto allo schema e ti dice quale non lo rispetta.
Cosa non controlla?
Se un determinato modello supporta lo strumento, i dettagli dell'uso strict degli strumenti per Anthropic, gli strumenti che Anthropic fornisce direttamente e tutto ciò che la documentazione non afferma. Non chiama nessuna API, quindi una definizione che supera il controllo può comunque fallire in una richiesta reale.
La mia definizione viene inviata a un server?
No. Il controllo viene eseguito nel tuo browser.