Ir al contenido principal
Español— Elegir un idioma
Menú

Herramientas integradas para la API de Responses

Lección 9 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Añadir capacidades al modelo
  2. Los 4 tipos de herramientas
  3. Combinar varias herramientas
  4. Herramientas del lado del servidor frente al lado del cliente
  5. Puntos clave

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.

web_search
Búsqueda web en tiempo real
x_search
Búsqueda en X
code
Intérprete de Python
function
Funciones personalizadas

Los 4 tipos de herramientas

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.

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 function se 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