Pesquisa na Web com modelos do Anthropic Claude

A pesquisa na Web é um recurso que permite que um modelo do Claude amplie o conhecimento com dados em tempo real da Web. Os modelos do Claude usam um provedor de pesquisa de terceiros para o recurso de pesquisa na Web. O recurso de pesquisa na Web é particularmente poderoso para aplicativos de RAG (geração aumentada por recuperação) em que é necessário citar fontes com precisão.

A pesquisa na Web é adequada para os seguintes casos de uso:

  • Recuperar a documentação técnica mais recente: os desenvolvedores de software podem perguntar ao Claude sobre a documentação da API ou as especificações técnicas mais recentes, e o Claude pode recuperar e sintetizar informações diretamente da documentação de origem.
  • Coletar informações de negócios e mercado: os analistas de negócios podem coletar dados de mercado atuais, informações da empresa ou notícias do setor para apoiar os processos de tomada de decisão.
  • Auxiliar na pesquisa: os profissionais intelectuais podem usar o Claude como um assistente de pesquisa que pode encontrar, sintetizar e explicar informações de várias fontes da Web, mantendo citações precisas.
  • Suporte ao cliente: os aplicativos de atendimento ao cliente podem acessar informações atualizadas sobre produtos, preços ou documentação de suporte nos sites da empresa.

Modelos compatíveis

A Gemini Enterprise Agent Platform oferece suporte à pesquisa na Web para os seguintes modelos do Anthropic Claude:

Controlar o acesso à pesquisa na Web

O recurso de pesquisa na web exige acesso público à internet. Por padrão, a pesquisa na Web é desativada pela restrição da política da organização constraints/vertexai.allowedPartnerModelFeatures. Para ativar a pesquisa na Web, você precisa configurar essa restrição para permitir explicitamente.

Além disso, é possível configurar a restrição da política da organização constraints/vertexai.allowedModels para restringir o acesso aos modelos do Claude.

Para garantir o acesso contínuo à pesquisa na Web para essas versões específicas de modelos após junho de 2026, configure a política da organização constraints/vertexai.allowedPartnerModelFeatures para permitir a pesquisa na Web até o final de junho de 2026.

Para instruções detalhadas sobre como configurar restrições de políticas da organização, consulte Controlar o acesso aos modelos do Model Garden.

Ative a pesquisa na Web fornecendo uma nova definição de ferramenta Anthropic (web_search) na solicitação de API.

Por exemplo, o snippet de código a seguir usa a pesquisa na Web para recuperar informações meteorológicas em tempo real:

response = await client.messages.create(
    model="claude-4-sonnet-latest",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": "What is the weather in San Francisco?"
    }],
    tools=[{
        "type": "web_search",
        "name": "web_search",
        "max_uses": 5
    }]
)

Também é possível usar campos opcionais para especificar domínios permitidos e bloqueados. Exemplo:

tools=[{
  ...
  # Only one of allowed_domains and blocked_domains can be provided.
  # allowed_domains excludes everything except the specified domains
    "allowed_domains": ["example.com", "example.org"],

  # blocked_domains includes everything except the specified domains
  # Use the `NOT site:` search operator
    "blocked_domains": ["example.net"],
}]

Para mais informações sobre campos opcionais, consulte a documentação da ferramenta de pesquisa na Web do Claude.

Quando o modelo determina que a pesquisa na Web é necessária, a API invoca a ferramenta de pesquisa na Web até que não sejam mais necessárias chamadas de ferramenta. A resposta inclui detalhes sobre as pesquisas intermediárias, com os resultados criptografados.

O snippet de código a seguir é um exemplo de resposta com pesquisa na Web:

