検索スキルを使用して既存のヘルプ・コンテンツを組み込む

仕組みについて

検索スキルでは、Discovery サービスを使用して作成したデータ・コレクションから情報が検索されます。

Discovery は、非構造化データをクロール、変換、および正規化するサービスです。 この製品では、データ分析やコグニティブな直感を適用してデータをエンリッチすることで、後でそのデータから意味のある情報を簡単に検出して取り出すことができるようにします。 Discoveryについて詳しくは、 製品資料を参照してください。

通常、Discovery に追加してアシスタントからアクセスするデータ・コレクションのタイプには、会社が所有する情報が含まれます。 この専有情報には、FAQ、販売資料、技術マニュアル、対象分野の専門家によって書かれた資料が含まれる場合があります。 専有情報のこの高密度のコレクションをマイニングして、顧客の質問に対する回答をすぐに見つけます。

次の図は、ダイアログ・スキルと検索スキルの両方がアシスタントに追加された場合にユーザー入力がどのように処理されるかを示しています。

ステップバイステップのチュートリアルについては、 Watson Discovery の資料の 「Help your chatbot get answers from existing content」 を参照してください。

開始前に

1. 始める前に、Discovery インスタンスをセットアップする必要があります。

   これは、30 日間の無料試用版を提供するプラス・プランを使用することで、無料で行うことができます。 ただし、サービスのプラス・プラン・インスタンスを作成するには、有料アカウント (クレジット・カードの詳細を指定するアカウント) が必要です。

2. プラス・プランの Discovery サービス・インスタンスを作成します。

   IBM Cloud カタログの Discovery ページに移動し、プラス・プラン・サービス・インスタンスを作成します。

プラス・プランを引き続き使用しないことにし、それに対する支払いを行わない場合は、30 日間の試用期間が終了する前にプラス・プラン・サービス・インスタンスを削除してください。

検索スキルの作成

1. スキルを追加するアシスタントから、「検索スキルの追加」をクリックします。

   検索スキルを追加できるのは、有料プランを持つユーザーのみです。

2. 以下のいずれかのアクションを実行してください。

   • 新しい検索スキルを作成するには、「スキルの作成」タブのままにします。

   • 検索スキルを既に作成している場合は、「既存のスキルの追加」タブが表示され、クリックして既存のスキルを追加できます。

3. 新規スキルの詳細を指定します。

   • 名前 (Name): 長さ 64 文字以下の名前です。 名前が必要です。
   • 説明 (Description): 長さ 128 文字以下のオプションの説明です。

   次に、Discovery サービス・インスタンスに接続します。

4. 「続行」 をクリックします。

既存の Watson Discovery インスタンスへの接続

1. 接続先の Discovery インスタンスを選択します。

   一部の Discovery サービス・インスタンスに資格情報が設定されていないという警告が表示された場合は、IBM Cloud ダッシュボードから直接開いたことがない 1 つ以上のインスタンスにアクセスできることを意味しています。 Watson Assistant がユーザーに代わって Discovery サービス・インスタンスへの接続を確立するには、その前に資格情報が存在している必要があります。 Discovery サービス・インスタンスがリストに表示されていない場合は、IBM Cloud® ダッシュボードからそのインスタンスを直接開いて、資格情報が生成されるようにしてください。

2. 以下のいずれかを実行して、使用するコレクションを指定します。

   • 既存のプロジェクトを選択してください。

     使用するプロジェクトを決定する前に、Discovery を開きます。 アイコンをクリックして、プロジェクトの構成を確認できます。

     「検索の構成」に進み、残りのステップを実行します。

   • プロジェクトがない場合、またはリストされているプロジェクトを使用しない場合は、**「新規プロジェクトの作成 (Create a new project)」**をクリックして、プロジェクトを追加します。 「プロジェクトの作成」のステップに従います。

     Discovery サービス・プランに基づく制限に達した場合、「新規プロジェクトの作成」ボタンは表示されません。 プランの制限の詳細については、 Discovery の料金プラン を参照してください。

プロジェクトの作成

