Bouw de definitie van een tool die een AI-model kan aanroepen, met zijn naam, beschrijving en parameters. Exporteer hem als gewoon JSON Schema of in de vormen die de gangbare tool-calling-API's en MCP-servers verwachten, en zie problemen voordat een model erover struikelt. Het draait in je browser en is gratis en privé.
Hoe je een tooldefinitie bouwt
- Geef de Toolnaam en een duidelijke Beschrijving.
- Druk op Parameter toevoegen voor elke invoer en stel de naam, het type, de beschrijving in en of hij verplicht is.
- Druk op Nog een tool toevoegen voor meer dan één, of op Deze tool verwijderen om er een te wissen. Opnieuw beginnen wist alles.
- Kies de uitvoer: JSON Schema, of een van de aanbiederformaten, of MCP. Zet de Strikte modus (gestructureerde uitvoer) aan als je die nodig hebt.
- Druk op JSON kopiëren of Downloaden. Voorbeeldargumenten kopiëren geeft een voorbeeldaanroep.
Heb je al een definitie? Plak hem in JSON om te importeren en druk op Importeren.
Tools schrijven die modellen goed gebruiken
Modellen kiezen een tool door zijn naam en beschrijving te lezen, dus zeg duidelijk wat hij doet en wanneer je hem gebruikt, bijvoorbeeld “Doorzoek het helpcentrum. Gebruik wanneer de gebruiker vraagt hoe iets in de app moet.” Beschrijf elke parameter, ook eenheden en formaten, zoals “ISO-datum, YYYY-MM-DD”. Gebruik een vaste lijst met toegestane waarden als de keuze beperkt is en markeer alleen de velden die echt nodig zijn als verplicht.
Hoe de formaten verschillen
Het parameterschema is overal hetzelfde JSON Schema; wat verandert is de verpakking. De ene aanbieder nest het onder function.parameters, een andere noemt het input_schema, een andere somt functiedeclaraties op en MCP-servers geven inputSchema terug. Strikte modi voegen regels toe: elke eigenschap moet als verplicht staan en extra eigenschappen moeten worden geweigerd, dus optionele velden worden in plaats daarvan geschreven als null toestaand.
Wat de controles opvangen
Namen die API-regels breken, zoals spaties of meer dan 64 tekens, dubbele tool- of parameternamen, toegestane waarden die niet bij het type passen, objecten zonder eigenschappen en ontbrekende beschrijvingen. Fouten stoppen een API-aanroep; waarschuwingen zijn dingen die een model de verkeerde tool laten kiezen of de verkeerde waarde laten invullen.
Tips
- Gebruik korte, op werkwoorden gebaseerde namen zoals search_orders of get_weather, met alleen letters, cijfers en underscores.
- Houd het aantal tools klein. Modellen kiezen beter uit een korte lijst.
- Geef elke parameter een voorbeeld in zijn beschrijving als het formaat niet vanzelfsprekend is.
- Test het schema tegen echte antwoorden met de schemacontrole voor AI-antwoorden.
Wie gebruikt het
Ontwikkelaars, freelancers die assistenten voor klanten bouwen en studenten die leren hoe tool calling werkt. Zie JSON naar types om een voorbeeld-JSON-object om te zetten in types voor je code.
Vragen
Wat is de strikte modus?
Het laat het model het schema exact volgen. Het vereist dat elke eigenschap als verplicht staat en dat extra eigenschappen worden geweigerd.
Wordt mijn definitie geüpload?
Nee. Het wordt in je browser gebouwd.
Kan ik een bestaande definitie bewerken?
Ja. Plak hem in het importvak, wijzig hem en exporteer opnieuw.