IBM Cloud Docs
Google カスタム検索拡張機能のセットアップ

Google カスタム検索拡張機能のセットアップ

Google Programmable Search Engine を使用するアシスタントの拡張機能を介して、 Google 検索にアクセスできます。 これは、ユース・ケースに基づいてカスタマイズできる構成可能な検索です。

Google 検索の拡張機能をセットアップするには、以下のようにします。

検索エンジン ID および API キーの取得

Google Programmable Search Engine を作成します。 次に、その検索エンジン ID と API キーを取得します。 詳しい手順については、 Google Programmable Search Engine 資料の「 Create Programmable Search Engine 」を参照してください。

OpenAPI 仕様のダウンロード

OpenAPI 仕様ファイル google-custom-search-openapi.jsonをダウンロードします。 このファイルを使用して、拡張子をアシスタントに追加します。

OpenAPI 仕様は、以下のメソッドを定義します。

  • GET /customsearch/v1: Web 全体でコンテンツを検索します。
  • GET /customsearch/v1/siterestrict: 特定の Web サイト・コレクションでコンテンツを検索します。

エンドポイントについて詳しくは、「 カスタム検索 」または「 カスタム検索サイトの制限」を参照してください。

エンドポイントの引数と応答は同じですが、以下の点が異なります。

  • 「カスタム検索サイトの制限 (Custom Search Site Restricted)」 は、検索する Web サイトの数が 10 個以下に制限されています。各 Web サイトのページ数に制限はありません。
  • カスタム検索 は、 Googleによって索引付けされた任意の数の Web サイトをサポートできますが、 日次照会の制限 があります。

特定のトピックに焦点を当てた標準的なアシスタントの場合、通常は 1 つの Web サイトまたはいくつかの Web サイトを検索するだけで済みます。 「カスタム検索サイトの制限 (Custom Search Site Restricted)」 は、1 日に実行できる照会の数に制限がないため、より適しています。 10 を超える Web サイトを検索する必要があるアシスタントは、代わりに カスタム検索 を使用する必要があります。

拡張機能の作成と追加

  1. アシスタントの 「統合 (Integrations)」 ページで 「カスタム拡張のビルド (Build custom extension)」 をクリックし、 OpenAPI 仕様ファイルを使用してカスタム拡張をビルドします。 カスタム拡張の作成に関する一般的な説明については、 カスタム拡張の作成 を参照してください。

  2. Google カスタム検索拡張機能を作成し、それが 「統合 (Integrations)」 ページに表示されたら、 「追加」 をクリックしてアシスタントに追加します。 Google プログラマブル検索エンジン API キーを使用して認証します。 カスタム拡張を追加する一般的な手順については、 アシスタントへの拡張の追加 を参照してください。

Google カスタム検索スターター・キット・アクション・テンプレートの追加

  1. **「アクション」**ページを開きます。

  2. アクションがない場合は、 「新規アクションの作成」 を選択します。 既にいくつかのアクションがある場合は、 「新規アクション」 を選択します。

  3. 「アクションの作成」 で、 「テンプレートを使用したクイック・スタート」 を選択します。

    テンプレートを使用したクイック・スタート は、英語のアシスタントでのみ使用可能です。

  4. 「テンプレートを使用したクイック・スタート」 で、 Google カスタム検索スターター・キットを追加します。

システム・アクションの編集

  1. 「アシスタントで設定 (Set by assistant)」 をクリックして、 「一致なし (No matches)」 アクションを開きます。

  2. 2 つのデフォルト・ステップを削除します。

  3. ステップを追加します。 「次に、「サブアクションに移動」 に設定し、 Google 検索 アクションを選択します。

  4. 顧客をライブ・エージェントに接続していない場合は、 「一致なし」 と同じ方法で 「フォールバック」 アクションを編集することをお勧めします。

Google カスタム検索拡張機能の使用

アシスタントに照会を発行します。 その照会に一致するアクションがない場合は、 Google を使用して検索結果を生成します。

検索結果サイズの制限

watsonx Assistant では、検索結果を含むコンテキスト変数に保管される情報のサイズに 100 KB の制限があります。 拡張の結果がこの制限を超えると、警告やエラーが表示されずにアクションが失敗する可能性があります。 通常、長い遅延が発生し、応答がありません。 この障害は、 Google カスタム検索拡張機能ではほとんど発生しませんが、 Google カスタム検索によって返される大量のメタデータを持つサイトを検索している場合に発生する可能性があります。 これが問題であると考えられる場合は、curl、 Insomニア、または Postman などの API テスト・ツールで照会を実行してみてください。 検索結果として取得するデータのバイト数を確認します。 合計が 100 KB またはそれに近い場合は、 num_of_results を減らして各照会の結果を減らすか、大量のメタデータを含むサイトまたはページを除外することで、この問題を回避できる可能性があります。

詳しくは、 IBM Watson® Discoveryのスターター・キットの 検索結果のサイズの制限 を参照してください。