web
You’re offline. This is a read only version of the page.
close
Skip to main content

Notifications

Announcements

Community site session details

Community site session details

Session Id :
Copilot Studio
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:
I have the same question (0)
  • Audrie101 Profile Picture
    on at

    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

Forum hierarchy changes are complete!

In our never-ending quest to improve we are simplifying the forum hierarchy…

Ajay Kumar Gannamaneni – Community Spotlight

We are honored to recognize Ajay Kumar Gannamaneni as our Community Spotlight for December…

Leaderboard > Copilot Studio

#1
Michael E. Gernaey Profile Picture

Michael E. Gernaey 255 Super User 2025 Season 2

#2
Romain The Low-Code Bearded Bear Profile Picture

Romain The Low-Code... 205 Super User 2025 Season 2

#3
S-Venkadesh Profile Picture

S-Venkadesh 101 Moderator

Last 30 days Overall leaderboard