Crea la definición de una herramienta que un modelo de IA pueda llamar, con su nombre, descripción y parámetros. Expórtala como JSON Schema sencillo o en las formas que esperan las API de llamada a herramientas y los servidores MCP más comunes, y detecta problemas antes de que un modelo tropiece con ellos. Se ejecuta en tu navegador y es gratis y privado.
Cómo crear una definición de herramienta
- Da el Nombre de la herramienta y una Descripción clara.
- Pulsa Añadir parámetro por cada entrada y fija su nombre, tipo, descripción y si es obligatorio.
- Pulsa Añadir otra herramienta para más de una, o Quitar esta herramienta para eliminar una. Empezar de nuevo lo borra todo.
- Elige la salida: JSON Schema, uno de los formatos de proveedor, o MCP. Activa el Modo estricto (salidas estructuradas) si lo necesitas.
- Pulsa Copiar JSON o Descargar. Copiar argumentos de ejemplo da una llamada de muestra.
¿Ya tienes una definición? Pégala en JSON a importar y pulsa Importar.
Escribir herramientas que los modelos usen bien
Los modelos eligen una herramienta leyendo su nombre y su descripción, así que di con claridad qué hace y cuándo usarla, por ejemplo "Busca en el centro de ayuda. Úsala cuando el usuario pregunte cómo hacer algo en la app." Describe cada parámetro, incluidas unidades y formatos, como "fecha ISO, AAAA-MM-DD". Usa una lista fija de valores permitidos siempre que la elección sea limitada y marca como obligatorios solo los campos que de verdad hagan falta.
En qué se diferencian los formatos
El esquema de parámetros es el mismo JSON Schema en todas partes; lo que cambia es la envoltura. Un proveedor lo anida en function.parameters, otro lo llama input_schema, otro enumera declaraciones de funciones, y los servidores MCP devuelven inputSchema. Los modos estrictos añaden reglas: cada propiedad debe figurar como obligatoria y se deben rechazar las propiedades adicionales, así que los campos opcionales se escriben en su lugar permitiendo null.
Qué detectan las comprobaciones
Nombres que incumplen las reglas de la API, como espacios o más de 64 caracteres, nombres de herramientas o parámetros duplicados, valores permitidos que no coinciden con el tipo, objetos sin propiedades y descripciones que faltan. Los errores detendrán una llamada a la API; las advertencias son cosas que suelen hacer que un modelo elija la herramienta equivocada o rellene el valor equivocado.
Consejos
- Usa nombres cortos basados en verbos como search_orders o get_weather, solo con letras, números y guiones bajos.
- Mantén pequeño el número de herramientas. Los modelos eligen mejor de una lista corta.
- Da a cada parámetro un ejemplo en su descripción cuando el formato no sea obvio.
- Prueba el esquema con respuestas reales usando el verificador de esquema de respuestas de IA.
Quién lo usa
Desarrolladores, freelancers que crean asistentes para clientes y estudiantes que aprenden cómo funciona la llamada a herramientas. Para convertir un objeto JSON de ejemplo en tipos para tu código, mira JSON a tipos.
Preguntas
¿Qué es el modo estricto?
Hace que el modelo siga el esquema exactamente. Requiere que todas las propiedades figuren como obligatorias y que se rechacen las propiedades adicionales.
¿Se sube mi definición?
No. Se crea en tu navegador.
¿Puedo editar una definición existente?
Sí. Pégala en el cuadro de importación, cámbiala y vuelve a exportar.