ナレッジ マイニングについて調べる

このラボを完了するには、管理者アクセス権が与えられている Azure サブスクリプションが必要です。

たとえば、全国的なコーヒー チェーンである Fourth Coffee に勤務しているとします。 カスタマー エクスペリエンスに関する分析情報を簡単に検索できるようにするナレッジ マイニング ソリューションの構築を支援するように求められています。 顧客のレビューから抽出されたデータを使用して、Azure Cognitive Search インデックスを作成することにしました。

このラボでは、次のことを行います。

  • Azure リソースを作成する
  • データ ソースからデータを抽出する
  • AI スキルでデータをエンリッチする
  • Azure portal で Azure のインデクサーを使用する
  • 検索インデックスのクエリを実行する
  • ナレッジ ストアに保存された結果を確認する

必要な Azure リソース

Fourth Coffee 用に作成するソリューションでは、ご利用の Azure サブスクリプションに次のリソースが必要です。

  • Azure Cognitive Search リソース。インデックス作成とクエリ実行を管理します。
  • Azure AI サービス リソースは、AI によって生成された分析情報を使用してデータ ソースのデータを強化するために、検索ソリューションで使用できるスキルを AI サービスに提供します。

    : Azure Cognitive Search と Azure AI サービス のリソースは同じ場所にある必要があります。

  • BLOB コンテナーを含むストレージ アカウント。未加工のドキュメントや、テーブル、オブジェクト、またはファイルのその他のコレクションが格納されます。

Azure Cognitive Search リソースを作成する

  1. Azure Portal にサインインします。

  2. [+ リソースの作成] ボタンをクリックして、「Azure Cognitive Search」を検索し、次の設定を使用して Azure Cognitive Search リソースを作成します。

    • [サブスクリプション]: お使いの Azure サブスクリプション
    • [リソース グループ]: 一意の名前のリソース グループを選択するか、作成します
    • サービス名: ‘‘一意の名前’‘**
    • 場所: “使用できる任意のリージョンを選択します”**
    • 価格レベル: Basic
  3. [レビューと作成] を選択し、”検証が完了しました” という応答が表示されたら、[作成] を選択します。

  4. デプロイが完了したら、[リソースに移動] を選択します。 Azure Cognitive Search の概要ページでは、インデックスの追加、データのインポート、作成されたインデックスの検索を行うことができます。

“Azure AI サービス” リソースを作成する

Azure Cognitive Search リソースと同じ場所にある Azure AI サービス リソースをプロビジョニングする必要があります。 検索ソリューションではこのリソースを使用して、AI によって生成された分析情報でデータストア内のデータをエンリッチします。

  1. Azure portal のホーム ページに戻ります。 [+リソースの作成] ボタンをクリックし、「Azure AI サービス」を検索してください。** [Azure AI サービスの作成] プランを選択してください。 Azure AI サービス リソースを作成するためのページに移動します。 これを以下の設定で構成します。
    • [サブスクリプション]: お使いの Azure サブスクリプション
    • リソース グループ: ‘‘Azure Cognitive Search リソースと同じリソース グループ’‘**。
    • リージョン: ‘‘Azure Cognitive Search リソースと同じ場所’‘。
    • 名前: ‘‘一意の名前’‘**。
    • 価格レベル: Standard S0
    • このボックスをオンにすることにより、以下のすべてのご契約条件を読み、同意したものとみなされます: 選択済み
  2. Review + create を選択します。 “検証に成功しました” という 応答が表示されたら、[作成] を選択します。

  3. デプロイが完了するまで待ち、デプロイの詳細を表示します。

