Manage agents for Microsoft 365 Copilot in Integrated Apps
Important
- You must have Microsoft 365 Copilot license to use agents for Copilot.
- The capability is enabled by default in all Microsoft 365 Copilot licensed tenants.
- Admins can manage how individual agents are approved for use and which agents are enabled.
Microsoft 365 Copilot is a new experience in Microsoft 365 that combines the power of large language models with your data and apps in Microsoft 365 to capture natural language commands to produce content and analyze data. It enables access to and use of third-party apps, such as Jira, Dynamics 365, or Bing Web Search.
Admins can manage agents for Copilot in the same way as they manage any other app in the Integrated apps section of the Microsoft 365 admin center. Admins can enable, disable, assign, block, or remove agents for their organization, and manage Copilot capabilities and data privacy.
Overview
Agents enhance the functionality of Copilot by adding search capabilities, custom actions, connectors, and APIs. Agents are custom versions of Microsoft 365 Copilot that combine instructions, knowledge, and skills to perform specific tasks or scenarios. To learn more, see Get started with agents for Microsoft 365 Copilot.
Microsoft Copilot Studio is a low-code development platform that offers a graphical environment to build agents tailored to the internal needs of an organization. Copilot Studio enables developers and makers to create and test their applications in a user-friendly interface.
However, before these agents can become available to users, the agents must undergo a streamlined process of submission and approval. To learn more, see Publish agents.
The hub Copilot experience shows the list of agents that are available and deployed for the user. Users can toggle it on or off to restrict access of Copilot to any specific agents during the interaction. Users can also add or remove agents in their Copilot experience by right-clicking on the agents and selecting the appropriate option. Users can only access the agents that are allowed by the admin and that they have installed or been assigned to.
Manage agents in the Microsoft 365 admin center
Admins can manage agents as apps in the Integrated apps section of the Microsoft 365 admin center, where they can see the list of available, deployed, or blocked apps for their organization. They are able to:
- Make am agent available to specific users or groups.
- Block or unblock agents for the complete organization.
- Deploy or remove agents for the complete organization or specific users or groups.
Admins can view agents from the list of available, deployed, or blocked apps on the Integrated apps page by using the filter option of Host products > Copilot.
You can also check if a specific app has Copilot support by selecting it from apps list and checking if the app overview mentions Copilot as a host product.
Enable or disable Copilot extensibility
Admins can enable or disable Copilot extensibility for their org by using a preview setting in the tenant default options in the Integrated Apps section of the Microsoft 365 admin center. This setting lets you control who can access agents in their organization. The setting will be available until February 12th, 2025. Over the next 90 days, we’ll introduce additional agent reports and controls in each of the experiences, as well as more comprehensive guidance about how to manage this spectrum of agents across these controls.
The preview setting has three options:
- All Users This is the default option and it means that all users in the organization can access agents, subject to the existing app policies and user assignments.
- No Users This option means that no users in the organization can access agents, and the third party agents are disabled in the agents flyout. This option also hides agents from the list of Available and Deployed apps on the Integrated Apps page.
- Specific Users This option lets you select specific users or groups in your organization to have access to agents. So while all or specific users in your organization may have permissions to install and use apps from the Available apps and Deployed apps lists, only the users or groups you select in this setting can use agents.
Note
Once extensibility is disabled, the Microsoft pinned Visual Creator agent and entry point for Agent Builder will no longer be visible in BizChat. Once extensibility is disabled in the tenant, it can take up to 24 hours for agents to disappear for users and for Agent Builder and Visual Creator to disappear.
Deploy or remove agents
Admins can deploy or remove agents across the whole organization or for specific users or groups by using the same gestures and controls that work for any other app in the Microsoft 365 admin center. Admins can select an agent from the list of Available or Deployed apps and select Deploy or Remove. Admins can also choose to deploy or remove the agents for everyone or specific users or groups. Deploying or removing an agent affects its availability and functionality in Copilot and in the other host products, such as Outlook, Teams, or Microsoft 365.
Manage how users can install agents
Admins can assign or unassign agents to specific users or groups by using the same gestures and controls that work for any other app in the Microsoft 365 admin center. Admins can select an app that has a plugin for Copilot from the Available apps or Deployed apps list and select the Assign or Unassign option. Admins can also choose to assign or unassign the app to everyone or specific users or groups. Assigning or unassigning an agent affects its availability and functionality in Copilot and in the other host products, such as Outlook, Teams, or Microsoft 365.
Important
Developers can update the existing apps to work with Microsoft 365 Copilot. If the updated app was pre-approved or pre-installed by an admin, then it'll update for the assigned users and starts working with Copilot. If a developer updates a previously blocked app to work with Microsoft 365 Copilot and then the admins make the app available to the users, then such an app also works with Copilot.
Block or unblock agents
Admins can block or unblock agents for the complete organization or specific users or groups by using the same gestures and controls that work for any other app in the Microsoft 365 admin center. Admins can select an app that has an agent from the list of Available or Deployed apps and select the block or unblock option. Admins can also choose to block or unblock an agent for everyone or specific users or groups. Blocking or unblocking an agent affects its availability and functionality in Copilot as well as other host products, such as Outlook, Teams, or Microsoft 365.
View and consent to permissions and data access
For detailed information about how Microsoft 365 Copilot uses, protects, and shares organizational information to power extensibility, see Data, Privacy, and Security for Microsoft 365 Copilot.
Ensuring a secure implementation of Declarative Agents in Microsoft 365
Microsoft 365 customers and partners can build declarative agents that extend Microsoft 365 Copilot with custom instructions, grounding knowledge, and actions invoked via REST API descriptions configured by the declarative agent. At runtime, Microsoft 365 Copilot reasons over a combination of the user's prompt, custom instructions that are part of the declarative agent, and data which was provided by custom actions. All of this data might influence the behavior of the system, and such processing comes with security risks, specifically that if a custom action can provide data from untrusted sources (such as emails or support tickets), an attacker might be able to craft a message payload which causes your agent to behave in a way they control - incorrectly answering questions or even invoking custom actions. While Microsoft takes many measures to prevent such attacks, organizations should only enable declarative agents that use trusted knowledge sources and connect to trusted REST APIs via custom actions. If the use of untrusted data sources is necessary, design the declarative agent around the possibility of breach and don't give it the ability to perform sensitive operations without careful human intervention.
Microsoft 365 provides organizations with extensive controls governing who can acquire and use integrated apps and the specific apps enabled for groups or individuals within a Microsoft 365 tenant, including those apps that include declarative agents. Tools like Copilot Studio, which enable users to create their own declarative agents, also include extensive controls that allow admins to govern connectors used for both knowledge and custom actions.
Publish agents
The publishing process in the Microsoft 365 admin center for agents submitted via Copilot Studio is designed to ensure governance and quality of the custom applications. It also reduces manual work by automating the submission of manifests, freeing developers and admins from tedious tasks. The simplified approval process reduces the time it takes for you to approve apps, making it easier for you to manage custom applications in the Microsoft 365 admin center.
The publishing process involves the following steps:
Developers create and test agents in Copilot Studio, which provides a user-friendly interface for inputting the parameters and data for the applications.
Developers submit their agents for approval from within Copilot Studio to the Microsoft 365 admin center.
You can discover the apps with agents that are submitted but not yet approved in admin center under the Requested Apps tab in the Integrated Apps section. The tab shows the name, host products, status, and Copilot readiness of the applications. The status of a new app is
Publish pending
and of an update to an existing app isUpdate pending
.You can select a pending application to see more details and metadata, such as the description, requester, request date, and the status. These details help you to make an informed decision on whether to publish or reject the application.
You can approve or disapprove any pending application by selecting Publish or Reject.
If the application is approved, it becomes available to the org users based on the org default settings for custom apps. The application also becomes part of the
Available apps
list in the admin center, where admins can manage user assignments and other settings as any other app.If the application is disapproved, it is removed from the
Pending approval
list in the admin center, and the status is shared with Copilot Studio. The developer can make changes and resubmit the application for approval.
If the developer publishes an update to an existing application, the update is also submitted for approval and follows the same workflow as a new application. The update is shown in the ‘Pending approval’ list with the status
Update pending
. Until the update is approved, the previous version of the application remains available to the users.
Agent metadata in admin center
Admins can access key metadata for Copilot extensions directly within the publish flow on the Integrated Apps page. This metadata includes details such as the agent’s capabilities, data sources (for example, OneDrive and Sharepoint files and sites, or Graph connectors), and custom actions. This update simplifies workflows and empowers admins to make informed decisions with confidence, while maintaining a secure and compliant environment.