1. 「データはどこにありますか?」ページで、データ・ソースを選択し、「次へ」をクリックします。 選択項目の例としては、Salesforce、SharePoint、Box、IBM Cloud Object Storage、Web クロール、およびデータのアップロードがあります。

2. 「データのコレクションを作成しましょう 」ページで、データへの接続方法およびコレクションの構成方法に関する情報を入力します。 入力する必要がある情報は、データ・ソースによって異なります。 例えば、Salesforce、Sharepoint、Box などのサービスの認証資格情報を入力する必要があります。 Web クロールの場合は、既存の情報が存在する Web サイトを指定します。

3. **「完了 (Finish)」**をクリックします。 Discovery が文書の作成を開始するまで数分かかります。 プロジェクト内の「コレクションの管理」ページを使用して、進行状況を確認できます。

   取り込み処理が完了すると、別個の Web ブラウザー・タブでホストされる Discovery に要約ページが表示されます。

4. コレクションが完全に取り込まれるまで待ってから、 「 Watson Assistantに戻る」 をクリックします。

検索の構成

1. Watson Assistant 検索スキル・ページで、使用する Discovery プロジェクトが選択されていることを確認し、 「次へ」 をクリックします。

2. 「結果コンテンツの構成」セクションで、顧客に表示される検索結果で使用される Discovery フィールドと例を確認します。 デフォルトを受け入れることも、必要に応じてカスタマイズすることもできます。

   データの抽出元としてどのコレクション・フィールドが適切かは、コレクションのデータ・ソース、およびデータ・ソースをエンリッチする方法によって異なります。 データ・コレクション・タイプを選択した後、コレクション・フィールドの値には、コレクションのデータ・ソース・タイプに基づいて有用な情報が含まれている可能性が最も高いと考えられるソース・フィールドが事前に取り込まれます。 しかし、あなたはデータについて誰よりもよく知っています。 ソース・フィールドを、ニーズに最も合う情報を含むフィールドに変更することができます。

   抽出する情報が含まれているフィールドの名前など、コレクション内の文書の構造について詳しく知るには、Discoveryでコレクションを開き、「ID フィールド」タブと「管理フィールド」タブを使用します。

   各検索結果は、以下のセクションから構成されます。

   • タイトル: 検索結果のタイトル。 検索結果タイトルとして、コレクション・フィールドの title、name、または同様のタイプを使用します。

     タイトルに何かを選択する必要があります。そうしないと、Facebook および Slack の統合に検索結果の応答が表示されません。

   • 本文: 検索結果の説明。 検索結果の本文として、コレクション・フィールドの abstract、summary、または highlight を使用します。

     本文に何かを選択する必要があります。そうしないと、Facebook および Slack の統合に検索結果の応答が表示されません。

   • URL: このフィールドには、検索結果の末尾に含める任意のフッター・コンテンツを取り込むことができます。

     例えば、ネイティブ・データ・ソースのオリジナル・データ・オブジェクトへのハイパーテキスト・リンクなどを取り込むこともできます。 多くのオンライン・データ・ソースでは、直接アクセスをサポートするために、保管されているオブジェクトの自己参照の公開 URL を指定しています。 URL を追加する場合は、有効でアクセス可能なものでなければなりません。 そうでないと、Slack 統合では応答に URL が含められず、Facebook 統合では応答が返されません。

     URL フィールドが空の場合、Facebook および Slack の統合は検索結果の応答を正常に表示できます。

   少なくとも 1 つの検索結果に対してフィールドを使用する必要があります。

   ドロップダウン・フィールドで使用可能なオプションがない場合、Discovery でコレクションの作成が完了するまでさらに時間が必要です。 時間が経ってもコレクションが作成されない場合は、コレクションに文書が含まれていないか、最初に対処する必要のある取り込みエラーが発生している可能性があります。

   

   フィールド・マッピングを追加すると、検索結果のプレビュー、およびデータ・コレクションの対応するフィールドからの情報が表示されます。 このプレビューには、ユーザーに返される検索結果の応答に含まれるものが表示されます。

   検索の構成に関するヘルプについては、トラブルシューティングを参照してください。

