Microsoft 365 Insights エージェントのトラブルシューティング

この記事では、古いインストール、 エージェントが見つからない、インストールが見つからない 、または開くエラー、使用状況データの不足、フィードバックが利用できない、所有権の検証、予期しないメトリック結果など、一般的な Insights Agent の問題を解決します。

Insights エージェントにフィードバック機能が表示されない

Insights エージェントを開くことはできますが、会話のきっかけや応答にはフィードバックや評価は含まれません。

原因

インストールされているコピーが現在の Insights エージェント パッケージに更新されませんでした。

解決策

  1. Microsoft 365 Copilot エージェントの一覧から Insights エージェントを削除します。
  2. Insights エージェントを検索します。
  3. Insights エージェントを再度追加します。
  4. それを開き、"所有するエージェントを教えてください" または "{エージェント名} についてユーザーがどのようなフィードバックをしましたか?" と試してみてください。

Insights エージェントを削除して追加すると、個人用インストールが更新されます。 分析するエージェントを削除または変更することはありません。

Insights エージェントは検索できますが、開いたりインストールしたりするとエージェントが見つかりません

Insights エージェントが検索に表示されますが、それを選択すると、開くかインストールする代わりに、「 エージェントが見つかりません 」エラーが生成されます。

原因

Microsoft 365 管理センターでエージェントがすべてのユーザーが利用できることが示されている場合でも、Insights エージェントの可用性の割り当てが古くなる可能性があります。

解決策

Microsoft 365 管理者に問い合わせて、Insights エージェントの可用性の割り当てをリセットするよう依頼してください。

  1. Microsoft 365 管理センターで Insights エージェントの可用性またはユーザー割り当てコントロールを開きます。
  2. Insights エージェントを [ ユーザーなし] に設定し、保存します。
  3. Insights エージェントを [ すべてのユーザー] に設定し、もう一度保存します。
  4. 変更が反映されるのを待ってから、Insights エージェントを開くかインストールを再試行します。

重要

このリセットは、Insights エージェントの可用性の割り当てに適用されます。 このリカバリの一環として 、エージェント フィードバックの共有 を変更しないでください。

質問したエージェントの使用状況データがない

"{Agent Name} のすべての使用状況分析情報を提供してください" など、サポートされている使用状況のプロンプトを求めると、応答にはデータがないというメッセージが表示されます。

最も考えられる原因

  • エージェント名がテナントに表示される名前と完全には一致しません。
  • エージェントには、要求されたウィンドウに対して十分なアクティビティがありません。 新しいエージェントにはまだアクティビティがない可能性があり、ウィンドウ化されたメトリックは、現在の期間と比較期間に十分なアクティビティが必要です。
  • エージェントを可視化することはできません。

解決策

正確な名前を確認し、エージェントが要求されたウィンドウに対して十分なアクティビティを持っていることを確認してから、再試行します。 アクティブで表示されているエージェントがまだデータを返さない場合は、承認されたチャネルを通じて、正確なプロンプトと応答を含んでサポートに連絡してください。

使用は機能しますが、フィードバックは利用できません

最も考えられる原因

  • 選択したエージェントを所有していません。
  • 所有権を確認できませんでした。
  • テナント管理者が、エージェント フィードバックの共有に エージェントなし を選択しました。
  • テナント管理者は [選択したエージェント ] を選択し、要求されたエージェントを含めませんでした。

解決策

  1. "所有しているエージェントを見せてください" と依頼します。
  2. 所有権の結果から 1 つの正確なエージェント名を選択します。
  3. テナント管理者に、Agents>Settings>Agent フィードバック共有をチェックするように依頼してください。
  4. 選択したエージェントが構成されている場合は、選択したエージェントが含まれていることを確認します。
  5. 設定が反映されたら、フィードバック要求を再試行します。

使用状況の可視性は、フィードバック アクセスを許可しません。 フィードバックの共有を有効にすると、所有者はフィードバックを対象となりますが、所有権チェックも満たさない限り管理者にアクセス権は付与されません。 構成ガイダンスについては、「 エージェント フィードバックの共有」を参照してください。

フィードバック要求は成功しますが、返される項目は 0 個です

現在、選択したエージェントについてフィードバックはありません。 これは有効な結果であり、所有権やフィードバック共有の問題を示すものではありません。 アクセス許可の変更は必要ありません。