ストレージ アカウントの作成

  1. Azure portal のホーム ページに戻り、[+ リソースの作成] ボタンを選択します。

  2. ストレージ アカウント」を検索し、次の設定を使用してストレージ アカウント リソースを作成します。
    • [サブスクリプション]: お使いの Azure サブスクリプション
    • リソース グループ: Azure Cognitive Search および Azure AI サービスのリソースと同じリソース グループ
    • ストレージ アカウント名: ‘‘一意の名前’‘。
    • 場所: “利用可能な場所を選択します“。
    • パフォーマンス: 標準
    • 冗長: ローカル冗長ストレージ (LRS)
  3. [確認] をクリックし、次に [作成] をクリックします。 デプロイが完了するまで待ち、デプロイされたリソースに移動します。

  4. 作成した Azure ストレージ アカウントの左側のメニュー ペインで、[構成] ([設定] の下にある) を選択します。
  5. [BLOB 匿名アクセスを許可する] の設定を [有効] に変更し、[保存] を選択します。

Azure Storage にドキュメントをアップロードする

  1. 左側のメニュー ウィンドウで、[コンテナー] を選択します。

    ストレージ BLOB の概要ページを示すスクリーンショット。

  2. [+ コンテナー] を選択します。 右側のペインが開きます。

  3. 以下の設定を入力して、 [作成] をクリックします。
    • 名前: coffee-reviews
    • パブリック アクセス レベル: コンテナー (コンテナーと BLOB の匿名読み取りアクセス)
    • 詳細: ‘‘変更なし’‘**
  4. 新しいブラウザー タブで、 https://aka.ms/km-documents から zip 形式のドキュメントをダウンロードし、ファイルを reviews フォルダーに抽出します。

  5. Azure portal で、coffee-reviews コンテナーを選択します。 コンテナーで、 [アップロード] を選択します。

    ストレージ コンテナーを示すスクリーンショット。

  6. [BLOB のアップロード] ペインで、 [ファイルの選択] を選びます。

  7. [エクスプローラー] ウィンドウで、reviews フォルダー内のすべてのファイルを選択し、[開く] を選択してから、[アップロード] を選択します。

    Azure コンテナーにアップロードされたファイルを示すスクリーンショット。

  8. アップロードが完了したら、[BLOB のアップロード] ペインを閉じることができます。 これで、ドキュメントは coffee-reviews ストレージ コンテナーに存在することになります。

ドキュメントのインデックスを作成する

