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

> Herramienta externa de búsqueda 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>
                Funcionalidad beta. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        Más información.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

Web search permite que un agente obtenga información de la web pública durante una conversación. Úsalo para preguntas cuya respuesta deba estar al día: versiones recientes, documentación alojada fuera de tu servicio o una comprobación rápida en una fuente autorizada.

<div id="enable-it">
  ## Habilítalo
</div>

En Agent Builder, habilita **Web Search** en la sección **Capabilities**. Una vez habilitado, el agente decide cuándo realizar una búsqueda en función de la pregunta del usuario y de las instrucciones del agente. La búsqueda se ejecuta, se recopilan los resultados y el contenido más relevante se incorpora de nuevo al contexto del 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="Panel de Capabilities con la sección Web Search resaltada, que muestra la casilla de verificación de 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">
  ## Cómo funciona una ronda de búsqueda
</div>

Cada búsqueda se ejecuta en tres etapas, gestionadas por Cloud por ti:

1. **Búsqueda** - la consulta del agente se envía a un proveedor de búsqueda que devuelve URL candidatas.
2. **Extracción** - se recuperan las páginas relevantes y se extrae el texto útil.
3. **Reordenación** - un reranker puntúa los resultados para que el modelo vea primero los más útiles.

La respuesta del agente cita las URL que realmente utilizó.

<div id="when-to-use-it">
  ## Cuándo usarlo
</div>

* Consulta notas de la versión o registros de cambios que no estén en tu servicio.
* Verifica un dato con una fuente que el modelo quizá no conozca.
* Incorpora a la conversación una entrada de blog o documentación pública para analizarla.

Omítelo en preguntas que puedan responderse con tus datos o con el propio conocimiento del modelo. Cada ronda de búsqueda añade latencia.