Activar la búsqueda web en la API de Grok
En esta página
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ónweb_search()importada desdexai_sdk.tools, dentro de una conversación creada porclient.chat.create; el ejemplo antiguo llamaba aclient.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 clientexai-sdk, que no tiene el atributoresponses: con este SDK, la búsqueda se realiza a través declient.chat.create(..., tools=[web_search()]), yclient.responses.create()pertenece al SDKopenaiapuntando ahttps://api.x.ai/v1. El ejemplo del SDK de Vercel AI pasaba las herramientas como un array y no importabagenerateText: se declaran en un objeto, como en la documentación de xAI. Código verificado conxai-sdk1.21.0 yopenai3.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.

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.
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:
- Análisis: el modelo evalúa si la pregunta requiere datos recientes
- Decisión: elige buscar o responder con su conocimiento interno
- Ejecución: la búsqueda web se ejecuta en el servidor (no gestionas nada)
- Procesamiento: los resultados se analizan y sintetizan
- 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"}entools(SDKopenai, API de Responses) oweb_search()enclient.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