Crea la definizione di uno strumento che un modello AI può richiamare, con nome, descrizione e parametri. Esportala come JSON Schema semplice o nelle forme che si aspettano le API comuni di chiamata agli strumenti e i server MCP, e vedi i problemi prima che un modello inciampi. Funziona nel tuo browser ed è gratis e privato.
Come creare la definizione di uno strumento
- Dai il Nome dello strumento e una Descrizione chiara.
- Premi Aggiungi parametro per ogni input, e imposta il suo nome, tipo, descrizione e se è obbligatorio.
- Premi Aggiungi un altro strumento per averne più di uno, o Rimuovi questo strumento per eliminarne uno. Ricomincia cancella tutto.
- Scegli l'output: JSON Schema, oppure uno dei formati dei fornitori, oppure MCP. Attiva la Modalità strict (output strutturati) se ti serve.
- Premi Copia JSON o Scarica. Copia argomenti di esempio dà una chiamata di esempio.
Hai già una definizione? Incollala in JSON da importare e premi Importa.
Scrivere strumenti che i modelli usano bene
I modelli scelgono uno strumento leggendo nome e descrizione, quindi di' chiaramente cosa fa e quando usarlo, per esempio "Cerca nel centro assistenza. Usalo quando l'utente chiede come fare qualcosa nell'app." Descrivi ogni parametro, compresi unità e formati, come "data ISO, YYYY-MM-DD". Usa un elenco fisso di valori consentiti ogni volta che la scelta è limitata, e segna come obbligatori solo i campi davvero necessari.
Come differiscono i formati
Lo schema dei parametri è lo stesso JSON Schema ovunque; cambia il contenitore. Un fornitore lo annida sotto function.parameters, un altro lo chiama input_schema, un altro elenca dichiarazioni di funzione, e i server MCP restituiscono inputSchema. Le modalità strict aggiungono regole: ogni proprietà deve essere elencata come obbligatoria e le proprietà extra devono essere rifiutate, quindi i campi facoltativi vengono scritti come campi che permettono null.
Cosa individuano i controlli
Nomi che violano le regole delle API, come spazi o più di 64 caratteri, nomi di strumenti o parametri duplicati, valori consentiti che non corrispondono al tipo, oggetti senza proprietà e descrizioni mancanti. Gli errori fermano una chiamata API; gli avvisi sono cose che tendono a far scegliere al modello lo strumento sbagliato o a compilare il valore sbagliato.
Consigli
- Usa nomi brevi basati su un verbo come search_orders o get_weather, con solo lettere, numeri e trattini bassi.
- Tieni piccolo il numero di strumenti. I modelli scelgono meglio da un elenco breve.
- Dai a ogni parametro un esempio nella sua descrizione quando il formato non è ovvio.
- Prova lo schema su risposte vere con la verifica dello schema delle risposte AI.
Chi lo usa
Sviluppatori, freelance che creano assistenti per i clienti e studenti che imparano come funziona la chiamata agli strumenti. Per trasformare un oggetto JSON di esempio in tipi per il tuo codice, vedi Da JSON a tipi.
Domande
Che cos'è la modalità strict?
Fa seguire al modello esattamente lo schema. Richiede che ogni proprietà sia elencata come obbligatoria e che le proprietà aggiuntive siano rifiutate.
La mia definizione viene caricata?
No. Viene creata nel tuo browser.
Posso modificare una definizione esistente?
Sì. Incollala nella casella di importazione, modificala ed esporta di nuovo.