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 in 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.

    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 suggested 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 suggested 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 Create. The Overview page for your agent appears.

Make your agent unique with a distinctive icon

  1. Select the agent icon in the top bar.

  2. Select Change icon.

  3. Choose an image from your device. The image file must be in PNG format and less than 30 KB in size, with a maximum resolution of 192 × 192 pixels.

  4. Select Save.

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.