> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Web search

> Ferramenta externa de pesquisa na web para ClickHouse Agents

[Recurso beta](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#beta-features)

Web search permite que um agente busque informações na web pública durante uma conversa. Use esse recurso para perguntas cuja resposta precise estar atualizada — lançamentos recentes, documentação hospedada fora do seu serviço ou uma checagem rápida em uma fonte confiável.

## Ative

No Agent Builder, ative **Web Search** na seção **Capabilities**. Depois de ativado, o agente decide quando fazer uma busca com base na pergunta do usuário e nas instruções do agente. A busca é executada, os resultados são coletados, e o conteúdo mais relevante é repassado ao contexto do modelo.

![Painel de Capabilities com a seção Web Search destacada, mostrando a caixa de seleção Web Search](https://mintcdn.com/private-7c7dfe99/i3Gw7HRb0YxPr7dq/images/cloud/agent-builder/web-search/web-search.webp?fit=max\&auto=format\&n=i3Gw7HRb0YxPr7dq\&q=85\&s=7581b53422cf7ef62cbf9e7e47d94e74)

## Como funciona uma rodada de busca

Cada busca acontece em três etapas, gerenciadas para você na Cloud:

1. **Busca** - a consulta do agente é enviada a um provedor de busca, que retorna URLs candidatas.
2. **Coleta** - páginas relevantes são obtidas, e o texto importante é extraído.
3. **Reclassificação** - um reranker atribui pontuações aos resultados para que o modelo veja primeiro os mais úteis.

A resposta do agente cita as URLs que ele realmente usou.

## Quando usar

* Consulte notas de lançamento ou changelogs que não estejam disponíveis no seu serviço.
* Confirme uma informação em uma fonte que o modelo talvez não conheça.
* Traga um post público de blog ou uma documentação para a conversa para análise.

Não use isso para perguntas que possam ser respondidas com base nos seus dados ou no próprio conhecimento do modelo. Cada rodada de busca adiciona latência.
