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

# 웹 검색

> 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>베타</span>
            </a>;
  }
  return <div className="betaBadge">
            <Icon />
            <span>
                베타 기능. 
                <u>
                    <a href="/docs/docs/beta-and-experimental-features#beta-features">
                        자세히 보기.
                    </a>
                </u>
            </span>
        </div>;
};

<BetaBadge />

웹 검색을 사용하면 에이전트가 대화 중 공개 웹에서 정보를 가져올 수 있습니다. 최근 릴리스, 서비스 외부에 있는 문서, 또는 신뢰할 수 있는 출처를 빠르게 확인해야 하는 등 답변에 최신 정보가 필요한 질문에 사용하세요.

<div id="enable-it">
  ## 활성화하기
</div>

Agent Builder의 **Capabilities** 섹션에서 **웹 검색**을 활성화하세요. 활성화되면 사용자 질문과 에이전트 지침에 따라 에이전트가 검색을 실행할 시점을 결정합니다. 검색이 실행되고 결과가 스크레이프되면, 가장 관련성 높은 콘텐츠가 모델 컨텍스트로 다시 전달됩니다.

<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="웹 검색 체크박스가 표시된 웹 검색 섹션이 강조된 Capabilities 패널" size="sm" width="616" height="1412" data-path="images/cloud/agent-builder/web-search/web-search.webp" />

<div id="how-a-search-round-works">
  ## 검색 라운드 작동 방식
</div>

각 검색은 Cloud에서 관리되는 3단계로 진행됩니다.

1. **검색** - 에이전트의 쿼리가 검색 제공업체로 전달되며, 검색 제공업체는 후보 URL을 반환합니다.
2. **스크레이프** - 관련 페이지를 가져와 의미 있는 텍스트를 추출합니다.
3. **재정렬** - 재정렬기가 결과에 점수를 매겨 model이 가장 유용한 결과를 먼저 볼 수 있도록 합니다.

에이전트의 응답에는 실제로 사용한 URL이 인용되어 표시됩니다.

<div id="when-to-use-it">
  ## 사용해야 하는 경우
</div>

* 서비스에 없는 릴리스 노트나 변경 기록을 찾아볼 때
* 모델이 알지 못할 수 있는 사실을 출처와 대조해 확인할 때
* 공개 블로그 게시물이나 문서를 대화에 불러와 분석할 때

사용자의 데이터나 모델 자체 지식만으로 답할 수 있는 질문에는 사용하지 마십시오. 각 검색 라운드는 지연 시간을 늘립니다.