Esquemas de Herramientas (Tools & JSON Schema)
Estándar de descripción formalizada de interfaces de herramientas (Tools) para grandes modelos de lenguaje utilizando el estándar JSON Schema. Incluye el nombre de la función, una descripción detallada de su propósito, una lista de parámetros obligatorios y tipos de valores.
1. Visión general del concepto y problema sistémico
Imagina que has contratado a un nuevo asistente en la oficina y le dices: «Aquí tenemos un programa especial, úsalo». Pero no le explicaste qué hacen los botones ni qué campos debe completar. Por supuesto, el asistente se confundirá.
Para que el modelo de lenguaje sepa qué herramientas digitales tiene, los desarrolladores le transmiten el Esquema de Herramientas (Tool Schema).
Es una descripción compacta, elaborada según el estándar JSON Schema:
- Nombre (Name): nombre corto del botón (por ejemplo,
book_hotel). - Descripción (Description): para qué sirve esta acción en palabras humanas.
- Parámetros (Parameters): qué datos se necesitan para ejecutarla (ciudad, fecha de entrada, número de huéspedes).
Modelo mental: instrucciones de trabajo para la IA: lista de herramientas en el cinturón del maestro con una descripción clara de cuándo usar un martillo y cuándo un destornillador.
2. Cómo se ve un esquema de herramienta real
{
"name": "calculate_mortgage",
"description": "Calcula el pago mensual de un préstamo hipotecario.",
"parameters": {
"type": "object",
"properties": {
"loan_amount": {
"type": "number",
"description": "Monto total del préstamo en moneda local, por ejemplo 1500000"
},
"years": {
"type": "integer",
"description": "Plazo del préstamo en años de 1 a 30"
},
"interest_rate": {
"type": "number",
"description": "Tasa de interés anual en porcentaje, por ejemplo 7.5"
}
},
"required": ["loan_amount", "years"]
}
}
3. Cuatro reglas de oro para crear un buen esquema
- Escribe la descripción como si se la explicaras a un pasante: indica no solo lo que hace la herramienta, sino también cuándo NO debe ser llamada.
- Proporciona ejemplos en el campo de descripción: «el formato de fecha es estrictamente YYYY-MM-DD, por ejemplo 2026-05-18».
- Limita las opciones usando
enum: si el estado del pedido solo puede ser de tres tipos, especifica estrictamente:["pending", "shipped", "delivered"]. - Marca los campos obligatorios en el array
required: si la función no puede operar sin el correo electrónico del cliente, no permitas que el modelo la ejecute a ciegas.
4. Escenarios prácticos de ingeniería en producción
01. Integración de un nuevo esquema de herramienta
Implementar un nuevo esquema de herramienta en un modelo de lenguaje requiere una revisión exhaustiva de la descripción y parámetros para evitar confusiones en la ejecución.
02. Validación de entradas en tiempo real
Al utilizar el esquema de herramienta, asegúrate de que los datos de entrada se validen en tiempo real para prevenir errores de ejecución y mejorar la experiencia del usuario.
03. Monitoreo de errores de función
Implementar un sistema de monitoreo para detectar y registrar errores en la llamada de funciones, permitiendo ajustes rápidos en los esquemas de herramientas según sea necesario.
5. Errores comunes, trampas y seguridad
La calidad y autonomía de tu agente de IA depende en un 80% no del tamaño del modelo, sino de la calidad y claridad de las descripciones en tus esquemas de herramientas. Cuanto más claro sea el esquema, menos errores cometerá el agente.
FAQ: Esquemas de Herramientas (Tools & JSON Schema)
Términos relacionados
Llamada a Funciones (Function Calling / Tool Calling)
Protocolo técnico y estándar de interacción entre LLM y software externo. En lugar de texto libre, el modelo devuelve un JSON válido con el nombre de la función y argumentos tipados según el esquema JSON Schema, permitiendo al backend ejecutar acciones de manera determinista en APIs reales.
Selección Dinámica de Herramientas (Dynamic Tool Selection)
Enfoque arquitectónico para construir agentes de IA escalables con cientos de herramientas. En lugar de cargar todas las descripciones de funciones en el contexto simultáneamente, el sistema utiliza búsqueda semántica o un modelo enrutador (Router) para seleccionar dinámicamente solo de 3 a 5 herramientas más relevantes para una consulta específica del usuario.
Ciclo de Acción del Agente (Thought ➔ Action ➔ Observation / ReAct)
Patrón algorítmico fundamental para el funcionamiento de agentes autónomos (conocido como ReAct: Reasoning + Acting). Consiste en un ciclo infinito de tres pasos: 1) Pensamiento (Thought) — análisis de la situación; 2) Acción (Action) — llamada a la herramienta; 3) Observación (Observation) — análisis del resultado y ajuste del plan.