Ativar a Pesquisa Web na API
Nesta página
Atualizado em 2 de novembro de 2026. Com base na documentação da xAI: com o
xai-sdk, a pesquisa web é ativada através da funçãoweb_search()importada dexai_sdk.tools, numa conversa criada porclient.chat.create; o exemplo antigo chamavaclient.tools.web_search()eclient.responses.create, que não existem neste SDK. Fonte: Web Search.
Dar ao Grok acesso à web em tempo real
A Pesquisa Web é a ferramenta integrada mais utilizada na API do Grok. Permite ao modelo procurar informações atualizadas na web, colmatando o limite natural dos seus dados de treino. A ativação é simples, mas existem pontos-chave que deve dominar para a utilizar eficazmente.
Pré-requisitos: A API de Respostas
A Pesquisa Web está disponível exclusivamente na API de Respostas. A antiga API de Completions de Chat oferecia um sistema de “Pesquisa em Direto” que está agora obsoleto. Se ainda utiliza a API de Completions de Chat para pesquisa web, deve migrar para a API de Respostas.
A API de Respostas utiliza client.responses.create() em vez de client.chat.completions.create(). A estrutura do pedido e da resposta difere, mas tanto o SDK da xAI como o SDK da OpenAI suportam-nas.
Ativação básica
Ativa a Pesquisa Web adicionando um objeto {"type": "web_search"} ao array tools no seu pedido:
{
"model": "grok-4.20-0309-reasoning",
"input": "What are the latest advancements in artificial intelligence?",
"tools": [
{"type": "web_search"}
]
}
Isto é tudo o que precisa para uma pesquisa web básica. O modelo determina automaticamente se deve realizar uma pesquisa e formula a consulta de pesquisa ideal a partir da mensagem do utilizador.
Ativação com o SDK da 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)
O SDK fornece a função web_search(), que gera o objeto de configuração da ferramenta. Aceita também allowed_domains ou excluded_domains — até cinco domínios, e nunca ambos no mesmo pedido.
Ativação com o SDK da 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"}]
)
O SDK da OpenAI funciona com a API do Grok simplesmente alterando o base_url. A sintaxe da ferramenta permanece idêntica.
Ativação com o SDK 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()]
});
O SDK Vercel AI utiliza xai.tools.webSearch() com a convenção camelCase do JavaScript.
Combinar pesquisa web com outras ferramentas
Pode ativar várias ferramentas simultaneamente. O modelo escolherá a mais adequada ou utilizá-las-á sequencialmente:
{
"tools": [
{"type": "web_search"},
{"type": "code_interpreter"}
]
}
Neste exemplo, o modelo pode procurar dados na web e, em seguida, analisá-los com a Execução de Código.
Pontos-chave
- A Pesquisa Web está disponível exclusivamente na API de Respostas — a API de Completions de Chat está obsoleta para esta funcionalidade
- Ative-a com
{"type": "web_search"}no arraytools - O modelo decide automaticamente quando e como pesquisar
- Todos os SDKs (xAI, OpenAI, Vercel AI) suportam a Pesquisa Web
- Pode ativar várias ferramentas simultaneamente no mesmo pedido