Create and edit a Copilot agent

If you have edit permissions on a SharePoint site, you can create new Copilot agents or edit an existing Copilot agent. You can build a copilot that is tailored to your team’s needs and content and share them with your teammates in Teams chat.

With site edit permissions, you can create your own copilot and edit a previously customized copilot by:

Customizing its branding and purpose
Adding or removing which sites, pages, and files your Copilot agent should include as knowledge sources beyond the current SharePoint site.
Refining the copilot’s behavior by writing customized prompts tailored to the purpose and scope of the copilot.

Note: The copilot only answers your questions using information from sites, pages, and files that you already have access to and have included as the copilot’s sources. To get information from all the sources you want the copilot to use, you may need to update permissions for yourself or the people you want to share the copilot with.

Create a Copilot agent

After signing into your SharePoint site, there are four places where you can create a Copilot agent from:

SharePoint homepage
The command bar of a document library
The context menu of the selected file(s) in a document library
Copilot chat pane

From the SharePoint homepage

On the site home page, select New > Copilot agent

The screenshot of creating new copilot agent from site homepage

From the command bar of a document library

On a document library, you can choose Create a Copilot agent for all supported files in this library.

The screenshot of Create new copilot agent from document library

From the context menu of the selected file(s) in a document library

Instead of creating a Copilot agent for all files in a document library, sometimes you may want to just include some files. In this case, you can select the files you want, then select Create a Copilot agent from the context menu by either right clicking or selecting the ellipsis next to one of the selected files:

The screenshot of creating a new copilot agent by selecting files

From the Copilot chat pane

On any site, page, or document library, select the Copilot button on the upper right to open Copilot. Then select the dropdown next to the current copilot, then select Create a Copilot agent.

The screenshot of creating a new copilot agent from the chat pane

No matter where you choose to create your Copilot agent from, once you select Create a Copilot agent, the copilot is immediately ready, scoped to your selection. You can choose to Try it directly without further adjustments, or you can select Edit to customize its branding, purpose, scope and behavior.

The screenshot of editing a Copilot agent

Where can you find your Copilot agent file?

Every time you create a Copilot agent, it is stored as a .agent file. If you create it from the homepage of a site, the .agent file is automatically stored under Site contents > Site Assets > Copilots.

screenshot of where copilot agents are saved if created from home page

If you create a Copilot agent from other places, it is automatically saved to the current document library folder, in the place where you originally created it.

screenshot of copilot agents saved to the current document library folder

Edit a Copilot agent

During creation

If you select Try it after the Copilot agent is created, you can edit the copilot later from the copilot chat pane. Or, if you select Edit, you can begin finetuning the copilot’s identity, sources, and behavior as following.

Under Identity, give the Copilot agent a new name, describe the purpose of the Copilot agent and how to use it.

screenshot of the starter UI to edit a copilot agent

Under Sources, you can modify the selection of files and sites that your Copilot uses to gather information. It is possible to include additional sites and documents that are outside your current SharePoint site as sources for your Copilot. It's important to remember that users interacting with the Copilot will only receive information from sources they already have access to.

The screenshot of adding knowledge resources to copilot agent

screenshot of selecting more files to add to copilot agent

Under Behavior, create a welcome message for the users of your Copilot agent, then provide a few starter prompts and instructions for copilot following these guidelines. Use the test panel on the right to try it out and adjust your instruction and starter prompts.

screenshot of editing copilot agent behavior

Save your Copilot agent and publish. Your Copilot agent is now available for your later use and Share your Copilot agent with others.

Edit an existing Copilot agent

You can edit a Copilot agent you just created, or you can edit an existing Copilot agent. To edit a Copilot agent, simply select it from the Copilot chat pane and then choose Edit.

Notes:

You can't edit or share the out-of-box Copilot agent.
When a SharePoint hub site is included as the source for the Copilot agent, it automatically includes its associated sites. Your Copilot agent will use information from both the hub site and its associated sites to respond.
If a Copilot agent is shared in Teams, once it is edited in Copilot Studio, the original copilot will not work in Teams anymore.
When you share a Copilot agent with others, make sure they have access to the sources for optimal experience.

FAQ and data handling

To learn more about Copilot agent, see Frequently asked questions.

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