Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Note
This article describes features used in agents or agent flows powered by the standard harness.
Important
This article includes information about Azure Bot Service skills, a code-based way to extend the capabilities of an agent in the standard harness. These skills shouldn't be confused with agentic skills in the GitHub Copilot harness. Learn more about how to use agentic skills in Skills overview for agents.
Copilot Studio lets you extend your agent by using Azure Bot Service skills. If your organization already has deployed bots for specific scenarios (built by using pro-code tools, including the Microsoft 365 Agents SDK), you can convert these bots to Azure Bot Service skills and embed them within a Copilot Studio agent.
Prerequisites
- Review restrictions and validation for Azure Bot Service skills used in Copilot Studio.
- A standalone Copilot Studio subscription. If you have a Teams plan, you can't use Agents SDK skills.
Add an Azure Bot Service skill to an agent conversation
First, create a Copilot Studio agent and create and deploy the Azure Bot Service skill using pro-code tools into your organization.
Next, register the Azure Bot Service skill in Copilot Studio so that your agent can use it.
Finally, add the Azure Bot Service skill to a conversational topic by following these steps:
Go to the Topics page for the agent.
Open the topic you want to call a skill from.
Select the Add node icon
under the node after which you want to call the skill.Select Add a tool, and then select the skill you want to use.
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
Azure Bot Service 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.
Select Save to persist your changes to the topic.
Test your agent to make sure it's using the skill properly.
Convert an existing Azure Bot Service skill from multitenant to single-tenant
You can convert existing Azure Bot Service skills from multitenant support to single-tenant support. To convert a multitenant skill into a single-tenant skill, make the following changes:
Create a new single-tenant Microsoft Entra ID app registration.
Update the skill configuration to use single-tenant.
Deploy the skill.
(Optional) Update the source code.
Learn more in Implement an Azure Bot Service skill for Copilot Studio.
Single-tenant Azure Bot Service 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 Azure Bot Service skills, based on factors such as geography. Review the conditional access policies in your tenant.