Ativar a Pesquisa Web na API do Grok
Nesta página
Atualizado a 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, dentro de uma conversa criada porclient.chat.create; o exemplo antigo chamavaclient.tools.web_search(), o que não existe neste SDK. Fonte: Web Search.
Atualizado a 3 de novembro de 2026. O primeiro exemplo chamava
client.responses.create()no clientexai-sdk, que não possui o atributoresponses: com este SDK, a pesquisa ocorre através declient.chat.create(..., tools=[web_search()]), eclient.responses.create()pertence ao SDKopenaiapontado parahttps://api.x.ai/v1. O exemplo do Vercel AI SDK passava as ferramentas como um array e não importavagenerateText: elas são declaradas num objeto, conforme a documentação da xAI. Código verificado comxai-sdk1.21.0 eopenai3.42.1. Fonte: Web Search.
Por Que Ligar o Grok à Web em Tempo Real
Os modelos de linguagem clássicos funcionam com conhecimento congelado na data do seu treino. Para um programador que constrói aplicações que exigem dados atuais (cotações bolsistas, notícias, resultados desportivos, meteorologia), esta limitação é impeditiva. A ferramenta web_search na API do Grok resolve este problema, permitindo ao modelo consultar a web em tempo real, diretamente a partir da sua chamada à API.

Ao contrário de outros fornecedores que exigem integrações de terceiros ou plugins separados, a xAI oferece a pesquisa web como uma ferramenta nativa do lado do servidor. Não tem infraestrutura para gerir: o modelo decide quando pesquisar, executa a consulta e integra os resultados na sua resposta.
A API de Respostas: O Único Endpoint Suportado
A pesquisa web funciona exclusivamente na API de Respostas. O antigo endpoint de Completions de Chat oferecia um parâmetro search_parameters, mas está agora obsoleto. Se estiver a migrar da antiga API, terá de adaptar as suas chamadas.
A ativação ocorre adicionando a ferramenta web_search ao array tools no seu pedido:
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 exemplo utiliza o SDK openai, compatível com a API de Respostas da xAI; o SDK nativo da xAI, apresentado abaixo, passa por uma conversa.
É só isto. O modelo analisa o seu prompt, determina se necessita de informações recentes e aciona a pesquisa automaticamente. Não tem de gerir nenhum ciclo de chamadas ou lógica condicional.
O Fluxo de Execução em Cinco Passos
Quando envia um pedido com web_search ativado, o processo segue uma sequência específica:
- Análise: o modelo avalia se a questão requer dados recentes
- Decisão: escolhe pesquisar ou responder com o seu conhecimento interno
- Execução: a pesquisa web corre no lado do servidor (não gere nada)
- Processamento: os resultados são analisados e sintetizados
- Resposta: o texto final é gerado com as citações associadas
Este mecanismo significa que o modelo pode decidir não pesquisar se a questão não o justificar. Por exemplo, pedir a definição de fotossíntese provavelmente não acionará uma pesquisa web.
Utilização com Diferentes SDKs
O SDK da xAI fornece uma função dedicada, web_search(), para passar na lista de ferramentas da conversa:
# SDK nativo da 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)
Com o SDK openai, trata-se da chamada do início da lição: client.responses.create() com base_url="https://api.x.ai/v1" e tools=[{"type": "web_search"}].
Para o Vercel AI SDK em 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ática Guiada
Crie um script que questione o Grok sobre um evento atual à sua escolha. Verifique se a resposta contém informações recentes (datas, eventos ocorridos após a data de corte do modelo). Em seguida, tente a mesma pergunta sem a ferramenta web_search para observar a diferença.
Pontos-chave
- A pesquisa web ativa-se com
{"type": "web_search"}emtools(SDKopenai, API de Respostas) ouweb_search()emclient.chat.create(xai-sdk) - Funciona apenas na API de Respostas (não em Chat Completions)
- O modelo decide autonomamente quando precisa de pesquisar
- As citações são incluídas automaticamente na resposta
- O custo é de 5 USD por 1.000 chamadas à ferramenta, mais os tokens consumidos