Insights report on agents in SharePoint

The insights report on agents in SharePoint provides SharePoint administrators with rich information on the recently created agents across all SharePoint sites and OneDrive sites within their organization. This report helps admins learn about the sites with the highest number of agents created. By using this report, SharePoint admins can further govern and maintain the integrity of the content used by agents as grounding data.

The insights report is based on the Microsoft audit data logged for the agents created in SharePoint through the FileCreated and FileRenamed events.

You can generate and manage the agent insights report in SharePoint Admin Center or by using SharePoint Online Management Shell.

What you need to access agent insights report

See SharePoint Advanced Management prerequisites.

Important

If you don't have a Microsoft SharePoint Advanced Management license, you're asked to enable data collection so that relevant audit data is collected to build the report. Once enabled, you can generate the reports 24 hours later and they contain data from the point of collection. Data is stored for 28 days. If you don't generate reports at least once in three months, data collection pauses and you need to enable it again. To enable data collection for these reports, see the Data collection for insights report on agents in SharePoint section (in this article).

How to access agent insights report in SharePoint Admin Center

Sign in to the SharePoint admin center with the SharePoint administrator credentials for your organization.
In the navigation pane, expand Reports and then select Agent Insights.

How to create reports in SharePoint Admin Center

As a SharePoint Administrator, select Create a report to create the report.
Enter the report name. Under Report duration, specify the time frame for the report.
Select Create and run.

Note

You can create a report for the past 1, 7, 14, or 28 days.

View report status in SharePoint Admin Center

To check if a report is ready or when it was last updated, see the Status column.

View report in SharePoint Admin Center

When a report is ready, select it to view the data. You can view the top 100 records hosting the highest number of agents. You can search for sites or filter on the site template, and governance policies.

Apply content governance policies in SharePoint Admin Center

You can apply content governance policies on the sites from the insights report. The available policies are Restrict site access policy and Restrict Content Discovery policy.

Note

After you apply a policy to the site from the insights report, the policy status on the existing report doesn't update. To view the updated status of the policy on the site, select the policy to view the latest status or access the Active site panel and review the site settings.

Agent insights report in SharePoint Online Management Shell

You can generate and manage agent insights reports by using SharePoint Online Management Shell.

If you haven't already done so, download and install the latest version of SharePoint Online Management Shell.
Connect to SharePoint Online as at least a SharePoint administrator in Microsoft 365. For more information, see Getting started with SharePoint Online Management Shell.
To generate and view these reports, ensure the organization has the SharePoint Advanced Management add-on SKU or Microsoft 365 Copilot license.

With permissions of at least a SharePoint administrator, you can generate and view the insights report by using the following commands:

To generate a report for the default one-day report duration, run the following command:
```
Start-SPOCopilotAgentInsightsReport
```
To generate a report for any other duration (7, 14, or 28 days), run the following command:
```
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
```
For example, to generate a report for the past 28 days, run the command:
```
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays <28>
```
To check the status of all active and available reports, run the following command:
```
Get-SPOCopilotAgentInsightsReport
```
To check the status of a specific report, run the following command:
```
Get-SPOCopilotAgentInsightsReport –ReportId
```
To download and view the report, run the following command:
```
Get-SPOCopilotAgentInsightsReport –ReportId -Action Download
```
Note

PowerShell displays up to 100 records, but downloaded reports can contain up to 1 million records.
```
Get-SPOCopilotAgentInsightsReport –ReportId -Action View
```
To view more detailed reports, use the following options:
1. CopilotAgentsOnSites: Provides the name of all the agents currently available on all sites. This report contains up to 1,000,000 records.
  
  Note
  
  The default value for the -Content parameter is CopilotAgentsOnSites.
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content CopilotAgentsOnSites
```
2. TopSites: Provides a list of 100 sites with the number of agents available on each site.
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
```
3. SiteDistribution: Provides the summarized view of agents across all types of sites like Communication sites, Microsoft 365 Group connected sites, OneDrive sites, and more.
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
```

Data collection for insights report on agents in SharePoint

If you don't have a Microsoft SharePoint Advanced Management license, you need to enable data collection. This section explains how to enable and check the status of data collection for the Insights report on agents in SharePoint.

Enable data collection

This PowerShell command starts collecting audit data for reports on activities from the last 28 days.

Start-SPOAuditDataCollectionForActivityInsights

Disable data collection

This PowerShell command stops collecting audit data for reports on activities from the last 28 days.


Stop-SPOAuditDataCollectionForActivityInsights

Check the data collection status

After you enable data collection, you can generate the reports after 24 hours. To check whether you can generate reports, use the PowerShell command Get-SPOAuditDataCollectionStatusForActivityInsights. The command returns the current data collection status, which can be NotInitiated, InProgress, or Paused. You can generate reports when the status is InProgress.

Get-SPOAuditDataCollectionStatusForActivityInsights

Known experiences with agent insights reports in SharePoint

The following experiences are known with agent insights reports generated in SharePoint Admin Center or by using SharePoint Online Management Shell:

You can rerun a report only after 24 hours since the last report generated.
In large tenants, it might take up to 48 hours for the data to be available.
Only one report can exist for each report range value (1, 7, 14, or 28 days). This limitation means you can see a maximum of four reports at a given point.
The newly generated report replaces the previously created report with the same date range. To preserve the previously created report, download the report first before creating a new report for the same date range.
These reports use Microsoft 365 unified audit data and might not cover all audit events.

Feedback

Var denne side nyttig?

Last updated on 2026-05-13