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 サイトを検索する必要があるアシスタントは、代わりに カスタム検索 を使用する必要があります。
拡張機能の作成と追加
-
アシスタントの 「統合 (Integrations)」 ページで 「カスタム拡張のビルド (Build custom extension)」 をクリックし、 OpenAPI 仕様ファイルを使用してカスタム拡張をビルドします。 カスタム拡張の作成に関する一般的な説明については、 カスタム拡張の作成 を参照してください。
-
Google カスタム検索拡張機能を作成し、それが 「統合 (Integrations)」 ページに表示されたら、 「追加」 をクリックしてアシスタントに追加します。 Google プログラマブル検索エンジン API キーを使用して認証します。 カスタム拡張を追加する一般的な手順については、 アシスタントへの拡張の追加 を参照してください。
Google カスタム検索スターター・キット・アクション・テンプレートの追加
-
**「アクション」**ページを開きます。
-
アクションがない場合は、 「新規アクションの作成」 を選択します。 既にいくつかのアクションがある場合は、 「新規アクション」 を選択します。
-
「アクションの作成」 で、 「テンプレートを使用したクイック・スタート」 を選択します。
テンプレートを使用したクイック・スタート は、英語のアシスタントでのみ使用可能です。
-
「テンプレートを使用したクイック・スタート」 で、 Google カスタム検索スターター・キットを追加します。
システム・アクションの編集
-
「アシスタントで設定 (Set by assistant)」 をクリックして、 「一致なし (No matches)」 アクションを開きます。
-
2 つのデフォルト・ステップを削除します。
-
ステップを追加します。 「次に、 を 「サブアクションに移動」 に設定し、 Google 検索 アクションを選択します。
-
顧客をライブ・エージェントに接続していない場合は、 「一致なし」 と同じ方法で 「フォールバック」 アクションを編集することをお勧めします。
Google カスタム検索拡張機能の使用
アシスタントに照会を発行します。 その照会に一致するアクションがない場合は、 Google を使用して検索結果を生成します。
検索結果サイズの制限
watsonx Assistant では、検索結果を含むコンテキスト変数に保管される情報のサイズに 100 KB の制限があります。 拡張の結果がこの制限を超えると、警告やエラーが表示されずにアクションが失敗する可能性があります。 通常、長い遅延が発生し、応答がありません。 この障害は、 Google カスタム検索拡張機能ではほとんど発生しませんが、 Google カスタム検索によって返される大量のメタデータを持つサイトを検索している場合に発生する可能性があります。 これが問題であると考えられる場合は、curl、
Insomニア、または Postman などの API テスト・ツールで照会を実行してみてください。 検索結果として取得するデータのバイト数を確認します。 合計が 100 KB またはそれに近い場合は、 num_of_results
を減らして各照会の結果を減らすか、大量のメタデータを含むサイトまたはページを除外することで、この問題を回避できる可能性があります。
詳しくは、 IBM Watson® Discoveryのスターター・キットの 検索結果のサイズの制限 を参照してください。