Microsoft Copilot Studio (Power Virtual Agents)

Connect to your bot

To use the Copilot skill, you'll need to configure it with a secret key for the bot, you can get it from the PVA bot settings -> Security -> Web channel security

Remember to publish the bot before trying to connect to it. Instructions here.

Selecting the Power Virtual Agent skill under Conversation & Skills

Welcome message

In DDNA studio, you can enable/disable the greeting via the switch MY DIGITAL PERSON SHOULD GREET ME AT START. It will trigger the System topic named Conversation Start in your PVA bot.

The message boxes in PVA let you specify text and speech; if both are specified, the speech field will be used by the digital person (click on the top right to toggle between Text and Speech).

Fallback message

Flagging messages as fallback allows interoperability with skills, if the system gets a fallback response, a different skill configured in the project may be used to fulfill that request.

To flag a given message as fallback, double click the message box, and in Channel data, click on the arrow, and enter the following Formula: { IsFallback: true }

Content cards

To make use of SM Content Cards, use @showcards(card_name) in a message. Define the card data in the Activity Value: double click the message box and set the activity value by clicking on the arrow and entering the card data as a formula:

{
    cat: {
        component: "image",
        data: {
            url: "https://placekitten.com/300/300",
            alt: "A cute kitten"
        }
    }
}

Note that you need to use “record” format, not JSON (keys don’t have quotes). Make sure you click on the arrow and insert the value as a Formula.