SharePoint administrators can now generate a SharePoint Agent report to identify where agents have been created or modified within the last 1, 7, 14, or 28 days.
Requirements:
- Your tenant must have at least one SharePoint Advanced Management (SAM) license add-on or a Microsoft 365 Copilot license, which includes the SAM add-on.
- A SharePoint admin must explicitly enable data collection, as this feature is disabled by default and requires additional confirmation. Microsoft will pause data collection if no report is created for three consecutive months.
- The report only includes data collected after data collection has been enabled. No historical data is available prior to activation.
It’s worth mentioning.
Tenants without the required licenses will not have access to the SharePoint Agent report. For instance, using SharePoint Agents under a Pay-as-you-go model does not provide the insights report.
Unfortunately, Microsoft has not responded to questions about why these customers are excluded or about alternatives for them.
First, a SharePoint administrator must enable data collection.
Go to the SharePoint Admin Center > Reports > Agent Insights, review the additional terms, and activate the data collection. The section is hidden if your tenant has no SAM license add-on. Note, the SharePoint Agent report only includes data collected after this activation, as no historical data is available before the start of collection.
Next, allow a few days for the system to gather sufficient data before generating your first report.
You can choose a reporting duration ranging from 1 to 28 days. Reports can be generated for a specific date range within that window. If you create a report for a period that already exists, SharePoint will replace the previous report.
The report includes details such as the site name, URL, site collection template, site owner, agent name, and the site’s sensitivity label.
However, you might be surprised to find that some expected data is missing. This behavior is explained in the documentation.
The insights report is based on the Microsoft audit data logged for SharePoint agents through the FileCreated and FileRenamed events.
The SharePoint Agent report is not a usage report. Instead, it provides a summary of who created or modified an agent within the last 28 days.
If you need a broader view over time, similar activity data can be retrieved through Microsoft Purview Audit Logs, which retain events for 180 or 365 days, depending on your licensing.
As noted in the documentation, you can also generate and download the report using SharePoint Online PowerShell.
However, there’s a limitation: To run the report, the executing account needs the SAM license add-on.
Without it, PowerShell will return an error stating that the account lacks the required license. That said, downloading an existing report does not require a license.
