SharePoint agents and Copilot
AI and Copilot

Upgrade agents in SharePoint and OneDrive - SharePoint in Microsoft 365

In brief

The documentation now refers to the Microsoft Copilot plugins ecosystem and adds a link to the agent registry for viewing SharePoint agents.

What SharePoint admins need to know

Administrators can use the updated guidance and agent registry link when reviewing SharePoint agents; no action is required.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

Upgrade agents in SharePoint and OneDrive - SharePoint in Microsoft 365 | Microsoft Learn

Learn how to upgrade your agent experiences in SharePoint and OneDrive. By upgrading, your agents can leverage Copilot in SharePoint and all the functionality of the Microsoft Copilot plugins ecosystem.

What is changing?

Microsoft is upgrading the agent experience in SharePoint and OneDrive. Upgrading better aligns your agents with the Microsoft Copilot extensibility ecosystemMicrosoft Copilot plugins ecosystem, ensuring your agents are part of the Microsoft Copilot app Home experience and the Microsoft plugin registry, the shared catalog for discovering, publishing, and governing organization-approved and custom-built plugins across Microsoft Copilot experiences, Microsoft 365 apps, OneDrive, and SharePoint.

Existing agents in the .agent file format will continue to work across SharePoint, Microsoft Teams, and the Copilot app until the end of March 2027. You can start upgrading or moving each experience to a supported path that best fits its purpose now. After March 2027, .agent files will stop responding and you will have to upgrade to continue using them.

| Provides a customized Q&A, retrieval, or analysis experience | Upgrade the agent with Microsoft Copilot Agent Builder | | Is a custom engine agent built in Copilot Studio and published to SharePoint | Publish the existing Copilot Studio agent to Microsoft Copilot app |

Starting in mid-November 2026, you'll use Microsoft Copilot Agent Builder to create agents for SharePoint and OneDrive. You can still select SharePoint and OneDrive content as knowledge sources and use a provided prompt to start building a conversational agent. However, creating an agent no longer saves a .agent file in SharePoint or OneDrive. You can edit, share, and monitor your agents through the Copilot app and manage them through Agent 365. Starting in mid-November 2026, you'll use Microsoft Copilot Agent Builder to create agents for SharePoint and OneDrive. You can still select SharePoint and OneDrive content as knowledge sources and use a provided prompt to start building a conversational agent. However, creating an agent no longer saves a .agent file in SharePoint or OneDrive. You can edit, share, and monitor your agents through the Copilot app and manage them through Agent 365.

Are agents in SharePoint and OneDrive being retired?

![Screenshot of the agents you own shown in Build in SharePoint.](sharepointonline/media/upgrade-sharepoint-agents/sp-build-see-agents.png)

What should I do if I use an agent that someone else created?