3. 「メッセージ」タブ、「結果が見つかりません」タブ、および「接続の問題」タブを使用して、検索の成功度に基づいてユーザーと共有するさまざまなメッセージをカスタマイズします。

   検索結果メッセージ

   タブ	シナリオ	メッセージの例
   メッセージ	検索結果が返された	I found this information that might be helpful:
   結果が見つかりません	検索結果が見つからない	I searched my knowledge base for information that might address your query, but did not find anything useful to share.
   接続の問題	何らかの理由により検索を実行できない	I might have information that could help address your query, but am unable to search my knowledge base at the moment.

4. 「回答を強調する」を有効にするかどうかを選択します。

   このオプションは、Discovery インスタンスが v2 Discovery API を使用する場合にのみ使用できます。

   この機能を有効にすると、お客様の質問に対する正確な回答として Discovery によって決定された文が、検索結果としてお客様に表示されるテキスト・ブロック内で強調表示されます。

5. 「結果数量の調整」セクションで、返される結果の数を指定します。

   上位 3 つの結果は自動的に返されます。 応答に表示する結果の数を減らすか、または増やす (最大 10 個) ことを選択できます。

   デフォルトでは、顧客は表示する結果を増やす選択ができます。 顧客にこの選択をさせないようにする場合は、**「顧客に最大 10 個の結果を表示させるためのリンクを組み込む (Include link for customers to view up to 10 results)」**チェック・ボックスをクリアします。

6. 「結果選択度の設定」セクションで、返される回答をより選択的にするかどうかを決定します。 結果の選択性を高めることにより、検索で返される結果の数は少なくなりますが、より正確な結果が返されます。 ほとんどの場合、検索の精度は、デフォルト設定 (オフ) で十分です。

7. 「プレビュー」をクリックして、テスト用の「プレビュー」ペインを開きます。 テスト・メッセージを入力して、構成の選択が検索に適用された場合に返される結果を確認します。 必要に応じて調整してください。

8. 「作成」 をクリックします。

後で検索結果カードの構成を変更する場合、検索スキルを再度開いて編集します。 加えた変更は、保存する必要はなく、自動的に適用されます。 検索結果に満足したら、**「保存 (Save)」**をクリックして、検索スキルの構成を終了します。

別の Discovery サービス・インスタンスまたはデータ・コレクションに接続する場合は、新しい検索スキルを作成し、他のインスタンスに接続するように構成します。 検索スキルの作成後に、検索スキルのサービス・インスタンスやデータ収集の詳細を変更することはできません。

トラブルシューティング

一般的なタスクの実行に関するヘルプについては、この情報を確認してください。

• Web クロール・データ・コレクションの作成: Web クロール・データ・ソースを作成する際に知っておくべきこと:

  • データ・コレクションで使用できる文書の数を増やすには、「URL グループの追加 (Add a URL group)」をクリックします。そこで、クロールするものの、最初のシード URL からリンクされていないページの URL をリストできます。
  • データ・コレクションで使用できる文書の数を減らすには、ベース URL のサブドメインを指定します。 あるいは、Web クロール設定で、Watson が元のページから作成できるホップの数を制限します。 サブドメインを指定して、クロールから明示的に除外することもできます。
  • 数分経ち、ページを最新表示しても文書が表示されない場合は、取り込むコンテンツを URL のページ・ソースから利用できるようにしてください。 Web ページ・コンテンツの中には、動的に生成されるためにクロールできないものがあります。

• アップロードした文書の検索結果の構成: アップロードした文書のコレクションを使用していて、正しい検索結果が得られないか、結果があまり簡潔にならない場合、データ・コレクションを作成するときに Smart Document Understanding の使用を検討してください。

  この機能により、テキストの書式設定に基づいて文書に注釈を付けることができます。 例えば、28 ポイントの太字フォントのテキストは文書のタイトルであることを Discovery に教えることができます。 コレクションを取り込むときにこの情報をコレクションに適用すると、後で*「タイトル」*フィールドを検索結果のタイトル・セクションのソースとして使用できます。

  Smart Document Understanding を使用して、大きな文書を、検索しやすいセグメントに分割することもできます。 詳しくは、 Discovery 資料の「 Smart Document Understanding の使用 」トピックを参照してください。

