Google 検索ツール

Google 検索ツールを使用すると、エージェントはウェブの最新情報に基づいて回答を生成し、会話を実世界のデータに効果的にグラウンディングできます。このツールは、世界中の知識、最新の出来事、幅広いトピックを必要とするシナリオに最適です。

構成

ツールを作成するときに、次の設定を構成します。

  • 名前: ツール インスタンスの表示名（例: search_web）。
  • 説明: ツールの目的の簡単な説明。推論エージェントは、この説明を使用して、ツールを呼び出すタイミングを判断します。
  • 除外するドメイン: 検索結果から除外するドメインのリスト（最大 2,000 個）。例: 「www.example.com」、「example.com」
  • 優先ドメイン: 検索結果を制限するドメインのリスト（最大 20 個）。例: 「www.example.com」、「example.com」
  • コンテキストの URL: グラウンディング コンテキストを取得する特定の URL（最大 20 個）。モデルは、これらのページのコンテンツを直接使用します。例: 「example.com/page/path」
  • モダリティ: さまざまなモダリティの検索結果をエージェントが処理して要約する方法をカスタマイズします。
    • テキスト プロンプト: テキスト会話で検索結果を処理する手順。
    • 音声プロンプト: 音声会話で検索結果を処理する手順（回答を簡潔かつ自然な音声に保ち、未加工の URL を読み上げないなど）。

設定の優先順位

ドメインと URL の設定は、次の順序で適用されます。

  1. 除外されたドメイン: 最も優先度が高い。ドメインは、[コンテキストの URL] または [優先ドメイン] にリストされている場合でも除外されます。
  2. コンテキストの URL: ドメインが除外されていない限り、コンテンツが取得されます。
  3. 使用するドメイン: 最も優先度が低い。

ランタイム コンテキスト URL

ツール構成で指定されたコンテキストの URL に加えて、実行時に URL を動的に挿入するようにエージェントに指示できます。

たとえば、エージェントの手順に次のように追加できます。 none If the user query is about x, look into these urls url1, url2, url3 using the 'Product Information Search' tool.

引用と文中の引用

エージェントが Google 検索ツールを使用して回答をグラウンディングすると、実行時のレスポンスには SessionOutput.citations の引用メタデータが含まれ、生成されたステートメントをウェブソースにトレースできます。

引用メタデータには、次の 2 つの主要なコンポーネントが含まれています。

  • 引用されたチャンク（cited_chunks）: グラウンディングに使用されたソースドキュメントのリスト。ソース uri、ページ title、スニペット text、requires_attribution インジケーターが含まれます。
  • インライン引用（inline_citations）: cited_chunk_indices に直接マッピングされるレスポンス テキスト内の正確なバイト範囲オフセット（start_index と end_index）。クライアント アプリケーションでインライン引用を使用すると、エージェントの回答内の特定の主張にアンカー設定されたインタラクティブな上付き文字バッジ、脚注、インライン リンクをレンダリングできます。

帰属表示の要件

ウェブ グラウンディングから返された引用には、元のソースへの帰属が必要になる場合があります。

  • 各 CitedChunk の requires_attribution フィールドを確認します。
  • requires_attribution が true の場合、クライアント アプリケーションはソース アトリビューションを表示し、エンドユーザー向けのソース URI にリンクする必要があります。