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

Ativar a Pesquisa Web na API

Aula 4 de 16 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. Dar ao Grok acesso à web em tempo real
  2. Pré-requisitos: A API de Respostas
  3. Ativação básica
  4. Ativação com o SDK da xAI (Python)
  5. Ativação com o SDK da OpenAI
  6. Ativação com o SDK Vercel AI
  7. Combinar pesquisa web com outras ferramentas
  8. Pontos-chave

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ção web_search() importada de xai_sdk.tools, numa conversa criada por client.chat.create; o exemplo antigo chamava client.tools.web_search() e client.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.

Respostas
API Necessária
5
Domínios filtráveis
Automático
Citações incluídas
$5
/ 1.000 chamadas

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