• 検索結果の改善: 表示されている結果が気に入らない場合は、ダイアログ・ノードから検索スキルを呼び出して、フィルターの詳細を指定します。

  ダイアログ・ノードの検索スキル応答から、Discovery の完全な照会構文フィルターを指定することで、結果を絞り込むことができます。

  例えば、データ・コレクション内の文書で、文書タイトルやその他のメタデータ・フィールドに意図が記載されていないものを除外するフィルターを定義することができます。 または、データ・コレクションのメタデータでエンティティーを既知のエンティティーとして識別しない文書、または文書の全文のどこにもエンティティーを記載していない文書をフィルターで除外できます。 検索スキル応答タイプの追加方法について詳しくは、*「検索スキル」*応答タイプの追加を参照してください。

  結果の改善に関するその他のヒントについては、 Watson Discoveryからの自然言語照会結果の改善 のブログ投稿を参照してください。

• 応答テキストは大括弧で囲まれています: 例えば、プレビューからテストするときに、応答テキストが大括弧と引用符 (["My response text"]) で囲まれていることに気付いた場合は、構成で使用しているソース・フィールドを変更する必要があります。 この予期しない形式は、ソース文書で値が配列として保管されていることを示しています。 テキストを抽出するフィールドの値は、配列データ・タイプではなく文字列データ・タイプでなければなりません。 チャット統合は、データが配列として保管されているフィールドから抽出された応答を示す場合に、配列値を文字列に直接変換します。そのため、配列の構文が含まれた応答が生成されます。

  例えば、次のように、唯一の配列要素として単一のテキスト値を含む配列が、ソース文書のフィールドにあるとします。

  "title": ["a single array element"]
  

  この配列値を Watson Assistant は以下の文字列値に変換します。

  "title": "[\"a single array element\"]"
  

  この結果、チャットでは以下の形式の文字列が返されます。つまり、両端の大括弧と引用符も表示されます。

  ["a single array element"]
  

  このような状況が発生した場合は、別のコレクション・フィールドから検索結果を抽出することを検討してください。

  Discovery 文書の highlight フィールドには、値が配列形式で保管されます。

次のステップ

スキルは、作成された後、「スキル (Skills)」ページにタイルとして表示されます。

検索スキルは、アシスタントに追加されてそのアシスタントがデプロイされるまでは、お客様と対話できません。 詳しくは、アシスタントの作成を参照してください。

検索トリガー

検索スキルは、以下の方法でトリガーされます。

• 特定のダイアログ・ノードまたはアクション・ステップから: この方法は、検索をトリガーする前にユーザー照会を絞り込む場合に役立ちます。

  例えば、会話型フローは、お客様が購入したいデバイスのタイプに関する情報を収集する場合があります。 デバイス・モデルが分かっている場合は、検索スキルに送信される照会でモデル・キーワードを送信して、より良い結果を得ることができます。

  以下のいずれかの方法で、会話の特定のポイントでのみ検索をトリガーします。

  • ダイアログ・スキル: ダイアログ・ノードに 検索スキル 応答タイプを追加します。 ノードが処理されると、アシスタントは外部データ・ソースからパッセージを取得し、それを特定の質問に対する応答として返します。 このタイプの検索は、個別のダイアログ・ノードが処理されている場合にのみ発生します。 詳しくは、「検索スキルの応答タイプの追加」を参照してください。

  • アクション・スキル: 検索がトリガーされるステップの「それから」フィールドで、「回答の検索」を選択します。

• ダイアログ・スキルの「その他」ノードから: アシスタントにダイアログ・スキルと検索スキルがある場合、ユーザー入力によって最初にダイアログ・スキルがトリガーされます。 ダイアログは、正しく応答できる高い信頼性を持つユーザー入力に対処します。 ダイアログ・ツリーの anything_else ノードを通常トリガーする照会は、ダイアログ・スキルの代わりに検索スキルに送信されます。

  例えば、I don't know how to help you with that. のような標準メッセージを表示する代わりに、アシスタントは Maybe this information can help: のように表示することができます。 アシスタントは、照会としてユーザー入力を検索スキルに受け渡し、応答として検索結果を返します。

  anything_else検索の無効化にあるステップに従うことで、 ノードから検索がトリガーされないようにすることができます。

