Manage agents in SharePoint

All site members can create their own agents and use them. Other site members with editing permissions can use, edit, or share these agents. As a site owner, you can choose a main agent for the site. 

Approve agents

You do not need to approve agents for a site. Agents created in SharePoint aren't automatically listed or published anywhere. Users can discover agents by manually navigating to .agent files to use them, or they can be placed on the SharePoint page using the Agent link web part. There is a folder structure found under Site Assets > Copilots > Approved, which can be used to keep track of Approved agents. Site Assets > Copilots is also the folder location for agents created from the "New agent" command on Site pages. If you have published an agent from Microsoft Copilot Studio to this site, that .agent file can be found in Documents > Copilot Studio Agents.

This behavior changed in June 2026.

Set an agent as the main agent for the site

You can select an agent to be the main agent for the site. This agent opens when users select the Agent icon from the global header. To select the main agent:

1. Select the Gear icon from the global header to open the Site AI settings panel.
2. Choose a Main agent. You can choose from the ready-made agent and any agent created in SharePoint (.agent file) on the site that you have access to. If the site is in the Copilot in SharePoint public preview, the ready-made agent is named Copilot. Otherwise, it's named after the site.

If you don't make any changes, the ready-made agent is the main agent for the site.

Delete an agent

Site members with edit permissions can delete an agent like deleting other files:

1. Locate the .agent file. To learn more about how to find the .agent file, see Where to find the agent file.
2. Select the context menu by selecting the ellipsis (the three dots) next to the .agent file.
3. Select Delete.

Monitor agents

If you have at least site visitor permissions (site admins, site owners, site members, and site visitors), you can monitor agents on a SharePoint site by using the following approaches:

• File statistics: Select an individual .agent file and use the Details pane to view its file statistics.
• Search: Use Search to find all agents on a site for bulk actions.
• Site usage: Use Site usage to see the most popular files and agents on their sites.

If you have permissions of a SharePoint admin or more, see here for ways to monitor agent usage across sites.

FAQ and data handling

To learn more about agents in SharePoint, see Frequently asked questions.

For more information on how Microsoft Copilot works, see Data, Privacy, and Security for Microsoft Copilot.