Use skills in Copilot Studio

Copilot Studio enables you to extend your agent by using skills. If your organization already deployed bots for specific scenarios (built by using pro-code tools, including the Microsoft 365 Agents SDK), you can convert these bots to skills and embed them within a Copilot Studio agent.

Prerequisites

Add a skill to agent conversations

First, create a Copilot Studio agent and create and deploy the skill using pro-code tools into your organization.

Next, register the skill in Copilot Studio so that your agent can use it.

Finally, add the skill to a conversational topic by following these steps:

  1. Go to the Topics page for the agent.

  2. Open the topic you want to call a skill from.

  3. Select the Add node icon under the node after which you want to call the skill.

  4. Select Add a tool, and then select the skill you want to use.

  5. If your skill has inputs, assign variables to those inputs. Also, if your skill outputs to variables, you can use those variables in any nodes that follow.

    Note

    Skills can accept simple data types (integer, Boolean, string) and complex data types (as JSON strings).

    If you need to extract variables from complex data types, you must use an agent flow to further parse and break down complex JSON strings into key value pairs for use in your agent.

  6. Select Save to persist your changes to the topic.

  7. Test your agent to make sure it's using the skill properly.

Convert an existing skill from multitenant to single-tenant

You can convert existing skills from multitenant support to single-tenant support. To convert a multitenant skill into a single-tenant skill, make the following changes:

  1. Create a new single-tenant Microsoft Entra ID app registration.

  2. Update the skill configuration to use single-tenant.

  3. Deploy the skill.

  4. (Optional) Update the source code.

For more information, see Implement a skill for Copilot Studio.

Single-tenant skills and conditional access policies

Microsoft Entra ID tenant admins can configure conditional access policies to control access to resources in the tenant. These policies can affect requests to resources, including skills, based on factors such as geography. Review the conditional access policies in your tenant.