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

Activar la búsqueda web en la API de Grok

Lección 1 de 14 Actualizado el 3 de noviembre de 2026 Principiante
En esta página
  1. Por qué conectar Grok a la web en tiempo real
  2. La API de Responses: el único endpoint compatible
  3. El flujo de ejecución en cinco pasos
  4. Uso con diferentes SDK
  5. Práctica guiada
  6. Puntos clave

Actualizado el 2 de noviembre de 2026. Según la documentación de xAI: con el xai-sdk, la búsqueda web se activa mediante la función web_search() importada desde xai_sdk.tools, dentro de una conversación creada por client.chat.create; el ejemplo antiguo llamaba a client.tools.web_search(), lo cual no existe en este SDK. Fuente: Búsqueda web.

Actualizado el 3 de noviembre de 2026. El primer ejemplo llamaba a client.responses.create() en el cliente xai-sdk, que no tiene el atributo responses: con este SDK, la búsqueda se realiza a través de client.chat.create(..., tools=[web_search()]), y client.responses.create() pertenece al SDK openai apuntando a https://api.x.ai/v1. El ejemplo del SDK de Vercel AI pasaba las herramientas como un array y no importaba generateText: se declaran en un objeto, como en la documentación de xAI. Código verificado con xai-sdk 1.21.0 y openai 3.42.1. Fuente: Búsqueda web.

Por qué conectar Grok a la web en tiempo real

Los modelos de lenguaje clásicos trabajan con conocimientos congelados en su fecha de entrenamiento. Para un desarrollador que construye aplicaciones que requieren datos actuales (cotizaciones bursátiles, noticias, resultados deportivos, meteorología), esta limitación es un obstáculo insalvable. La herramienta web_search en la API de Grok resuelve este problema permitiendo al modelo consultar la web en tiempo real, directamente desde tu llamada a la API.

Búsqueda web con Grok

A diferencia de otros proveedores que requieren integraciones de terceros o complementos separados, xAI ofrece la búsqueda web como una herramienta integrada en el servidor. No tienes infraestructura que gestionar: el modelo decide cuándo buscar, ejecuta la consulta e integra los resultados en su respuesta.

5
USD por cada 1.000 llamadas
5
dominios filtrables
0
infraestructura que gestionar
Automático
citas incluidas

La API de Responses: el único endpoint compatible

La búsqueda web funciona exclusivamente en la API de Responses. El antiguo endpoint de Chat Completions ofrecía un parámetro search_parameters, pero ahora está obsoleto. Si estás migrando desde la API antigua, tendrás que adaptar tus llamadas.

La activación se produce añadiendo la herramienta web_search al array tools en tu solicitud:

import os

from openai import OpenAI

client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")

response = client.responses.create(
    model="grok-4.5",
    input="What is the weather like in Paris today?",
    tools=[{"type": "web_search"}],
)

print(response.output_text)

Este ejemplo utiliza el SDK openai, compatible con la API de Responses de xAI; el SDK nativo de xAI, que se presenta a continuación, funciona a través de una conversación.

Eso es todo. El modelo analiza tu prompt, determina si necesita información actualizada y activa la búsqueda automáticamente. No tienes que gestionar un bucle de llamadas ni lógica condicional.

El flujo de ejecución en cinco pasos

Cuando envías una solicitud con web_search activado, el proceso sigue una secuencia específica:

  1. Análisis: el modelo evalúa si la pregunta requiere datos recientes
  2. Decisión: elige buscar o responder con su conocimiento interno
  3. Ejecución: la búsqueda web se ejecuta en el servidor (no gestionas nada)
  4. Procesamiento: los resultados se analizan y sintetizan
  5. Respuesta: se genera el texto final con las citas asociadas

Este mecanismo significa que el modelo puede decidir no buscar si la pregunta no lo justifica. Por ejemplo, preguntar por la definición de fotosíntesis probablemente no activará una búsqueda web.

Uso con diferentes SDK

El SDK de xAI proporciona una función dedicada, web_search(), para pasarla a la lista de herramientas de la conversación:

# SDK nativo de xAI
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search

client = Client()
chat = client.chat.create(model="grok-4.5", tools=[web_search()])
chat.append(user("Latest AI news in Europe"))

response = chat.sample()
print(response.content)
print(response.citations)

Con el SDK openai, es la llamada del inicio de la lección: client.responses.create() con base_url="https://api.x.ai/v1" y tools=[{"type": "web_search"}].

Para el SDK de Vercel AI en JavaScript:

import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';

const { text, sources } = await generateText({
  model: xai.responses('grok-4.5'),
  prompt: "Latest AI news in Europe",
  tools: {
    web_search: xai.tools.webSearch(),
  },
});

console.log(text);
console.log('Citations:', sources);

Práctica guiada

Crea un script que consulte a Grok sobre un evento actual de tu elección. Verifica que la respuesta contenga información reciente (fechas, eventos ocurridos después de la fecha de corte del modelo). Luego, prueba la misma pregunta sin la herramienta web_search para observar la diferencia.

Puntos clave

  • La búsqueda web se activa con {"type": "web_search"} en tools (SDK openai, API de Responses) o web_search() en client.chat.create (xai-sdk)
  • Solo funciona en la API de Responses (no en Chat Completions)
  • El modelo decide autónomamente cuándo necesita buscar
  • Las citas se incluyen automáticamente en la respuesta
  • El coste es de 5 $ por cada 1.000 llamadas a la herramienta, más los tokens consumidos