Share via


Create and delete agents

With Copilot Studio, you can easily create agents by using a conversational creation experience.

Note

Agents created in Copilot Studio and in Microsoft Teams are automatically configured for Microsoft Entra ID authentication.

You can also configure single sign-on (SSO) so your users don't need to sign in manually. For more information, see Configure single sign-on with Microsoft Entra ID.

To create your first agent, see Quickstart: Create and deploy an agent.

Create an agent

  1. Sign in to Copilot Studio.

  2. Switch to the desired environment if needed.

  3. On the Home page, enter a brief description of what you want your agent to be.

    Alternatively:

    • Go to the Create page and select New agent.
    • Go to the Agents page and select New agent.

    A page appears with two panes where you can set up your agent on the left-hand side, and test it on the right-hand side. The left-hand pane has two tabs: Describe and Configure. You can alternate between these two experiences, and also iterate between setting up your agent and testing it.

  4. Chat with Copilot, in the Describe tab, to describe your agent. Copilot asks questions to guide you, and uses your responses to fill in the details, such as the name, description, instructions, and knowledge, that define your agent.

    Alternatively, switch to the Configure tab, and fill the form.

    Note

    • The conversational agent creation experience uses your browser language. If your browser language isn't in the list of supported languages for the conversational agent creation experience, only the Configure tab with the more discrete configuration experience is available.
    • The maximum length for the name is 30 characters.
    • The description can have up to 1,000 characters.
    • The instructions can have up to 8,000 characters.

    At each conversation turn with Copilot, or for every configuration change you make, Copilot Studio automatically saves your agent. You can start creating another agent before you're done with the one you're currently defining without losing what you have so far: select the three dots in the upper right-corner and select New agent.

    Once you have a name, description, and instructions for your agent, you can already start testing it!

  5. Chat with your draft agent in the test pane. Enter your own question or try one of the starter prompts. Go back and forth between the test pane and the creation pane as needed, to further refine your agent. If you want to see the starter prompts again, select New chat at the top of the test pane.

    Note

    During the creation experience, your agent might need a few moments before it can start using its knowledge sources.

  6. If desired, change the primary language your agent uses to communicate.

  7. Optionally, select a solution and set the schema name for your agent.

  8. When you're satisfied with your tests, select Continue. The Overview page for your agent appears.

Delete an agent

You can delete agents to remove them from your environment.

  1. Go to the Agents page.

  2. Select the agent you want to delete.

  3. On the top menu bar, select the three dots (), and select Delete.

    Screenshot that shows where to find the option to delete an agent.

    Copilot Studio prompts you to confirm your intention.

  4. Enter your agent's name and select Delete agent. After a few minutes, all data associated with the agent is deleted permanently.

Note

If your license is expired, you can delete your agents by selecting Permanently delete your agents.

Known issues with creating an agent

When you're creating your agent, you might encounter these issues.

Insufficient permissions for the selected environment

You might see this error: "You don't have permissions to any environments, Get access from an administrator." To resolve the error, create a new environment. Use that environment to create your agent again.

For more information, see Understand error codes.