Herramientas integradas para la API de Responses
En esta página
Añadir capacidades al modelo
Los modelos Grok no se limitan a la generación de texto. Mediante el parámetro tools, puedes dotarlos de acceso a herramientas que amplían significativamente sus capacidades: búsqueda web en tiempo real, búsqueda en X (anteriormente Twitter), ejecución de código Python y tus propias funciones personalizadas.
Los 4 tipos de herramientas
web_search
Permite al modelo buscar información en la web en tiempo real:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the latest news on AI in Europe?",
"tools": [{"type": "web_search"}]
}
El modelo decide automáticamente cuándo realizar una búsqueda. Los resultados se integran en su respuesta con las citas correspondientes.
x_search
Busca publicaciones en X (anteriormente Twitter):
{
"model": "grok-4.20-0309-reasoning",
"input": "What is the tech community saying about the latest iPhone?",
"tools": [{"type": "x_search"}]
}
Resulta especialmente útil para captar la opinión pública, tendencias y reacciones en tiempo real.
code_interpreter
Ejecuta código Python en el servidor para realizar cálculos, analizar datos o crear gráficos:
{
"model": "grok-4.20-0309-reasoning",
"input": "Calculate the mean and standard deviation of these values: 12, 15, 18, 22, 9, 31",
"tools": [{"type": "code_interpreter"}]
}
El modelo escribe código Python, lo ejecuta en los servidores de xAI e integra los resultados en su respuesta.
function
Tus propias funciones, que el modelo puede invocar. El modelo genera los argumentos, pero tu código es el que ejecuta la función:
{
"model": "grok-4.20-0309-reasoning",
"input": "What's the weather in Paris?",
"tools": [{
"type": "function",
"name": "get_weather",
"description": "Retrieves the weather for a given city",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "City name"},
"unit": {"type": "string", "enum": ["celsius", "fahrenheit"]}
},
"required": ["city"]
}
}]
}
Combinar varias herramientas
Puedes enviar hasta 128 herramientas en una única solicitud. El modelo elige la que mejor se adapte (o varias de ellas):
{
"model": "grok-4.20-0309-reasoning",
"input": "Search for the latest Ligue 1 results and create a scoreboard.",
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
En este ejemplo, el modelo podría usar primero web_search para encontrar los resultados y después code_interpreter para darles formato en una tabla.
Herramientas del lado del servidor frente al lado del cliente
La distinción es fundamental:
-
Herramientas del lado del servidor (
web_search,x_search,code_interpreter): Las ejecutan automáticamente los servidores de xAI. No tienes que hacer nada: el modelo lanza la búsqueda o el código, recupera el resultado y lo integra en su respuesta. -
Herramientas del lado del cliente (
function): El modelo genera una llamada a función con sus argumentos y luego pausa la generación. Tu código ejecuta la función y tú envías el resultado de vuelta en una nueva solicitud.
Esta diferencia afecta directamente a la arquitectura de tu aplicación, como verás en las siguientes lecciones.
Puntos clave
- Cuatro tipos de herramientas:
web_search,x_search,code_interpreter,function - Las tres primeras se ejecutan del lado del servidor; no requieren infraestructura por tu parte
- Las herramientas
functionse ejecutan del lado del cliente; tu código se encarga de la ejecución - Puedes combinar hasta 128 herramientas por solicitud
- El modelo decide automáticamente cuándo y qué herramientas usar