ストレージにドキュメントを格納したら、Azure Cognitive Search を使用して、そのドキュメントから分析情報を抽出することができます。 Azure portal でデータのインポート ウィザードが提供されます。 このウィザードを使用すると、サポートされているデータ ソースのインデックスとインデクサーを自動的に作成できます。 そのウィザードを使ってインデックスを作成し、検索ドキュメントをストレージから Azure Cognitive Search インデックスにインポートします。

  1. Azure portal で、Azure Cognitive Search リソースを参照します。 [概要] ページで、[データのインポート] を選択します。

    データのインポート ウィザードを示すスクリーンショット。

  2. [データへの接続] ページの [データ ソース] リストで、[Azure Blob Storage] を選択します。 次の値でデータ ストアの詳細を入力します。
    • データ ソース: Azure BLOB ストレージ
    • データ ソース名: coffee-customer-data
    • 抽出するデータ: コンテンツとメタデータ
    • 解析モード: 既定
    • 接続文字列: *[既存の接続を選択します] を選びます。 ストレージ アカウントを選択し、coffee-reviews コンテナーを選択してから、[選択] をクリックします。
    • マネージド ID 認証: なし
    • コンテナー名: ‘‘この設定は、既存の接続を選択した後に自動的に設定されます’‘。
    • BLOB フォルダー: ‘‘これは空白のままにします’‘**。
    • 説明: Fourth Coffee ショップのレビュー。
  3. [次へ: コグニティブ スキルの追加 (省略可能)] を選択します。

  4. [Cognitive Services をアタッチする] セクションで、利用する Azure AI サービス リソースを選択します。

  5. [エンリッチメントの追加] セクションで、次のことを行います。
    • [スキルセット名]coffee-skillset に変更します。
    • [OCR を有効にし、すべてのテキストを merged_content フィールドにマージする] チェックボックスをオンにします。

      すべてのエンリッチされたフィールド オプションを表示するには、 [OCR を有効にする] を選択することが重要です。

    • ソース データ フィールドmerged_content に設定されていることを確かめます。
    • [エンリッチメントの粒度レベル][ページ (5000 文字チャンク)] に変更します。
    • [増分エンリッチメントを有効にする] は選択しないでください
    • 次のエンリッチされたフィールドを選択します。

      コグニティブ スキル パラメーター フィールド名
      場所の名前を抽出   locations
      キー フレーズを抽出   keyphrases
      センチメントの検出   センチメント
      画像からタグを生成する   imageTags
      画像からキャプションを生成する   imageCaption
  6. [ナレッジ ストアにエンリッチメントを保存する] で、次を選択します。
    • 画像プロジェクション
    • Documents
    • ページ
    • キー フレーズ
    • エンティティ
    • 画像詳細
    • 画像参照

    ストレージ アカウントの接続文字列を求める警告が表示されます。

    [既存の接続を選択します] が選択された [ストレージ アカウント接続] 画面の警告を示すスクリーンショット。

    1. [既存の接続を選択します] を選択します。 先ほど作成したストレージ アカウントを選びます。
    2. [+ コンテナー] をクリックし、プライバシー レベルが [プライベート] に設定された knowledge-store という新しいコンテナーを作成し、[作成] を選択します。
    3. knowledge-store コンテナーを選択し、画面の下部にある [選択] をクリックします。
  7. [Azure BLOB のプロジェクション: ドキュメント] を選択します。 knowledge-store コンテナーが自動的に設定された [コンテナー名] の設定が表示されます。 コンテナー名は変更しないでください。

  8. [次へ: 対象インデックスをカスタマイズします] を選択します。 [インデックス名]coffee-index に変更します。

  9. [キー]metadata_storage_path に設定されていることを確かめます。 [Suggester 名] は空白のままにし、[検索モード] は自動設定されたままにします。

  10. インデックス フィールドの既定の設定を確認します。 既定で既に選択されているすべてのフィールドに対して [フィルター可能] を選択します。

    インデックス名が入力され、既定のインデックス フィールドに対して [フィルター可能] が選択されている、インデックスのカスタマイズ ペインを示すスクリーンショット。

  11. [次へ: インデクサーの作成] を選択します。

  12. [インデクサー名]coffee-indexer に変更します。

  13. [スケジュール][1 回] に設定されているままにします。

  14. [詳細設定] オプションを展開します。 エンコード キーを使用するとインデックスの効率が向上するため、[Base-64 エンコード キー] オプションが選択されていることを確認します。

  15. [送信] を選択して、データ ソース、スキルセット、インデックス、およびインデクサーを作成します。 インデクサーは自動的に実行され、インデックス作成パイプラインが実行されます。これにより、次のことが行われます。
    • データ ソースからドキュメント メタデータ フィールドとコンテンツを抽出します。
    • コグニティブ スキルのスキルセットを実行して、追加のエンリッチされたフィールドを生成します。
    • 抽出されたフィールドをインデックスにマップする。
  16. Azure Cognitive Search リソースの [概要] ページの下半分で、 [インデクサー] タブを選択します。このタブに、新しく作成された coffee-indexer が表示されます。 しばらく待ち、 [状態] に成功が示されるまで [↻ 最新の情報に更新] を選択します。

  17. インデクサー名を選択すると、詳細が表示されます。

    coffee-indexer インデクサーが正常に作成されたことを示すスクリーンショット。

インデックスのクエリを実行する

