21
17

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

😭Copilot Studioが回答してくれない(from SharePoint・OneDrive)

Last updated at Posted at 2024-05-21

Copilot Studioを使用すると作成者は、公開 Webサイトや SharePointなどのデータソースに基づいた生成的な回答をするCopilot(チャットボット)を作成することができます。

ただし、場合によってはCopilotが応答を提供せず、「すみません、どのようにサポートしたらよいかわかりません。言い換えてみてもらえますか?」 (実際のメッセージは異なります) のような内容を返すことがあります。

image.png

SharePoint または OneDrive がデータ ソースとして構成されている場合、生成回答ができない要因はいくつか存在します。
まずは、以下のリンクの通りに前提条件や手順が正しくクリアされていることを確認してください。
https://learn.microsoft.com/ja-jp/microsoft-copilot-studio/nlu-boost-node

正しく設定をしてもうまく回答してくれない場合は、主に以下5つの要因を探り対処してください。

  1. 検索結果がうまくとれていない
  2. Copilotにアクセスするユーザーがデータソースに対する十分な権限がない
  3. ファイルが3MBのサイズ制限を超えている
  4. アプリの登録またはCopilotが正しく構成されていない
  5. コンテンツモデレートによってコンテンツがブロックされている

1. 検索結果がうまくとれていない

SharePoint・OneDriveを基にする生成的な回答は、Graph API検索 エンドポイントの呼び出しに依存します。
Graph API から返される上位 3 つの結果のみが、要約と応答の生成に使用されます。
つまり、Graph API から結果が返されない場合、Copilotは応答を提供しません。

Copilot Studio が Graph API から結果を受け取っていないかどうかを診断するには、Graph API 検索 エンドポイントを直接呼び出します

確認方法

Graph API 検索 エンドポイント への呼び出しは、Graph エクスプローラー で次のテンプレートを使用して実行できます。

Graph エクスプローラーについて詳しくはこちら
https://learn.microsoft.com/ja-jp/graph/graph-explorer/graph-explorer-overview

このとき、SharePoint/OneDriveテナントの適切な資格情報を使用してサインインしてください。

以下のテンプレートをコピーして、Graph エクスプローラーで開くか、こちらのディープリンクをクリックします。

.json
{
    "requests": [
        {
            "entityTypes": [
                "driveItem",
                "listItem"
            ],
            "query": {
                "queryString": "SEARCH TERMS filetype:docx OR filetype:aspx OR filetype:pptx OR filetype:pdf path:\"DOMAIN.sharepoint.com/sites/SITENAME"
            },
            "from": 0,
            "size": 3,
            "QueryAlterationOptions": {
                "EnableModification": true,
                "EnableSuggestion": true
            }
        }
    ]
}

右上のアイコンをクリックし、SharePoint/OneDriveテナントの適切な資格情報を使用してサインインできているか確認します。
image.png

Request bodyのDOMAINSITENAMEに、
今回確認したい該当サイトのURLにある、ドメイン名、サイト名を入れます。

例えば、以下のようなサイトの場合、以下のように設定します。
https://<user-domain>.sharepoint.com/sites/DemoSite
DOMAIN<user-domain>
SITENAME:DemoSite

[Run query]をクリックします。
image.png

今回「サインインしたユーザーに十分な権限がないか、[Modify permissions] タブのアクセス許可の 1 つに同意する必要があります。」というエラーが表示されたため、[Modify permissions]タブを開きます。
image.png

[Modify permissions]タブの「File.Read.All」と「Sites.Read.All」を権限のあるアカウントで[Consent]します。
image.png

もう一度、[Run query]をクリックします。「OK」のメッセージが表示されたら完了です。
これができなければ、Copilotでも回答が返ってきません。
image.png

うまくいかないときの対処方法

  1. 指定先が関連するコンテンツのあるSharePoint・OneDrive のURLであるかを確認
  2. サポートされている形式(*)にある書類のみ 応答を生成するために使用されることを確認

*注意
サポートされている形式は以下です。

  • SharePoint ページ (モダン ページ)
  • Word 文書 (docx)
  • PowerPoint ドキュメント (pptx)
  • PDF ドキュメント (pdf)

3.ドキュメントが SharePoint・OneDrive にアップロードされてすぐの場合、まだインデックスされていない可能性を確認
また、SharePoint・OneDrive側の設定で、一部のサイトが検索結果に表示されないように設定されている可能性を確認
詳細については、SharePoint オンラインで検索結果が見つからない を参照してください。

2. Copilotにアクセスするユーザーがデータソースに対する十分な権限がない

