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

エージェントビルダーの **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>

各検索は 3 つの段階で実行され、これらは Cloud 側で管理されます。

1. **検索** - エージェントのクエリが検索プロバイダーに送信され、候補となる URL が返されます。
2. **スクレイプ** - 関連するページを取得し、有用なテキストを抽出します。
3. **再ランキング** - リランカーが結果をスコアリングし、モデルが最も有用なものから先に参照できるようにします。

エージェントの応答には、実際に使用した URL が引用元として含まれます。

<div id="when-to-use-it">
  ## 使用する場面
</div>

* 利用中のサービスに含まれていないリリースノートや変更履歴を調べる。
* モデルが把握していない可能性のある事実を、情報源に照らして確認する。
* 公開されているブログ記事やドキュメントを会話に取り込み、分析する。

自分のデータやモデル自身の知識で答えられる質問には使わないでください。検索ラウンドを重ねるたびにレイテンシが増えます。