Insights report on SharePoint agents

2025-06-06

Insights report on SharePoint Agents provides SharePoint Administrators with rich information on the recently created SharePoint agents across all SharePoint sites and OneDrive sites within their organization. This report provides admins with the ability to learn about the sites with the highest number of agents created. Using this report, SharePoint admins can further govern and maintain the integrity of the content used by agents as grounding data.

Insights report is a SharePoint Advanced Management feature and available in organization with SharePoint Advanced Management add-on SKU or Microsoft 365 Copilot license. The insights report is based on the Microsoft audit data logged for SharePoint agents through the FileCreated and FileRenamed events.

You can generate and manage SharePoint agent Insights report in SharePoint Admin Center or with SharePoint Online Management Shell.

Create and view SharePoint Agent Insights report in SharePoint Admin Center

You can create and view SharePoint agent Insights report after sign into SharePoint Admin Center with your SharePoint admin credentials.

Create reports in SharePoint Admin Center

With permissions of a SharePoint Administrator, you can generate the report by selecting Create a report.
Provide the Report name and 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.

Screenshot of report status.

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.

Screenshot of view report.

Apply Content governance policies in SharePoint Admin Center

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

Screenshot of applying RCD.

Note

After a policy is applied to the site from the insights report, the policy status on the existing report won't be updated. 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.

SharePoint Agent Insights report in SharePoint Online Management Shell

You can generate and manage SharePoint agent Insights report using SharePoint Online Management Shell.

If you haven't, 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 using the following commands:

To generate report for a one-day default report duration, run the command:
```
Start-SPOCopilotAgentInsightsReport
```
To generate a report for any other duration (7, 14 or 28 days), run the command:
```
Start-SPOCopilotAgentInsightsReport -ReportPeriodInDays
```
For example, to generate 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 command:
```
Get-SPOCopilotAgentInsightsReport
```
To check the status of a specific report, run the command:
```
Get-SPOCopilotAgentInsightsReport –ReportId
```
To download and view the report, run the 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 further detailed reports, the following options are available:

a. 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
```
b. TopSites: Provides a list of 100 sites with the number of agents available on each site.
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content TopSites
```
c. SiteDistribution: Provides the summarized view of agents across all types of sites like Communication sites, Microsoft 365 group connected sites, OneDrive site, etc.
```
Get-SPOCopilotAgentInsightsReport –ReportId -Content SiteDistribution
```

Data collection for insights report

Important

If you don't have a Microsoft SharePoint Premium - SharePoint Advanced Management license, you'll be asked to enable data collection, so that the product starts to collect the relevant audit data to build this report. Once enabled, the reports can be generated 24 hours later and contain data from the point of collection. Data is stored for 28 days. If no reports are generated even once in three months, data collection is paused and should be enabled again.

Enabling data collection

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

Start-SPOAuditDataCollectionForActivityInsights

Disabling data collection

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


Stop-SPOAuditDataCollectionForActivityInsights

Checking the data collection status

Once data collection is enabled, the reports can be generated after 24 hours. To check whether reports can be generated, use the PowerShell command Get-SPOAuditDataCollectionStatusForActivityInsights. The command returns the current data collection status which can be "NotInitiated","InProgress", "Paused". Reports can be generated when the status is "InProgress".

Get-SPOAuditDataCollectionStatusForActivityInsights

Known experiences with SharePoint Agent Insights reports

The following are some known experiences with SharePoint Agent Insights reports generated in SharePoint Admin Center or using SharePoint Online Management Shell:

A report can be rerun 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 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 are generated using Microsoft 365 unified audit data and might not cover all audit events.

Share via