~/tools / Tool Definition Checker
Tool Definition Checker — Comprueba definiciones de herramientas para OpenAI, Anthropic y Gemini
Comprueba las definiciones de herramientas (funciones) que envías a OpenAI, Anthropic o Gemini con el formato documentado de cada API: nombres, descripciones, esquemas de parámetros, strict mode y ejemplos de entrada. Encuentra los errores antes de que la solicitud falle. Nada sale de tu navegador.
Reglas comprobadas con la documentación el 2026-10-23.
Documentación: OpenAI / Anthropic / Referencia de la API de Gemini
No se comprueba: si un modelo admite la herramienta, los detalles del uso estricto de herramientas en Anthropic, las herramientas que proporciona la propia Anthropic ni las reglas que la documentación no indica.
Todo se ejecuta en tu navegador. Las definiciones no se suben.
El uso de herramientas (tool use), también llamado llamada a funciones (function calling), permite que un modelo pida a tu código que ejecute una función. Describes cada función en una definición JSON, y las tres grandes API esperan formas distintas: OpenAI Chat Completions anida la función dentro de un objeto function, OpenAI Responses mantiene sus campos en un solo nivel, Anthropic usa name e input_schema, y Gemini usa declaraciones de funciones. Las reglas para los nombres también difieren. Esta herramienta lee la definición que pegas, deduce para qué API está escrita y la comprueba con lo que dice la documentación de ese proveedor: el nombre, la descripción, el esquema de parámetros, strict mode y, en el caso de Anthropic, si cada ejemplo de entrada coincide con el esquema. También avisa cuando un nombre que funciona en una API sería rechazado por otra. Las reglas se comprobaron con la documentación en la fecha que aparece debajo de la herramienta.
Casos de uso
- Comprobar una definición de herramienta antes de añadirla a una solicitud, para que un nombre erróneo o una forma incorrecta no haga fallar la llamada
- Averiguar por qué strict mode rechaza el esquema de una función
- Pasar una herramienta de un proveedor a otro y ver qué hay que cambiar
Cómo usarlo
- Pega una definición de herramienta, un array de herramientas o un cuerpo de solicitud que tenga un array tools, o carga el ejemplo.
- Mira para qué API se reconoció cada herramienta y después la lista de hallazgos. Corregir significa que la documentación dice que se rechazará o que no es válido, Revisar significa que merece una mirada, y Nota es solo información.
- Corrige las definiciones y vuelve a pegarlas. Si el problema es de strict mode, el Structured Output Schema Checker muestra cada uno con detalle.
FAQ
¿Cómo sabe para qué API es una definición?
Por su forma. Una definición con input_schema se lee como Anthropic. Una con type function y un objeto function anidado se lee como OpenAI Chat Completions, y una con type function y sus campos en el nivel superior se lee como OpenAI Responses. Un objeto con functionDeclarations, o con name, description y parameters, se lee como Gemini. El resultado muestra qué se reconoció en cada herramienta.
¿Cuáles son las reglas para los nombres?
OpenAI documenta letras, números, guiones bajos y guiones, hasta 64 caracteres. Anthropic documenta letras, números, guiones bajos y guiones, hasta 128 caracteres. Gemini documenta letras, números, guiones bajos, dos puntos, puntos y guiones, hasta 128 caracteres. Un nombre válido para una API puede ser rechazado por otra, y la herramienta te avisa cuando ocurre.
¿Por qué vuelve a comprobar el esquema cuando strict es true?
OpenAI dice que strict mode exige additionalProperties con valor false en cada objeto y todas las propiedades listadas en required, con los valores opcionales escritos como un tipo que también admita null. Un esquema que incumple estas reglas se rechaza. La herramienta cuenta los problemas y muestra dónde está el primero.
¿Qué comprueba en input_examples?
Anthropic dice que cada ejemplo debe ser válido según el input_schema de la herramienta y que un ejemplo no válido devuelve un error 400. La herramienta comprueba cada ejemplo con el esquema y te indica cuál falla.
¿Qué no comprueba?
Si un modelo concreto admite la herramienta, los detalles del uso estricto de herramientas en Anthropic, las herramientas que proporciona la propia Anthropic y todo lo que la documentación no indica. No llama a ninguna API, así que una definición que pasa aquí aún puede fallar en una solicitud real.
¿Mi definición se envía a un servidor?
No. La comprobación se ejecuta en tu navegador.