Skip to main content

Notifications

Community site session details

Community site session details

Session Id :
Copilot Studio - General
Unanswered

YAML documentation

(0) ShareShare
ReportReport
Posted on by 74

Hey, I'm wondering if there is YAML documentation for PVA/Copilot Studio. Or some other way to figure out what everything means and the implications.

For example(but not only), what is the difference in terms of functionality between the two examples below. The latter of the two I got from the system topic "End Conversation", the other from an authored topic redirect. And if I change the system topic "End Conversation" to a Trigger Phrase instead of a systemRedirect, will this impact the accuracy of the analytics and other flow functionality.

 

And yeah, over all documentation would be helpful for many things.

Thanks! 

 
"beginDialog:
kind: OnRedirect"
 
"beginDialog:
kind: OnSystemRedirect"
Categories:
  • Audrie101 Profile Picture
    on at
    Re: YAML documentation

    If you mean documentation in context with Copilot Studio I only found this:
    Unified authoring canvas migration guidance - Microsoft Copilot Studio | Microsoft Learn

    You will also find YAML samples in our Github here. They are especially useful for bringing in previously customized topics: GitHub - microsoft/CopilotStudioSamples

    Full documentation on YAML in general can be found here:
    YAML Ain’t Markup Language (YAML™) revision 1.2.2


    Regarding your specific question:

    "beginDialog:
    kindOnRedirect"
    What this means: I believe this refers the dialog when there is a Topic redirection to the current topic.

    "beginDialog
    :
    kindOnSystemRedirect"
    What this means: I believe this refers the dialog when there is a 'System' redirection to the current topic.

    'System' Topics are these:
    Use system topics in Microsoft Copilot Studio - Microsoft Copilot Studio | Microsoft Learn

    All that said, please do enter any additional documentation asks into our Ideas Forum so that other community members may upvote it with you. This will help with prioritization, so feel free to invite others to vote with you: Power Virtual Agents Ideas · Community


    Thank you again for your patience.

Under review

Thank you for your reply! To ensure a great experience for everyone, your content is awaiting approval by our Community Managers. Please check back later.

Helpful resources

Quick Links

Announcing the Engage with the Community forum!

This forum is your space to connect, share, and grow!

🌸 Community Spring Festival 2025 Challenge Winners! 🌸

Congratulations to all our community participants!

Warren Belz – Community Spotlight

We are honored to recognize Warren Belz as our May 2025 Community…

Leaderboard > Copilot Studio - General

#1
Romain The Low-Code Bearded Bear Profile Picture

Romain The Low-Code... 76

#2
Pablo Roldan Profile Picture

Pablo Roldan 61

#3
stampcoin Profile Picture

stampcoin 10

Overall leaderboard