Skip to main content

SharePoint Agent Insights Report

The SharePoint Agent Insights report shows administrators where agents are being created across SharePoint and OneDrive, and which sites have the most. Part of SharePoint Advanced Management, it is the sister report to Agent Access Insights: that one tracks how agents read content, while this one tracks where agents are created. Since every SharePoint agent is grounded in the site content beneath it, knowing where agents appear tells you which content is quietly becoming an AI knowledge source.
Related
Agent Access Insights Report, App Insights Report, SharePoint Agents, Site Permissions Across Your Organization

Common Use Cases

  • Tracking agent creation: seeing where agents are born across SharePoint and OneDrive
  • Finding new AI knowledge sources: every agent grounds in the site content beneath it
  • Site-by-site ranking: spotting the sites with the most agents created
  • Pairing with access data: running alongside Agent Access Insights for the full picture
  • Securing source sites: checking that sites spawning agents are accurate and secured
  • Applying protection inline: applying RAC or RCD policies directly from the report

Benefits

  • See where agents originate: turns agent creation into a ranked, governable view
  • Sister to access insights: creation plus access gives the whole agent story
  • Audit-grounded detection: watches .agent file creation and rename events
  • Act inline: apply Restricted access control and Restricted content discovery from the report
  • Distribution at a glance: a summary across site types
  • Tenant-scale: detailed download covering up to 1 million records

Details

  • Feature Category: Search & AI

How It Works

  • Lives in the SharePoint Admin Center: App Launcher, Admin, SharePoint admin center, Agent insights under Reports
  • Create a report: name it and pick a duration; PowerShell equivalents exist for starting and viewing reports
  • Detects .agent files: watches file creation and rename audit events
  • Admin only: only SharePoint administrators can create and view it; site owners and regular users have no access
  • Licensing: the tenant needs either the SharePoint Advanced Management add-on license or a Microsoft 365 Copilot license, which includes Advanced Management
  • Output: an on-screen view of the top 100 records, filterable, plus a download covering up to 1 million records including the full agent-per-site listing

Limits and Nuances

  • Fixed durations: 1, 7, 14, or 28 days, with one report per range (4 maximum); a new report for the same range overwrites the old one, and re-runs are allowed every 24 hours
  • Created with a name and filters: name the report, then filter by site template and governance policies
  • Audit-based detection: detection rests on .agent file creation and rename events, so it may not capture every agent-related event
  • Collection lifecycle: without a SAM license, data collection must be enabled first; data is stored 28 days and collection pauses after 3 months without a report
  • Act inline: apply Restricted access control or Restricted content discovery directly from the report

Common Questions About the SharePoint Agent Insights Report

What does the SharePoint Agent Insights report show?

Recently created agents across SharePoint and OneDrive, ranked by site – so you can see which sites have the most agents and where agent creation is trending. Views cover agents per site, top sites by count, and distribution across site types.

How is this different from the Agent Access Insights report?

This report tracks where agents are created; Agent Access Insights tracks how agents access content. Run both: creation tells you which sites are becoming AI knowledge sources, access tells you what those agents actually read.

How does it detect agents?

SharePoint agents are stored as .agent files, so the report watches file creation and rename events in the Microsoft 365 unified audit log. Because it relies on audit data, it may not capture every event.

What license is required to run this report?

You need either the SharePoint Advanced Management add-on license or a Microsoft 365 Copilot license, which includes Advanced Management. Licensing packages change often, so check Microsoft’s official requirements before planning around it.

How far back does it go?

28 days at most. Report durations are fixed at 1, 7, 14, or 28 days, with one report per range and a maximum of four at a time. A new report for the same range overwrites the previous one, and re-runs are allowed every 24 hours.

Why does it matter where agents are created?

An agent answers from the site content beneath it. When someone creates an agent on a messy or overshared site, that site’s problems become the agent’s answers. Knowing where agents appear lets you check that the underlying sites are accurate, current, and properly secured – before the answers spread.