{
  ...
  "role": "assistant",
  "content": [
    // Initial output from the model
    {
      "type": "text",
      "text": "I need to search the web to answer this question about the weather in San Francisco."
    },
    {
      "type": "server_tool_use",
      "id": "srvtoolu_9a90a390a",
      "name": "web_search",
      "input": {
        "query": "What is the weather in San Francisco?",
      }
    },
    // API sees an `</antml:function_calls>` stop sequence here, sees that
    // the tool use is for a server-side tool, and then runs that
    // tool. If there is a mix of client and server-side, the API would
    // need to return to the client and let it pass back client tool results
    // before continuing with server tools.
    {
      "type": "web_search_tool_result",
      // "name": "web_search", use this to determine what types of blocks are inside `content`
      "tool_use_id": "srvtoolu_9a90a390a",
      "content": [
        {
          "type": "web_search_result",
          "uri": "https://weather.com",
          "title": "National and Local Weather",
          "encrypted_content": "eyJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
        {
          "type": "web_search_result",
          "uri": "https://accuweather.com",
          "title": "San Francisco, CA Hourly Weather",
          "encrypted_content": "yaJlbmNyeXB0ZWRfa2V5Ijoic2VjcmV0LW...", // encrypted list of snippets from the web search provider
        },
      ],
    },
    // Server starts a new sampling run with the above content appended (unencrypted)
    // to the original request. Everything below is completion content from the
    // second sampling run.
    {
      "type": "text",
      "text": "The current weather in San Francisco, CA is 65 degrees Fahrenheit and partly cloudy."
    }
  ],
  // Server output is no longer 1-to-1 with a single sampling run. From the
  // user's perspective, there is just one "Message" with a single id
  "id": "msg_a930390d3",
  "usage": {
    "input_tokens": 3029,
    "output_tokens": 6039,
    "server_tool_use": {
      "web_search_requests": 2
    }
  },
  "stop_reason": "end_turn"
}

Streaming com pesquisa na Web

Com o streaming ativado, o modelo retorna eventos de pesquisa como parte do stream. Exemplo:

// Claude's decision to search

event: content_block_start
data: {"type": "content_block_start", "index": 1, "content_block": {"type": "server_tool_use", "id": "srvtoolu_xyz789", "name": "web_search"}}

// Search query streamed
event: content_block_delta
data: {"type": "content_block_delta", "index": 1, "delta": {"type": "input_json_delta", "partial_json": "{\"query\":\"latest quantum computing breakthroughs 2025\"}"}}

// Pause while search executes

// Search results streamed
event: content_block_start
data: {"type": "content_block_start", "index": 2, "content_block": {"type": "web_search_tool_result", "tool_use_id": "srvtoolu_xyz789", "content": [{"type": "web_search_result", "title": "Quantum Computing Breakthroughs in 2025", "url": "https://example.com"}]}}

O uso é medido e incluído nas mensagens do message_delta, que incluem uma contagem cumulativa de itens do web_search. Exemplo:

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"input_tokens":10682,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":510,"server_tool_use":{"web_search_requests":1}}}

O recurso de pesquisa na Web para o Claude 4.0 e modelos mais recentes é um recurso opcional dos modelos Claude da Anthropic. Para ativar, forneça a ferramenta de pesquisa na Web nas solicitações. Ao ativar esse recurso, você instrui a Gemini Enterprise Agent Platform a permitir que os modelos do Claude enviem consultas de pesquisa derivadas da sua solicitação a um provedor de serviços de pesquisa de terceiros selecionado pela Anthropic. O Google não é responsável pelas práticas de tratamento de dados desse provedor terceirizado. Depois que as consultas de pesquisa são transmitidas, o tratamento desses dados é regido pelos Termos de Serviço e pela Política de Privacidade do terceiro, não do Google.

A ativação do recurso de pesquisa na Web tem implicações diretas na governança de dados e na postura de segurança. Os compromissos adicionais da Gemini Enterprise Agent Platform, como as chaves de criptografia gerenciadas pelo cliente (CMEK) e a residência de dados, não se aplicam aos dados enquanto eles estão sendo processados pelo provedor de pesquisa de terceiros. Se o projeto do consumidor estiver em um perímetro do VPC-SC, a Vertex AI vai rejeitar as solicitações com a seguinte mensagem de erro:

{
  "error": {
    "code": 400,
    "message": "The requested model does not serve requests restricted by VPCSC",
    "status": "FAILED_PRECONDITION"
  }
}

Esse recurso está disponível exclusivamente para o Claude 4.0 e modelos posteriores. Ele não está disponível para modelos mais antigos do Claude na Gemini Enterprise Agent Platform. A lista de serviços da Pesquisa de terceiros que o recurso de pesquisa na Web da Anthropic pode chamar se o recurso de pesquisa na Web for usado:

Preços

A pesquisa na Web é cobrada como um complemento ao uso da API de mensagens padrão, com base no volume de solicitações da Web. Devido às chamadas de amostragem adicionais, os usuários também serão cobrados pelos tokens de entrada extras.

Para saber mais informações, consulte Preços.