SharePoint と OneDrive 上の生成された回答は、Graph API を呼び出すときの委任されたアクセス許可に依存します。
ユーザーは少なくとも、関連するサイトおよびファイルに対する読み取り権限を持っている必要があります。そうでない場合、Graph API の呼び出しは結果を返しません。

対処方法

関連するSharePoint と OneDriveのサイトやファイルにアクセスできるようにユーザーの権限を変更します。
詳細については、 SharePoint モダン エクスペリエンスにおける共有と権限 を参照してください。

3. ファイルが3MBのサイズ制限を超えている

現在、生成的回答は最大 3 MBのサイズのファイルのみを処理できます。
大きなファイルは SharePoint に保存でき、Graph API 検索によって返されますが、生成的な回答では処理されません

image.png

対処方法

ファイルを編集・分割して小さくするか、
Microsoft 365 セマンティックインデックス またはAzure Open AI for Generative Answersへ接続する (Add your Data) の使用など、代替アーキテクチャを検討することをお勧めします。

4. アプリの登録またはCopilotが正しく構成されていない

社内でCopilotを使用する前に、管理者は Microsoft Entra IDによる認証を設定し、追加のスコープを構成する必要があります。

アプリの登録またはCopilotの認証設定にスコープが欠落している場合、または必要なスコープに同意が与えられなかった場合、結果は返されず、エラーや例外も返されません
エンドユーザーから見ると、ドキュメントが見つからなかったかのように見えます。

対処方法

①アプリ登録の確認
以下のサイトの手順を参考にアプリ登録を行ってください。

正しく設定できていれば以下の画像のように表示されます。
image.png

②認証設定の確認
以下のサイトの手順を参考に認証設定を行ってください。

正しく設定ができていれば、以下のような設定内容で表示されます。

5. コンテンツモデレートによってコンテンツがブロックされている

応答を生成するとき、Copilot Studioは、次の可能性のあるコンテンツをブロックします。

  • 有害である
  • 悪意のある
  • 非準拠である
  • 著作権に違反している

コンテンツがブロックされた場合、回答は行われず、その事実を示す応答や表示を提供しません。
こちらの挙動はサービスを使うユーザーを守るためのもので、簡単なレベル設定はできます。

また、ブロックされたかどうかを確認するための設定をすることも可能です。
Copilot Studioのテレメトリデータを Azure Applications Insights に送信するように構成されている場合、モデレーションイベント(ブロックされた回答)はログに記録されます。

対処方法

①コンテンツモデレーションのレベル設定で調整する
Copilotの生成AIページにある[Copilotのコンテンツモデレーション]をクリックします。
image.png

規定値は[High]になっていますが、他に[Medium], [Low]を設定できます。
高いほど、厳しくブロックされます。

  • [High]: Copilot の回答は適切
  • [Medium]: Copilot はより多くの回答を生成するが、回答は無関係または望ましくない可能性あり
  • [Low]: Copilot は最も多くの回答を生成するが、不正確である可能性あり

設定を変更したら[保存]を忘れずにしましょう!
image.png

②サポートに問い合わせ
回答が返ってこず、コンテンツをモデレート(ブロック)すべきではないと思われる場合は、以下のサイトの手順に従って、サポートに問い合わせをお願いいたします。

③ブロックされたかどうかを確認する設定を行う
回答だけ見ても、ブロックされた結果なのかどうかがわかりません。
こちらを確認したい場合は、設定で分析が行えるようにしましょう。

以下の手順に従って、Copilot Studioのテレメトリデータを Azure Applications Insights に接続します。
https://learn.microsoft.com/ja-jp/microsoft-copilot-studio/advanced-bot-framework-composer-capture-telemetry?tabs=webApp#connect-your-microsoft-copilot-studio-bot-to-application-insights

Copilotを Azure App Insights に接続した後、Application Insights リソースの[Logs]セクションに移動します。

次の Kusto Query Language (KQL) クエリを使用して、コンテンツがブロックされたかどうかを確認できます。

customEvents
| extend cd = todynamic(customDimensions)
| extend conversationId = tostring(cd.conversationId)
| extend topic = tostring(cd.TopicName)
| extend message = tostring(cd.Message)
| extend result = tostring(cd.Result)
| extend SerializedData = tostring(cd.SerializedData)
| extend Summary = tostring(cd.Summary)
| extend feedback = tostring(todynamic(replace_string(SerializedData,"$","")).value)
| where name == "GenerativeAnswers" and result contains "Filtered"
| where cloud_RoleInstance == "myCopilot"
| project cloud_RoleInstance, name, timestamp, conversationId, topic, message, result, feedback, Summary
| order by timestamp desc

結果、ブロックされたときのデータが表示されます。
image.png

参照

21
17
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
21
17

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?