> ## 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

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <Icon />
                <span>Beta</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                Funcionalidade Beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Saiba mais.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

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.

<div id="enable-it">
  ## Ative
</div>

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.

<Image img="https://mintcdn.com/private-7c7dfe99/A68-kVUDkVcT2W3b/images/cloud/agent-builder/web-search/web-search.webp?fit=max&auto=format&n=A68-kVUDkVcT2W3b&q=85&s=6a5d1c0feb1af58b4dd351554a190998" alt="Painel de Capabilities com a seção Web Search destacada, mostrando a caixa de seleção Web Search" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/web-search/web-search.webp" />

<div id="how-a-search-round-works">
  ## Como funciona uma rodada de busca
</div>

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.

<div id="when-to-use-it">
  ## Quando usar
</div>

* 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.