> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/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}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

export const galaxyOnClick = eventName => () => {
  try {
    if (typeof window !== "undefined" && window.galaxy && eventName) {
      window.galaxy.track(eventName, {
        interaction: "click"
      });
    }
  } catch (e) {}
};

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/beta-and-experimental-features#beta-features">
                        Saiba mais.
                    </a>
                </u>
            </span>
        </div>;
};

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-mintlify-8c05c8a2/_TDydWLKO6Z3njo9/images/cloud/agent-builder/web-search/web-search.png?fit=max&auto=format&n=_TDydWLKO6Z3njo9&q=85&s=8b4e8e515dc925843fc48b8402df4bcf" alt="Painel de Capabilities com a seção Web Search destacada, mostrando a caixa de seleção de Web Search" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/web-search/web-search.png" />

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