• 検索スキルのみが使用される場合: アシスタントにリンクされているのが検索スキルのみであり、会話型スキルが構成されていない場合、アシスタントの統合チャネルのいずれかからユーザー入力を受信すると、検索照会が Discovery サービスに送信されます。

検索スキルのテスト

検索を構成した後、検索スキルの「プレビュー」ペインを使用して、Discovery から返される検索結果を確認するためのテスト照会を送信できます。

ダイアログによって回答される質問、または検索をトリガーされる質問をお客様が行う際のエクスペリエンス全体をテストするには、アシスタントの「プレビュー」ボタンを使用します。

ダイアログの「試行する (Try it out)」ペインから完全なエンドツーエンドのユーザー・エクスペリエンスをテストすることはできません。 検索スキルは個別に構成され、アシスタントに接続されます。 ダイアログ・スキルは検索の詳細を認識できないため、「試行する (Try it out)」ペインに検索結果を表示できません。

検索スキルをテストするために、少なくとも 1 つの統合チャネルを構成します。 チャネルで、検索をトリガーする照会を入力します。 ダイアログから任意のタイプの検索を開始する場合、ダイアログをテストして、検索が期待どおりにトリガーされることを確認します。 検索応答タイプを使用していない場合は、既存のダイアログ・ノードでユーザー入力に対処できない場合にのみ検索がトリガーされることをテストします。 検索がトリガーされた場合は常に、意味のある結果が返されることを確認します。

検索スキルへの要求の追加送信

ダイアログ・スキルの応答頻度を減らし、代わりに検索スキルへの照会送信数を増やす場合は、ダイアログでそのように構成することができます。

このアプローチを機能させるには、アシスタントにダイアログ・スキルと検索スキルの両方を追加する必要があります。

この手順に従って、信頼レベルのしきい値をデフォルト設定の 0.2 から 0.5 に再設定して、ダイアログが応答する頻度を低くします。 信頼レベルのしきい値を 0.5 に変更した場合、ダイアログがユーザーの意図を理解して対処できるというアシスタントの確信が 50% を超えない限り、アシスタントはダイアログからの回答で応答しないようになります。

1. ダイアログ・スキルの*「ダイアログ」*ページで、ダイアログ・ツリーの最後のノードに anything_else 条件があることを確認します。

   このノードが処理されるたびに、検索スキルがトリガーされます。

2. ダイアログにフォルダーを追加します。 重視しない最初のダイアログ・ノードの前にフォルダーを配置します。 以下の条件をフォルダーに追加します。

   intents[0].confidence > 0.5

   この条件は、フォルダー内のすべてのノードに適用されます。 この条件は、アシスタントがユーザーの意図を認識していることを少なくとも 50% 確信している場合にのみフォルダー内のノードを処理するようにアシスタントに指示します。

3. アシスタントに頻繁に処理させたくないダイアログ・ノードをフォルダーに移動します。

ダイアログを変更した後、アシスタントをテストして、希望する頻度で検索スキルがトリガーされるようにします。

別のアプローチは、無視するトピックに関してダイアログに指示することです。 これを行うには、ダイアログ・スキルの「試行する (Try it out)」ペインで、テスト発話としてアシスタントがすぐに検索スキルに送信する発話を追加できます。 次に、「試行する (Try it out)」ペインで**「無関係とマークを付ける (Mark as irrelevant)」**オプションを選択することで、この発話またはこれに似た発話に応答しないようにダイアログに指示できます。 詳しくは、 無視するトピックについてアシスタントに学習させるを参照してください。

検索の無効化

検索スキルのトリガーを無効にすることができます。

統合のセットアップ中に一時的に無効にすることもできます。 または、ダイアログ内で識別できる特定のユーザー照会の検索のみをトリガーし、検索スキルの応答タイプを使用して回答することもできます。

検索スキルがトリガーされないようにするには、以下のステップを実行します。

1. **「アシスタント (Assistants)」ページで、アシスタントのメニューをクリックしてから、「設定」**を選択します。
2. 「検索スキル」ページを開き、スイッチを「無効」に設定します。