Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Ativar a Pesquisa Web na API do Grok

Aula 1 de 14 Atualizada a 3 de novembro de 2026 Iniciante
Nesta página
  1. Por Que Ligar o Grok à Web em Tempo Real
  2. A API de Respostas: O Único Endpoint Suportado
  3. O Fluxo de Execução em Cinco Passos
  4. Utilização com Diferentes SDKs
  5. Prática Guiada
  6. Pontos-chave

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ção web_search() importada de xai_sdk.tools, dentro de uma conversa criada por client.chat.create; o exemplo antigo chamava client.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 cliente xai-sdk, que não possui o atributo responses: com este SDK, a pesquisa ocorre através de client.chat.create(..., tools=[web_search()]), e client.responses.create() pertence ao SDK openai apontado para https://api.x.ai/v1. O exemplo do Vercel AI SDK passava as ferramentas como um array e não importava generateText: elas são declaradas num objeto, conforme a documentação da xAI. Código verificado com xai-sdk 1.21.0 e openai 3.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.

Pesquisa Web com Grok

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.

$5
por 1.000 chamadas
5
domínios filtráveis
0
infraestrutura para gerir
Automático
citações incluídas

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:

  1. Análise: o modelo avalia se a questão requer dados recentes
  2. Decisão: escolhe pesquisar ou responder com o seu conhecimento interno
  3. Execução: a pesquisa web corre no lado do servidor (não gere nada)
  4. Processamento: os resultados são analisados e sintetizados
  5. 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"} em tools (SDK openai, API de Respostas) ou web_search() em client.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