You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: "Learn about agent usage in Microsoft 365 Copilot and gain insights into the Microsoft 365 Copilot activity in your organization."
28
+
ms.date: 03/20/2026
27
29
---
28
30
29
-
# Microsoft 365 reports in the admin center – Agent usage in Microsoft 365 Copilot
31
+
# Microsoft 365 Copilot Agent usage report - Microsoft 365 admin center
30
32
31
-
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).
In the Microsoft 365 Copilot Agent usage report, you can view the adoption of agents in Microsoft 365 Copilot in your organization. For agent activity on a given day, the report becomes available within 72 hours of the end of that day (in UTC).
32
36
33
37
> [!NOTE]
34
-
> The report is currently limited to agents built by your org through Microsoft Copilot Studio or Teams Toolkit (including admin-approved agents). 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.<br><br>A [new agent report](/microsoft-365/admin/activity-reports/microsoft-365-copilot-agents-new) is now available in the Microsoft 365 admin center.
38
+
> The report currently supports agents that your organization builds through Microsoft Copilot Studio or Teams Toolkit, including admin-approved agents. 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 aren't yet included but will be added at a later date.<br><br>A [new agent report](/microsoft-365/admin/activity-reports/microsoft-365-copilot-agents-new) is now available in the Microsoft 365 admin center.
39
+
40
+
## View the Microsoft 365 Copilot agent usage report
35
41
36
-
## How do I get to the agent usage in Microsoft 365 Copilot report?
42
+
For information about the roles needed to view usage reports, see [Microsoft 365 admin center usage reports overview](activity-reports.md).
37
43
38
-
1. In the admin center, go to**Reports** > **Usage**.
39
-
1. Select the Microsoft 365 Copilot page.
44
+
1. In the <ahref="https://go.microsoft.com/fwlink/p/?linkid=2024339"target="_blank">Microsoft 365 admin center</a>, go to**Reports** > <ahref="https://go.microsoft.com/fwlink/p/?linkid=2074756"target="_blank">Usage</a>.
45
+
1. Select the **Microsoft 365 Copilot** page.
40
46
1. Select the **Agents** tab to view adoption and usage metrics.
41
47
42
48
## Interpret the Microsoft 365 Copilot agent report
43
49
44
-
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](/microsoft-365/admin/manage/manage-copilot-agents-integrated-apps).
50
+
Use the Microsoft 365 Copilot agent report to see the usage of Copilot agents in your organization that your organization built. The report includes agents that an admin approves and agents that users create through agent builder and share with users in your organization. Admins can manage agents the same way they manage any other app in the Integrated apps section of the Microsoft 365 admin center. For more information, see[Manage Copilot agents in Integrated Apps](/microsoft-365/admin/manage/manage-copilot-agents-integrated-apps).
45
51
46
-
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:
52
+
At the top of the report, you can filter by different periods. You can view the Microsoft 365 Copilot agent report over the last 7 days, 30 days, 90 days, or 180 days:
47
53
48
54
> [!NOTE]
49
55
> 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.
50
56
51
57
:::image type="content" source="../../media/agents-hero-metrics.png" alt-text="Screenshot showing the active agents metrics for Microsoft 365 Copilot.":::
52
58
53
-
**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](/microsoft-365/admin/manage/manage-copilot-agents-integrated-apps). 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.
59
+
**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](/microsoft-365/admin/manage/manage-copilot-agents-integrated-apps). As defined earlier in this article, only agents that your organization created, including both admin approved and shared by users in your organization, are included.
54
60
55
61
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.
56
62
57
-
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.
63
+
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 organization.
58
64
59
65
:::image type="content" source="../../media/agents-recommendation.png" alt-text="Screenshot showing the recommendation card for the Microsoft 365 Copilot usage report." lightbox="../../media/agents-recommendation.png":::
60
66
61
-
To learn more about managing and enabling agents in your org, see [Manage Copilot agents in Integrated Apps](/microsoft-365/admin/manage/manage-copilot-agents-integrated-apps).
67
+
To learn more about managing and enabling agents in your organization, see [Manage Copilot agents in Integrated Apps](/microsoft-365/admin/manage/manage-copilot-agents-integrated-apps).
62
68
63
-
You can see the following summary charts in this report as default view:
69
+
You can see the following summary charts in this report as the default view:
64
70
65
71
:::image type="content" source="../../media/agents-summary.png" alt-text="Screenshot showing the summary chart for agent usage in Microsoft 365 Copilot." lightbox="../../media/agents-summary.png":::
66
72
@@ -80,39 +86,39 @@ You can switch between Summary view and Trend view.
80
86
81
87
| Item | Description |
82
88
| --- | --- |
83
-
| App ID | App identifier generated by Microsoft consistent with the App details page of the app in [Manage Apps](https://admin.teams.microsoft.com/policies/manage-apps) in the Microsoft Teams admin center.|
89
+
| App ID | App identifier generated by Microsoft. It matches the App details page of the app in [Manage Apps](https://admin.teams.microsoft.com/policies/manage-apps) in the Microsoft Teams admin center.|
84
90
| Agent name | The name of the app as present in the app manifest. |
85
91
| Active users in Copilot | The number of distinct users in your organization that are using the agent. |
86
-
| Last activity date (UTC) | The date when that agent was last used by anyone in your organization. |
87
-
| 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](https://admin.teams.microsoft.com/policies/manage-apps) in the Microsoft Teams admin center. |
92
+
| Last activity date (UTC) | The date when anyone in your organization last used the agent. |
93
+
| External app ID | App identifier defined during app creation. This identifier is only applicable for custom apps. It matches the app details page of the app in [Manage Apps](https://admin.teams.microsoft.com/policies/manage-apps) in the Microsoft Teams admin center. |
88
94
89
95
> [!NOTE]
90
-
> 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).
96
+
> The agent details table lists all active agents that admins approve and users create. Due to system limitations, some rows might 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).
91
97
92
98
## FAQ
93
99
94
100
### Are agents created from Microsoft Copilot Studio and Teams Toolkit included?
95
101
96
-
Yes. These are the agents that usage is reported for:
102
+
Yes. The report includes usage for the following agents:
97
103
98
-
- Agents created in Microsoft Copilot studio by users in your org and approved by admin.
99
-
- Agents created in Teams Toolkit by users in your org and approved by admin.
100
-
- Agents created by users through [agent builder](/microsoft-365-copilot/extensibility/copilot-studio-agent-builder) for users that have this feature enabled and shared with other users in your org.
104
+
- Agents that users in your org create in Microsoft Copilot Studio and admins approve.
105
+
- Agents that users in your org create in Teams Toolkit and admins approve.
106
+
- Agents that users create through [agent builder](/microsoft-365-copilot/extensibility/copilot-studio-agent-builder) for users who have this feature enabled and share with other users in your org.
101
107
102
108
### Are agents published by Microsoft or Microsoft Partners included?
103
109
104
-
No. Currently, the report does not include the usage of agents built by Microsoft or Partners.
110
+
No. Currently, the report doesn't include the usage of agents built by Microsoft or Partners.
105
111
106
-
### 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?
112
+
### Why can't I see the agent name or External app ID in the Details section, even though I see the App ID, active users, and last activity date?
107
113
108
-
Due to system limitations, the information about the agent name for the agents created by users in [Agent Builder](/microsoft-365-copilot/extensibility/copilot-studio-agent-builder) isn't currently available. However, usage of these agents is included in the aggregated metrics above the table.
114
+
Due to system limitations, the information about the agent name for the agents that users create in [Agent Builder](/microsoft-365-copilot/extensibility/copilot-studio-agent-builder) isn't currently available. However, the aggregated metrics above the table include the usage of these agents.
109
115
110
-
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.
116
+
If you see the External app ID 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 **Manage apps**. Admins can also 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.
111
117
112
118
### How can I see which users actively used specific agents?
113
119
114
-
This information is not available in the report at this time, but might be added at a later date.
120
+
This information isn't available in the report at this time, but it might be added at a later date.
115
121
116
122
### How does agent usage impact overall Microsoft 365 Copilot usage?
117
123
118
-
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.
124
+
The top-line Microsoft 365 Copilot usage number already includes agent usage. Users can only use agents through Copilot Chat and Copilot in Office apps. The all-up Microsoft 365 Copilot usage report already captures usage of these apps and includes data for all features and functionalities of Copilot.
0 commit comments