Search エクスプローラーを使ってクエリを記述し、テストします。 Search エクスプローラーは Azure portal に組み込まれているツールであり、検索インデックスの品質を簡単に確認することができます。 Search エクスプローラーを使用してクエリを記述し、結果を JSON で確認できます。

  1. Search サービスの [概要] ページで、画面の上部にある [Search エクスプローラー] を選択します。

    検索エクスプローラーを見つける方法のスクリーンショット。

  2. 選択されたインデックスがどのように、作成した coffee-index になるかに注目してください。

    Search エクスプローラーのスクリーンショット。

    [クエリ文字列] フィールドに「search=*&$count=true」と入力し、[検索] を選択します。 検索クエリでは、@odata.count フィールド内のすべてのドキュメントの数を含む、検索インデックス内のすべてのドキュメントが返されます。 Search インデックスでは、検索結果を含む JSON ドキュメントが返されるはずです。

    [ポータルで検索するには、インデックス CORS 設定でポータルの配信元を許可してください] というメッセージが表示されたら、 [ポータルの許可] を選択し、 [検索] を選択します。

  3. 次は場所でフィルター処理してみましょう。 [クエリ文字列] フィールドに「search=locations:'Chicago'」と入力し、[検索] を選択します。 クエリではインデックス内のすべてのドキュメントが検索され、シカゴの場所を含むレビューがフィルター処理されます。

  4. 次はセンチメントでフィルター処理してみましょう。 [クエリ文字列] フィールドに「search=sentiment:'negative'」と入力し、[検索] を選択します。 クエリではインデックス内のすべてのドキュメントが検索され、否定的なセンチメントのレビューがフィルター処理されます。

    結果が @search.score によってどのように並べ替えられているかをご確認ください。 これは、結果が特定のクエリとどの程度一致しているかを示すために、検索エンジンによって割り当てられたスコアです。

  5. 解決したい問題の 1 つは、特定のレビューがある可能性がある理由です。 否定的なレビューに関連付けられているキー フレーズを見てみましょう。 レビューの原因は何だと思いますか?

ナレッジ ストアを確認する

ナレッジ ストアの機能の動作を見てみましょう。 ‘‘データのインポート ウィザード’’ を実行したときに、ナレッジ ストアも作成しました。 ナレッジ ストア内には、AI スキルによって抽出されたエンリッチされたデータが、プロジェクションとテーブルの形式で保持されているのがわかります。

  1. Azure portal で、Azure ストレージ アカウントに戻ります。

  2. 左側のメニュー ウィンドウで、[コンテナー] を選択します。 knowledge-store コンテナーを選択します。

    knowledge-store コンテナーのスクリーンショット。

  3. 任意の項目を選んでから、objectprojection.json ファイルをクリックします。

    objectprojection.json のスクリーンショット。

  4. [編集] を選択して、Azure データ ストアのドキュメントの 1 つに対して生成された JSON を表示します。

    編集ボタンを見つける方法のスクリーンショット。

  5. 画面の左上にあるストレージ BLOB 階層リンクを選択して、ストレージ アカウントの [コンテナー] に戻ります。**

    ストレージ BLOB 階層リンクのスクリーンショット。

  6. [コンテナー] で coffee-skillset-image-projection を選択します。** 任意の項目を選択します。

    スキルセット コンテナーのスクリーンショット。

  7. 任意の .jpg ファイルを選択します。 [編集] を選択して、ドキュメントに格納されている画像を表示します。 ドキュメントのすべての画像が、この方法でどのように格納されているかに注目してください。

    保存された画像のスクリーンショット。

  8. 画面の左上にあるストレージ BLOB 階層リンクを選択して、ストレージ アカウントの [コンテナー] に戻ります。**

  9. 左側のパネルで [ストレージ ブラウザー] を選択し、 [テーブル] を選択します。 インデックス内の各エンティティにテーブルがあります。 テーブル coffeeSkillsetKeyPhrases を選択します。

    ナレッジ ストアでレビューのコンテンツから取り込めたキー フレーズを確認します。 フィールドの多くはキーなので、リレーショナル データベースのようなテーブルをリンクできます。 最後のフィールドには、スキルセットによって抽出されたキー フレーズが表示されます。

詳細情報

この単純な検索では、Azure Cognitive Search サービスの機能の一部のみにインデックスが作成されます。 このサービスでできることについて詳しくは、Azure Cognitive Search サービスに関するページを参照してください。