Set up your development environment for Microsoft 365 Copilot

Microsoft 365 Copilot is available to organizations of all sizes. There's no minimum license purchase, but there's a 12-month commitment after a one-month free trial. Microsoft Copilot Pro (Copilot for individuals) doesn't currently support extensibility.

This article summarizes the developer environment prerequisites and requirements to extend, enrich, and customize Microsoft 365 Copilot for the unique way your customers work.

Prerequisites

Developers have two ways to obtain a developer environment for Copilot:

  1. With a sandbox Microsoft 365 tenant with Copilot (available in limited preview through Microsoft 365 Developer Technology Adoption Program (TAP) membership).
  2. With an eligible Microsoft 365 or Office 365 production environment with a Microsoft 365 Copilot license.

Note

Microsoft 365 Copilot is not publicly available with Microsoft 365 Developer Program instant sandbox tenants for development and testing. Sandbox tenant availability is currently limited to Independent Software Vendor (ISV) partners in the TAP.

When developing with Copilot in production environments, be aware of potential admin-imposed limitations. For instance, administrators can block sideloading of custom apps or might not grant the necessary permissions required to build Graph connectors. Sandbox tenants provide an environment where you can develop solutions independent of your production environment and be your own administrator.

ISV Partners in Microsoft 365 Developer TAP

We recommend that our ISV partners who build multi-tenant solutions acquire a new sandbox Microsoft 365 tenant with Copilot. Interested ISVs must be members of the Microsoft 365 Developer Technology Adoption Program (TAP).

Customers with existing Microsoft 365 and Copilot licenses

It's also possible to develop Copilot integrations by working directly in an eligible Microsoft 365 production environment with a Microsoft 365 Copilot license.

Contact your Microsoft representative to add Copilot to your Microsoft plan. Enterprise customers need to be on the Current Channel or Monthly Enterprise Channel for Microsoft 365 apps to have access to Copilot.

Extensibility

Developers can extend Microsoft 365 Copilot with the intelligence of external services and data in several ways: through customizing Copilot with agents, adding skills through Teams message extension plugins and Copilot Studio actions, or extending Copilot's knowledge through Microsoft Graph connectors.

To learn more and choose the best extensibility path for you and your customer, see Extensibility options for Copilot.

Requirements for developing Microsoft Graph connector

  • A search administrator or global administrator must register an application and grant admin consent for the required Microsoft Graph permissions in Microsoft Entra admin center (entra.microsoft.com). As a developer working in production, this might not be an option. Any deployed Graph connector is tenant-wide accessible unless the external items security is locked down.
  • A search administrator will also need to ensure that Microsoft Graph connections you intend for Microsoft Search and Microsoft 365 Copilot are enabled for inline results through the Search & intelligence section of Microsoft admin center (admin.microsoft.com).
  • Indexing content with your connector is subject to the available index quota in the tenant. Standard Microsoft 365 Developer Tenant and Microsoft 365 Copilot Developer tenant comes with quota to let developers start building connectors without any cost. To learn more, see Microsoft Graph connectors license.

Requirements for developing agents and plugins

In addition to a Microsoft 365 Copilot license, there are several additional prerequisites for building agents and plugins for Copilot.

Building with Teams Toolkit

To build agents and plugins with Teams Toolkit and other IDEs, you'll need your admin to enable the ability to sideload a custom app to your tenant. From Teams admin center, select Teams apps > Setup policies > Global (Org-wide default) and enable Upload custom apps:

Screenshot of org-wide setup policy with 'Upload custom apps' toggle enabled in Teams admin center

You can manage your sideloaded custom apps, including agents, from the Teams client by selecting: Apps > Manage your apps.

Creating with Copilot Studio

To create agents and actions with Copilot Studio, you'll need:

For more details, see Copilot Studio Prerequisites for actions and Prerequisites for agents.

Enabling developer mode

You can use developer mode for Copilot while testing your plugin to verify if and how the orchestrator selected your plugin for use in response to a given prompt. From Microsoft 365 Copilot (Business chat), you can enable developer mode by typing -developer on (or off to disable).

Screenshot of `Microsoft 365 Copilot` session where user has typed `-developer on` to successfully enable developer mode

Developer mode is only available within Microsoft 365 Copilot (Copilot for Work) experiences and doesn't surface in Copilot for Web. For more info, see Debugging plugin selection.

Security and privacy

Copilot uses existing permissions and policies to deliver the most relevant information, building on top of our existing commitments to data security and data privacy in the enterprise. For details on how Copilot uses and protects organizational data, see Data, Privacy, and Security for Microsoft 365 Copilot. For data privacy and security considerations for developing different Copilot extensibility solutions, see Data, Privacy, and Security considerations of extending Microsoft 365 Copilot.

Microsoft 365 Copilot developer license management

Accounts used to test Copilot extensibility need a Microsoft 365 Copilot Developer license. Admins can manage Microsoft 365 Copilot Developer licenses using the Microsoft 365 admin center (under Billing > Licenses). You can also assign Microsoft 365 licenses to user accounts with PowerShell.

Frequently asked questions

Can I upgrade my Microsoft 365 business license to use Microsoft 365 Copilot?

Yes. If you have a Microsoft 365 Business Standard or Business Premium license, you can purchase a license for Microsoft 365 Copilot on a one-year or three-year term basis.

Can I use my Microsoft 365 Developer Program instant sandbox tenant to develop with Microsoft 365 Copilot?

No. Microsoft 365 Developer Program sandbox tenant doesn't support commerce and therefore you can't purchase Microsoft 365 Copilot for it.

Can ISV sandbox tenants with Copilot be renewed once the licenses expire?

Yes. If you continue to qualify for the ISV sandbox tenant (Microsoft 365 E5 Developer SKU V2), your development environment auto-renews.

I'm not an ISV and I don't have a Microsoft Copilot license. Can I develop for Microsoft 365 Copilot?

Not at this time. There's currently no timeline for broader availability of sandbox tenants.