Use Microsoft Bot Framework skills in Microsoft Copilot Studio

Important

Power Virtual Agents capabilities and features are now part of Microsoft Copilot Studio following significant investments in generative AI and enhanced integrations across Microsoft Copilot.

Some articles and screenshots may refer to Power Virtual Agents while we update documentation and training content.

Microsoft Copilot Studio enables you to extend your bot using Microsoft Bot Framework skills. If you have already built and deployed bots in your organization (using Bot Framework pro-code tools) for specific scenarios, you can convert bots to a skill and embed the skill within a Microsoft Copilot Studio bot.

Prerequisites

Add a skill to bot conversations

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

Next, register a skill in Microsoft Copilot Studio.

Add a skill into a conversation:

  1. Go to the Topics page for the bot you want to edit.

  2. Open the authoring canvas for the topic you want to call a skill action from.

  3. Select Add node (+) underneath an existing node to add a new node.

    Screenshot of adding a node.

  4. In the node selection window, select Call an action, and then select the skill you want to add.

  5. If your skill has inputs, assign variables to those inputs. Also, if your skill emits 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 Power Automate to further parse and break down complex JSON strings into key value pairs for use in your bot.

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

  7. You should test your bot to make sure it's using the skill properly.