Herramienta gratis · funciona en tu navegador
Generador de esquemas para herramientas de IA
Pega un ejemplo del JSON que debe recibir tu herramienta de IA y obtén un JSON Schema o una definición completa de herramienta para Claude.
{
"name": "create_booking",
"description": "Create a table booking once the customer has given a name, date and number of people.",
"strict": true,
"input_schema": {
"type": "object",
"properties": {
"customer_name": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"people": {
"type": "integer"
},
"notes": {
"type": "string"
}
},
"required": [
"customer_name",
"date",
"people",
"notes"
],
"additionalProperties": false
}
}Respuesta rápida
El function calling y las salidas estructuradas necesitan un JSON Schema que describa los argumentos. Esta herramienta lo deduce de un ejemplo: tipos para cada campo, objetos y arrays anidados, todos los campos marcados como obligatorios y additionalProperties: false, que es lo que espera el uso estricto de herramientas. Puedes obtener un JSON Schema simple o una herramienta de Claude con name, description e input_schema.
Cómo usarla
- Pega un JSON de ejemplo. Un ejemplo realista de los argumentos, por ejemplo una reserva con nombre, fecha y número de personas.
- Ponle nombre a la herramienta. Un nombre corto y una descripción de cuándo debe usarla el modelo.
- Copia el resultado. Úsalo como definición de herramienta y añade descripciones y enums a los campos que lo necesiten.
Preguntas frecuentes
¿Qué es el function calling?
Una forma de que un modelo de IA pida a tu código que ejecute una acción, como buscar un pedido, devolviendo argumentos estructurados que cumplen un esquema que tú defines.
¿Por qué marcar todos los campos como obligatorios?
El uso estricto de herramientas espera un esquema donde todas las propiedades sean obligatorias y no se permitan otras, para que los argumentos del modelo siempre coincidan.
¿Debo editar el esquema generado?
Sí. Añade una descripción a cada campo, enums para las opciones fijas y formatos como date, para que el modelo sepa exactamente qué enviar.
¿Cómo trata los arrays el generador?
Usa el primer elemento de cada array para deducir el esquema de los elementos; asegúrate de que tu ejemplo tenga al menos uno.
¿Se sube mi JSON?
No. El esquema se genera en tu navegador.
¿Qué diferencia hay entre un JSON Schema y la definición de una herramienta?
Un JSON Schema describe datos. La definición de una herramienta envuelve un esquema con un nombre y una descripción, para que el modelo sepa cuándo y cómo llamarla.
¿Cómo escribo la descripción de una herramienta?
Di qué hace, cuándo usarla y cuándo no. El modelo lee ese texto para decidir si la llama.
¿Cómo hago opcional un campo en un esquema estricto?
El uso estricto de herramientas espera que todos los campos sean obligatorios. Para permitir "sin valor", define el tipo del campo como una unión con null, como ["string", "null"].
¿Una herramienta puede recibir objetos y arrays anidados?
Sí, y el generador deduce los esquemas anidados de tu ejemplo. Mantén poca anidación cuando puedas; los argumentos sencillos son más fáciles de rellenar bien para los modelos.
¿Debo seguir validando los argumentos en mi código?
Sí. Valida siempre antes de ejecutar nada, sobre todo las acciones con efectos, aunque el esquema sea estricto.