SharePoint and OneDrive agents move away from .agent files
New agent creation moves to Microsoft Copilot Agent Builder
Microsoft is changing agent creation and upgrade experiences in SharePoint and OneDrive, with rollout scheduled from mid-November to early December 2026. Existing .agent file agents will stop working in SharePoint, Teams and Copilot app during April 2027.
Key points
- Use Copilot in SharePoint for site-level questions and answers.
- Convert a .agent file to a skill when it supports a focused task or business outcome specific to the site.
- For content-grounded conversations across Microsoft 365, upgrade to a declarative agent or update a custom engine agent published to the SharePoint channel.
- Upgraded agents must be re-added to Teams Chat/Channel.
- The Agent Chat web part will let site owners and page authors add any agent from the Plugin store to SharePoint.
What to do
Identify teams that own or manage .agent files and communicate the March 2027 transition deadline. Match each agent to the appropriate upgrade path. Review Agent 365 controls and governance for new and upgraded agents. Plan to re-add upgraded agents to Teams Chat/Channel. Tell owners that no file changes are needed today and existing .agent files remain editable during the transition.
Timeline
- 16 October 2026 Published
- December 2026 Rollout end (planned) Agent creation and upgrade: completion expected by early December.
- April 2027 Retirement end (planned) .agent file experiences in SharePoint, Teams and Copilot app: .agent file agents: shutdown expected to complete by mid-April.
Speaker notes
This changes how SharePoint and OneDrive agents are created and managed, not just where users find them. New creation will use Microsoft Copilot Agent Builder, and the agents will appear in Plugin store rather than create .agent files. Owners should choose the upgrade path according to what each agent does today. An Upgrade button in the SharePoint builder and a convert-agent-file-to-skill skill will support the transition. Existing .agent file agents continue working through the end of March 2027, followed by a shutdown rollout in April. That shutdown also covers Agent Link web part, the immersive experience and the chat pane in SharePoint. The schedule covers Worldwide and Government clouds, but Copilot in SharePoint is currently available worldwide and is only described as coming soon to Government clouds. Microsoft identifies centralized controls in Agent 365 but does not state licence requirements for this change.
Sources and links
- Message Center Message Center MC1511052
Related cards
Area, status, change type, licence and flags are indicative. Always open the source before you act on a card.