Cómo funciona
Tool calling es un patrón en el que un modelo de lenguaje solicita que una aplicación ejecute una herramienta, como consultar una base de datos, buscar información o llamar a una función del producto. El modelo no ejecuta automáticamente el código externo: produce una solicitud estructurada y la aplicación decide si debe ejecutarla.
Un flujo común tiene cuatro etapas. La aplicación informa al modelo qué herramientas existen y qué argumentos acepta cada una. El modelo selecciona una herramienta y devuelve los argumentos. La aplicación valida la solicitud, ejecuta la función permitida y devuelve el resultado al modelo. Por último, el modelo usa ese resultado para formular la respuesta o solicitar otra acción.
En la documentación de function calling de OpenAI, la llamada a herramientas se presenta como una interacción entre el modelo y la aplicación: el sistema anfitrión ejecuta la función y devuelve la salida. Las API pueden usar nombres y formatos distintos y algunos sistemas aceptan herramientas personalizadas con entradas que no son JSON.
El modelo puede pedir una herramienta que no existe, enviar argumentos inválidos o interpretar mal el resultado. Por eso, la aplicación debe validar tipos, límites, permisos y efectos secundarios. Para operaciones que alteran datos, envían mensajes o mueven recursos, los controles de autorización deben estar en el software, no solo en el prompt.
Ejemplo práctico
Un asistente de una tienda recibe la pregunta: “¿El pedido 4821 ya fue enviado?”. La aplicación pone a disposición una herramienta limitada llamada consultar_pedido, que acepta un identificador. El modelo puede solicitar la consulta; el servidor verifica si el usuario está autorizado a ver ese pedido, consulta el sistema y devuelve solo el estado permitido.
El modelo entonces puede responder que el pedido fue despachado, si esa información existe en el retorno. Si el pedido no se encuentra, debe comunicarlo en lugar de inventar una actualización. El acceso a la base de datos y las reglas de autorización quedan bajo control de la aplicación, no del modelo.
Una herramienta de acción exige más cuidado. Si existe una función cancelar_pedido, el sistema puede exigir confirmación explícita, verificar el estado actual y registrar la operación antes de ejecutarla. No basta aceptar cualquier argumento porque el modelo lo pidió; valide la identidad, el alcance y las consecuencias.
Para qué sirve
Tool calling conecta modelos con datos y operaciones que no están disponibles solo en el texto de entrada. Esto puede habilitar búsqueda en documentos, consulta a sistemas internos, cálculos, ejecución de tareas e integraciones con API.
El recurso es útil cuando la aplicación necesita combinar lenguaje natural con acciones controladas. Para tareas que requieren varias herramientas, un agente puede seleccionar y encadenar llamadas, pero el desarrollador sigue siendo responsable de limitar lo que se puede acceder y de manejar errores, demoras y respuestas incompletas.
Una buena herramienta tiene nombre y descripción claros, parámetros estrictos, permisos mínimos y un retorno fácil de verificar. Registre lo que se solicitó y ejecutó conforme a las políticas de privacidad y pida confirmación humana para operaciones de alto impacto. Así, el modelo ayuda a elegir el siguiente paso sin recibir autoridad ilimitada sobre el sistema.