Activar la búsqueda web en la API
En esta página
Actualizado el 2 de noviembre de 2026. Según la documentación de xAI: con
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 que llamaba aclient.tools.web_search()yclient.responses.create()no existe en este SDK. Fuente: Web Search.
Otorga a Grok acceso a la web en tiempo real
La búsqueda web es la herramienta integrada más utilizada en la API de Grok. Permite al modelo buscar información actualizada en la red, superando el límite natural de sus datos de entrenamiento. La activación es sencilla, pero hay puntos clave que debes dominar para usarla con eficacia.
Requisitos previos: la API de Respuestas
La búsqueda web está disponible exclusivamente en la API de Respuestas. La antigua API de Finalizaciones de Chat (Chat Completions) ofrecía un sistema de «Búsqueda en directo» que ahora está obsoleto. Si aún usas Finalizaciones de Chat para búsquedas web, debes migrar a la API de Respuestas.
La API de Respuestas utiliza client.responses.create() en lugar de client.chat.completions.create(). La estructura de la solicitud y de la respuesta difiere, pero tanto el SDK de xAI como el de OpenAI las admiten.
Activación básica
Activas la búsqueda web añadiendo un objeto {"type": "web_search"} al array tools de tu solicitud:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Esto es todo lo que necesitas para una búsqueda web básica. El modelo determina automáticamente si debe realizar una búsqueda y formula la consulta óptima a partir del mensaje del usuario.
Activación con el SDK de xAI (Python)
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.20-0309-reasoning",
tools=[web_search()],
)
chat.append(user("What are the latest advancements in AI?"))
response = chat.sample()
print(response.content)
print(response.citations)
El SDK proporciona la función web_search(), que genera el objeto de configuración de la herramienta. También acepta allowed_domains o excluded_domains —hasta cinco dominios, y nunca ambos en la misma solicitud.
Activación con el SDK de OpenAI
from openai import OpenAI
client = OpenAI(
api_key="xai-your-key",
base_url="https://api.x.ai/v1"
)
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What are the latest advancements in AI?",
tools=[{"type": "web_search"}]
)
El SDK de OpenAI funciona con la API de Grok simplemente cambiando la base_url. La sintaxis de la herramienta permanece idéntica.
Activación con el SDK de Vercel AI
import { xai } from "@ai-sdk/xai";
const response = await generateText({
model: xai("grok-4.20-0309-reasoning"),
prompt: "What are the latest advancements in AI?",
tools: [xai.tools.webSearch()]
});
El SDK de Vercel AI utiliza xai.tools.webSearch() siguiendo la convención camelCase de JavaScript.
Combina la búsqueda web con otras herramientas
Puedes activar varias herramientas simultáneamente. El modelo elegirá la más adecuada o las usará de forma secuencial:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
En este ejemplo, el modelo puede buscar datos en la web y luego analizarlos con la Ejecución de Código.
Puntos clave
- La búsqueda web está disponible exclusivamente en la API de Respuestas; Finalizaciones de Chat está obsoleta para esta función
- Actívala con
{"type": "web_search"}en el arraytools - El modelo decide automáticamente cuándo y cómo buscar
- Todos los SDK (xAI, OpenAI, Vercel AI) admiten la búsqueda web
- Puedes activar varias herramientas simultáneamente en la misma solicitud