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

Activar la búsqueda web en la API

Lección 4 de 16 Actualizado el 2 de noviembre de 2026 Desarrollador
En esta página
  1. Otorga a Grok acceso a la web en tiempo real
  2. Requisitos previos: la API de Respuestas
  3. Activación básica
  4. Activación con el SDK de xAI (Python)
  5. Activación con el SDK de OpenAI
  6. Activación con el SDK de Vercel AI
  7. Combina la búsqueda web con otras herramientas
  8. Puntos clave

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ón web_search() importada desde xai_sdk.tools, dentro de una conversación creada por client.chat.create; el ejemplo antiguo que llamaba a client.tools.web_search() y client.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.

Respuestas
API necesaria
5
Dominios filtrables
Automático
Citas incluidas
5 €
/ 1.000 llamadas

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 array tools
  • 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