Comprensión de la llamada a funciones
En esta página
¿Qué es la llamada a funciones?
La llamada a funciones es una de las funcionalidades más potentes de la API de Grok. Permite que el modelo solicite la ejecución de funciones que tú hayas definido, con el fin de obtener datos o realizar acciones en el mundo real.
Punto clave que debes entender: Grok nunca ejecuta las funciones por sí mismo. El modelo analiza tu solicitud, determina que necesita información externa y te devuelve una llamada estructurada (nombre de la función + argumentos). Es el código de tu lado del cliente el que ejecuta realmente la función y luego envía el resultado de vuelta al modelo.
El flujo de 6 pasos
Cada interacción de llamada a funciones sigue un ciclo preciso de seis pasos. Este flujo es fundamental, ya que estructura toda tu arquitectura.
Definir herramientas
Describes tus funciones mediante esquemas JSON: nombre, descripción y parámetros esperados.
Enviar la solicitud
Envías el mensaje del usuario junto con las definiciones de las herramientas a la API.
Recibir la tool_call
El modelo devuelve un objeto tool_call con el nombre de la función y los argumentos en formato JSON.
Ejecutar la función
Tu código del lado del cliente ejecuta la función real (llamada a API, consulta a base de datos, cálculo, etc.).
Devolver el resultado
Envías el resultado de la ejecución de vuelta al modelo en un mensaje con el rol tool.
Respuesta final
El modelo integra el resultado y genera una respuesta en lenguaje natural para el usuario.
¿Por qué es tan importante la llamada a funciones?
Sin la llamada a funciones, un modelo de lenguaje está limitado a los conocimientos de su entrenamiento. No puede consultar una base de datos, preguntar a una API de terceros ni realizar un cálculo en tiempo real. La llamada a funciones resuelve este problema fundamental al dotar al modelo de la capacidad de interactuar con el mundo exterior de forma estructurada y controlada.
Estos son algunos casos de uso concretos:
- Datos en tiempo real: meteorología, cotizaciones bursátiles, estados de pedidos
- Acciones empresariales: crear un ticket, enviar un correo electrónico, reservar una plaza
- Cálculos precisos: operaciones matemáticas, conversiones, agregaciones
- Bases de datos: búsqueda de productos, historial de clientes, inventario
La diferencia con un prompt estándar
En un intercambio estándar, haces una pregunta y el modelo responde directamente. Con la llamada a funciones, el modelo puede pausar su respuesta para solicitar información adicional mediante una llamada a función. Esta capacidad de interrumpir el flujo de generación es lo que hace tan potente este mecanismo.
El modelo razona así: «Para responder a esta pregunta, necesito conocer el tiempo actual en París. Voy a llamar a la función get_weather con el parámetro city: Paris».
Límites que debes conocer
La API de Grok acepta hasta 200 herramientas por solicitud. Esto es más que suficiente para la mayoría de los casos de uso, pero ten en cuenta que cada definición de herramienta consume tokens de entrada. Cuantas más herramientas declares, más cara será la solicitud y más tiempo tardará el modelo en elegir la herramienta adecuada.
Puntos clave
- La llamada a funciones permite que el modelo solicite la ejecución de funciones, no que las ejecute él mismo
- El flujo sigue siempre 6 pasos: definir, enviar, recibir, ejecutar, devolver, responder
- Las funciones se ejecutan del lado del cliente, en tu código
- Máximo 200 herramientas por solicitud
- Cada definición de herramienta consume tokens: sé selectivo