ご自分のサポート情報にセキュリティで保護されたクラウドベースの SharePoint データ ソースを追加して、Active Directory によりセキュリティで保護されている可能性がある質問と回答でサポート情報を補強できます。
ご自分のサポート情報にセキュリティで保護された SharePoint ドキュメントを追加する場合、QnA Maker マネージャーとして、QnA Maker 用の Active Directory に対するアクセス許可を要求する必要があります。 この、SharePoint にアクセスするアクセス許可が Active Directory マネージャーから QnA Maker に付与されると、再度それを取得する必要はありません。 ナレッジ ベースに追加された後続の各ドキュメントは、同じ SharePoint リソース内にある場合、承認を必要としません。
QnA Maker ナレッジ ベース マネージャーが Active Directory マネージャーでない場合は、Active Directory マネージャーと通信してこのプロセスを完了する必要があります。
前提条件
- クラウドベースの SharePoint - QnA Maker では、アクセス許可に Microsoft Graph を使用します。 SharePoint がオンプレミスの場合、Microsoft Graph ではアクセス許可を決定できないため、SharePoint から抽出することはできません。
- URL 形式 - QnA Maker では、共有用に生成され、形式の SharePoint URL のみがサポートされます
https://\*.sharepoint.com
サポート情報へのサポート対象ファイルの種類の追加
SharePoint サイトからご自分のサポート情報に、QnA Maker でサポートされているすべてのファイルの種類を追加できます。 ファイルのリソースがセキュリティで保護されている場合、アクセス許可を付与する必要がある場合があります。
SharePoint サイトのあるライブラリから、ファイルの省略記号メニュー (
...) を選択します。ファイルの URL をコピーします。
QnA Maker ポータルの [設定] ページで、ナレッジ ベースに URL を追加します。
SharePoint ファイルでのイメージ
ファイルに画像が含まれている場合、それらの画像は抽出されません。 ファイルが QnA ペアに抽出された後、QnA Maker ポータルからイメージを追加できます。
次のマークダウン構文を使用してイメージを追加します。
角かっこ [] 内のテキストは、イメージについての説明です。 かっこ () 内の URL は、イメージへの直接リンクです。
QnA Maker ポータルのインタラクティブ テスト パネルで QnA ペアをテストすると、マークダウン テキストではなくイメージが表示されます。 このテストでは、クライアント アプリケーションからイメージをパブリックに取得できることを検証します。
アクセス許可
SharePoint を運用しているサーバーからご自分のサポート情報にセキュリティで保護されたファイルを追加する際、この操作に必要な権限の付与が行われます。 SharePoint の設定方法と、ファイルを追加するユーザーのアクセス許可に応じて、次のものが必要になる場合があります。
- 手順を追加しない - ファイルを追加するユーザーには、必要なすべてのアクセス許可があります。
- ナレッジ ベース マネージャーと Active Directory マネージャーの両方による手順。
次の手順を参照してください。
サポート情報マネージャー: SharePoint データ ソースを QnA Maker ポータルに追加する
QnA Maker マネージャーがセキュリティで保護された SharePoint ドキュメントをサポート情報に追加すると、サポート情報マネージャーによって Active Directory マネージャーが完了する必要のあるアクセス許可の要求が開始されます。
この要求は、Active Directory アカウントの認証のポップアップで開始されます。
QnA Maker マネージャーがアカウントを選択すると、Microsoft Entra 管理者は、(QnA Maker マネージャーではなく) QnA Maker アプリに SharePoint リソースへのアクセスを許可する必要があることを示す通知を受け取ります。 Microsoft Entra マネージャーは、すべての SharePoint リソースを認証する必要がありますが、そのリソース内のすべてのドキュメントを認証する必要はありません。
Active Directory マネージャー: QnA Maker へのファイルの読み取りアクセスの付与
(QnA Maker マネージャーではなく) Active Directory マネージャーは、QnA Maker へのアクセスを許可して SharePoint リソースにアクセスし、QnA Maker ポータル SharePoint エンタープライズ アプリにファイル読み取りアクセス許可を付与する必要があります。
Microsoft Entra 管理センターでアクセスを許可する
Azure portal にサインインします。
[Microsoft Entra ID]>[Enterprise アプリケーション] に移動します。
QnAMakerPortalSharePointを検索して、QnA Maker アプリを選択します。
[セキュリティ] の下で [アクセス許可] に移動します。 [組織に管理者の同意を与えます] を選択します。
Active Directory へのアクセス許可を付与するアクセス許可を持つサインオン アカウントを選択します。
API を使用して SharePoint データソースを追加する
Azure Blob Storage を使用して API 経由で最新の SharePoint コンテンツを追加する回避策があります。次の手順を実行します。
- SharePoint ファイルをローカルにダウンロードします。 API を呼び出すユーザーには、SharePoint へのアクセス許可が付与されている必要があります。
- それらを Azure Blob Stoarge にアップロードします。 このアクションにより、SAS トークンを使用してセキュリティで保護された共有アクセスが作成されます。
- SAS トークンによって生成された BLOB URL を QnA Maker API に渡します。 ファイルから回答を抽出できるようにするには、QnA Maker API に渡す前に、URL の最後に '&ext=pdf' または '&ext=doc' のようにサフィックスのファイルの種類を追加する必要があります。