Microsoft 365 reports in the admin center – Agent usage in Microsoft 365 Copilot
In the Microsoft 365 Copilot agent usage report, you can view the adoption of agents in Microsoft 365 Copilot in your org. For agent activity on a given day, the report becomes available within 72 hours of the end of that day (in UTC).
Note
The report is currently limited to agents built by your org through Microsoft Copilot Studio or Teams Toolkit (including admin-approved agents and agents created by users through agent builder). The report captures usage of agents in Microsoft 365 Copilot and Copilot in Word and PowerPoint. SharePoint agents and agents built by Microsoft and Microsoft partners are not yet included but will be added at a later date.
How do I get to the agent usage in Microsoft 365 Copilot report?
- In the admin center, go to Reports > Usage.
- Select the Microsoft 365 Copilot page.
- Select the Agents tab to view adoption and usage metrics.
Interpret the Microsoft 365 Copilot agent report
You can use this report to see the usage of Copilot agents in your organization that were built by your organization and include agents that are approved by an admin and agents created via agent builder and shared with users in your org. Admins can manage agents in the same way as they manage any other app in the Integrated apps section of the Microsoft 365 admin center. Learn more in Manage Copilot agents in Integrated Apps.
At the top, you can filter by different periods. The Microsoft 365 Copilot agent report can be viewed over the last 7 days, 30 days, 90 days, or 180 days:
Note
Copilot agent data in Copilot Chat (work) and Copilot in Word and PowerPoint is available starting November 1, 2024. Agent data in Copilot Chat (web) is available starting January 15, 2025.
Active agents shows the distinct number of apps with a declarative agent element in that app with at least one active user over the selected time period. For more information, see Declarative agents FAQ. As defined earlier, only agents that have been created by your org including both admin approved and shared by users in your org are included.
End-users interact with agents in two ways: either by at-mentioning the agent in a chat experience or by selecting the agent from the right-side panel in Copilot Chat or from the hamburger menu on the top left corner in Copilot in Word or PowerPoint. An active user of an agent is a user who sends a prompt request to an agent and receives a response.
In Recommendations, the recommended action card suggests that admins visit the Integrated apps section of the Microsoft 365 admin center to explore and enable more agents for users in their org.
To learn more about managing and enabling agents in your org, see Manage Copilot agents in Integrated Apps.
You can see the following summary charts in this report as default view:
The definition of active agents is the same as provided earlier.
You can switch between Summary view and Trend view.
Summary view shows you the total number of agents that were actively used over the selected time frame.
Trend view shows you the count of active agents on a daily basis over the selected time frame.
Agent details table
| Item | Description |
|---|---|
| App ID | App identifier generated by Microsoft consistent with the App details page of the app in Manage Apps in the Microsoft Teams admin center. |
| Agent name | The name of the app as present in the app manifest. |
| Active users in Copilot | The number of distinct users in your organization that are using the agent. |
| Last activity date (UTC) | The date when that agent was last used by anyone in your organization. |
| External app ID | App identifier defined during app creation. This is only applicable for custom apps, consistent with the app details page of the app in Manage Apps in the Microsoft Teams admin center. |
Note
The agent details table lists all active agents that are admin-approved and user-created agents. Due to system limitations, some rows may not display the agent name or External app ID. If only the External app ID is available, IT admins can find the agent name in the manage apps section of the Microsoft Teams admin center by following the steps in the FAQ section.
FAQ
Are agents created from Microsoft Copilot Studio and Teams Toolkit included?
Yes. These are the agents that usage is reported for:
- Agents created in Microsoft Copilot studio by users in your org and approved by admin.
- Agents created in Teams Toolkit by users in your org and approved by admin.
- Agents created by users through agent builder for users that have this feature enabled and shared with other users in your org.
Are agents published by Microsoft or Microsoft Partners included?
No. Currently, the report does not include the usage of agents built by Microsoft or Partners.
Why can't I see the Agent name and/or External app ID in the Details section, even though I see the App ID, active users, and last activity date?
Due to system limitations, the information about the agent name for the agents created by users from Agent Builder is not currently available. However, usage of these agents is included in the aggregated metrics above the table.
If External app ID is visible but not the agent name, you can identify your organization’s agent name by looking up the External app ID in the Microsoft Teams admin center under the Manage apps. Admins also have the option to export the details table in the agent report and export the managed apps in Microsoft Teams admin center for a bulk lookup of agent name.
How can I see which users actively used specific agents?
This information is not available in the report at this time, but might be added at a later date.
How does agent usage impact overall Microsoft 365 Copilot usage?
Agent usage is already included in the top-line Microsoft 365 Copilot usage number, as agents can only be used via Copilot Chat and Copilot in Office apps. Usage of these apps is already captured in the all-up Microsoft 365 Copilot usage report, which includes data for all features and functionalities of Copilot.