使用状況とフィードバックを組み合わせた要求から返される結果は 1 つだけです

使用法とフィードバックでは、取得パスと承認パスを別々に使用します。 使用は成功してもフィードバックは成功しない場合は、 フィードバックの所有権と共有の手順に従います。 フィードバックは成功しても使用が成功しなかった場合は、エージェント名、可視性、要求された使用ウィンドウを確認します。 1 つの成功した結果を、もう一方のパスも成功するはずだという証拠として解釈しないでください。

所有権が拒否されているか利用できない

状態 意味 解決策
拒否されました 所有権チェックにより、所有者ではないことが判明しました。 所有するエージェントを選択するか、所有者にフィードバックを確認するよう依頼します。
使用不可 サービスが所有権を確認できませんでした。 後で再試行します。 問題が解決しない場合は、サポートにお問い合わせください。 これを所有者ではない証拠として扱わないでください。
あいまいな名前 複数の所有エージェントに同じ表示名が付いている。 Insights エージェントによって表示される正確なエージェント ID を選択します。

保持応答には、注意事項が含まれています

リテンション応答には、"これは、ユーザー レベルのコーホート リテンションではなく、ウィンドウ全体の比率の集計として計算されます" などのステートメントが含まれます。

原因

Insights エージェントは集計された持続使用プロキシを報告するため、この点に注意が必要です。 従来のコホート リテンションでは、同じユーザーを時間を超えて追跡する必要がありますが、Insights エージェントはこれを返しません。

解決策

この値は、アクティブ ユーザーのプールが連続する等長ウィンドウにわたって増加しているか、保持しているか、または縮小しているかとして解釈します。

インストールまたはアンインストールの数が利用できない

インストールとアンインストールのシグナルが Insights エージェントのデータ レイヤーに接続されていません。 導入シグナルとして、DAU、WAU、MAU、および一意のユーザーの傾向を使用します。

傾向クエリから予期せず小さい数値またはエラーが返される

最も考えられる原因

要求された時間枠に十分なアクティビティがないか、以前にインストールしたパッケージが時間式を正しく解析しない可能性があります。

解決策

  • Insights エージェントを削除し、もう一度追加してインストールを更新します。
  • 正確なエージェント名と サンプル プロンプトでサポートされているプロンプトを使用して再試行します。
  • 問題が解決しない場合は、承認済みチャネルを通じてサポートに問い合わせてください。 元のプロンプトと応答を提供します。

比較が別のダッシュボードと一致しない

考えられる原因

  • 2 つのサーフェスは異なるタイム アンカーを使用します。
  • 他のダッシュボードでは、個別のユーザーの代わりに、セッション、プロンプト、またはアカウントがカウントされます。
  • 誰かがエージェントの名前を変更するか、再発行し、2つのサーフェスが異なるバージョンにアクティビティを属性付けしました。

解決策

同じ日付アンカーを使用し、両方のサーフェスで個別のユーザーがカウントされていることを確認します。 不一致が解決しない場合は、承認済みのチャネルを通じてサポートに問い合わせてください。 プロンプトとダッシュボードの証拠を提供します。

最も急速に成長している結果は予想外です

原因

最も急成長しているランキングは、ユニーク ユーザーの前週比の変化率でエージェントをランク付けします。 開始母集団が小さいと、大きな割合で変化が生じる可能性があります。

解決策

ランキングを解釈する前に、基になる一意のユーザー数とパーセンテージの変化を一緒に確認します。

サポートに問い合わせる前に

  • 正確なプロンプトと完全な応答を記録します。
  • 日付、時刻、テナントを記録します。
  • 使用が機能し、フィードバックのみが失敗したかどうかを示します。
  • Insights エージェントを削除して再度追加したかどうかの状態。
  • フィードバックの問題については、応答でフィードバックが報告されていないか、共有が無効になっているか、所有権が拒否されたか、所有権が利用できないか、エージェント名があいまいであるかを記録します。 また、エージェントのフィードバック共有がエージェント なし、 すべてのエージェント、または 選択したエージェントに設定されているかどうかを記録します。
  • サポートが承認チャネルを通じて要求しない限り、ユーザー フィードバック、コメント、プロンプト、応答、またはその他のプライベートなコンテンツを含めないでください。