SharePoint のエージェントに関するインサイトレポート

SharePoint のエージェントに関するインサイトレポートは、SharePoint 管理者に、organization内のすべての SharePoint サイトと OneDrive サイトで最近作成されたエージェントに関する豊富な情報を提供します。このレポートは、管理者が作成されたエージェントの数が最も多いサイトについて確認するのに役立ちます。このレポートを使用することで、SharePoint 管理者は、エージェントがグラウンディングデータとして使用するコンテンツの整合性をより細かく管理および維持できます。

分析情報レポートは、FileCreated イベントと FileRenamed イベントを通じて SharePoint で作成されたエージェントに対してログに記録された Microsoft 監査データに基づいています。

エージェントインサイトレポートは、SharePoint 管理センターで、または SharePoint Online 管理シェルを使用して生成および管理できます。

エージェントインサイトレポートにアクセスするために必要なもの

SharePoint の高度な管理の前提条件を参照してください。

重要

Microsoft SharePoint 高度な管理ライセンスをお持ちでない場合は、関連する監査データがレポートの作成に使用されて収集されるように、データ収集を有効にするように求められます。有効にすると、24 時間後にレポートを生成でき、レポートには収集時点からのデータが含まれます。データは 28 日間保存されます。 3 か月に 1 回以上レポートを作成しない場合、データ収集が一時停止し、もう一度有効にする必要があります。これらのレポートのデータ収集を有効にするには、「 SharePoint のエージェントに関するインサイトレポートのデータ収集」セクション (本記事内) を参照してください。

SharePoint 管理センターでエージェントインサイトレポートにアクセスする方法

組織の SharePoint 管理者資格情報を使用して SharePoint 管理センターにサインインします。
ナビゲーションウィンドウで、[ レポート] を展開し、[ エージェントインサイト] を選択します。

SharePoint 管理センターでレポートを作成する方法

SharePoint 管理者として、[ レポートの作成 ] を選択してレポートを作成します。
レポート名を入力します。 [ レポート期間] で、レポートの期間を指定します。
[ 作成して実行] を選択します。

注:

過去 1 日間、7 日間、14 日間、または 28 日間のレポートを作成できます。

SharePoint 管理センターでレポートの状態を表示する

レポートの準備ができているか、最後に更新された日時をチェックするには、[状態] 列を参照してください。

SharePoint 管理センターでレポートを表示する

レポートの準備ができたら、それを選択してデータを表示します。エージェントの数が最も多い上位 100 レコードを表示できます。サイトを検索したり、サイトテンプレート、ガバナンスポリシーでフィルター処理したりできます。

SharePoint 管理センターでコンテンツガバナンスポリシーを適用する

インサイトレポートからサイトにコンテンツガバナンスポリシーを適用できます。使用可能なポリシーは、[ サイトのアクセスの制限] ポリシーと [ コンテンツ探索の制限] ポリシーです。

注:

インサイトレポートからサイトにポリシーを適用した後、既存のレポートのポリシーの状態は更新されません。サイト上のポリシーの更新された状態を表示するには、ポリシーを選択して最新の状態を表示するか、アクティブサイトパネルにアクセスしてサイト設定を確認します。

SharePoint Online 管理シェルのエージェントインサイトレポート

SharePoint Online 管理シェルを使用して、エージェントインサイトレポートを生成および管理できます。

まだダウンロードしていない場合は、最新バージョンの SharePoint Online 管理シェルをダウンロードしてインストールします。
Microsoft 365 の SharePoint 管理者以上として SharePoint Online に接続します。詳細については、「SharePoint Online 管理シェルの概要」を参照してください。
これらのレポートを生成して表示するには、organization に SharePoint 高度な管理アドオン SKU または Microsoft Copilot ライセンスがあることを確認します。

少なくとも SharePoint 管理者のアクセス許可があれば、次のコマンドを使用して分析情報レポートを生成して表示できます。

レポート期間の既定の 1 日分のレポートを生成するには、次のコマンドを実行します。
```
Start-SPOCopilotAgentInsightsReport
```
他の期間 (7、14、または 28 日間) のレポートを生成するには、次のコマンドを実行します。
```
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
```
たとえば、過去 28 日間のレポートを生成するには、次のコマンドを実行します。
```
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
```
すべてのアクティブレポートと使用可能なレポートのステータスをチェックするには、次のコマンドを実行します。
```
Get-SPOCopilotAgentInsightsReport
```
特定のレポートのステータスをチェックするには、次のコマンドを実行します。
```
Get-SPOCopilotAgentInsightsReport –ReportId
```
レポートをダウンロードして表示するには、次のコマンドを実行します。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Action Download
```
注:

PowerShell では最大 100 件のレコードが表示されますが、ダウンロードしたレポートには最大 100 万件のレコードを含めることができます。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Action View
```
より詳細なレポートを表示するには、次のオプションを使用します。
1. CopilotAgentsOnSites: すべてのサイトで現在利用可能なすべてのエージェントの名前を提供します。このレポートには、最大 1,000,000 件のレコードが含まれます。
  
  注:
  
  -Content パラメーターの既定値は CopilotAgentsOnSites です。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites
```
2. TopSites: 各サイトで利用可能なエージェントの数を含む 100 サイトの一覧を提供します。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
```
3. SiteDistribution: コミュニケーションサイト、Microsoft 365 グループの接続済みサイト、OneDrive サイトなど、すべての種類のサイトにわたるエージェントの概要ビューを提供します。
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
```