Initial Commit of ReadMe and Extend documents

Read Me and Extend documents created, screenshots added, Styling added.

Author: Flow-Joe

Templates/Employee FAQ/EXTEND.md

@@ -0,0 +1,93 @@
+# Extend the Employee FAQ template
+
+## Overview
+
+The Employee FAQ template is designed to allow organizations to easily create a bot to handle day-to-day questions, agent requests, agent responses and obtain feedback on the performance within Microsoft Teams. This is a template that can be easily customized and extended to suite your needs and this file is designed to help you begin that journey.
+
+
+
+## Power Virtual Agents
+
+The Employee FAQ template can easily be extended by adding new topics, messages, questions, actions and more. To begin customizing we suggest looking at the greeting system topic, customizing it to provide a personal greeting that represents your company and how you want your users to start using the bot. You can also quickly and easily add new topics to your bot with the built-in [topic suggestion feature](https://docs.microsoft.com/power-virtual-agents/teams/advanced-create-topics-from-web-teams).
+
+There are also [four lessons provided](https://docs.microsoft.com/power-virtual-agents/authoring-template-topics) with the template to get you started on familiarizing yourself with Power Virtual Agents. Once you have gone through these lessons, you can freely edit the topics or simply create new topics to handle any additional areas you wish to include. You can also reach out to the [PVA Community](https://powerusers.microsoft.com/t5/Power-Virtual-Agents-Community/ct-p/PVACommunity) for help and ideas from our community members. 
+
+
+
+## The Microsoft Dataverse feedback data model
+
+The data model structure for logging feedback is structured around basic core principles for gathering feedback. It’s aimed at providing customers with a basic toolset for logging and reporting on that feedback, and giving the capability to extend it. 
+
+
+
+#### In-depth review of the feedback data model
+
+ 
+
+![image-20210616103757883](C:\Users\junwin\Documents\GitHub\PowerVirtualAgentsSamples\Templates\Employee FAQ\Images\Data-Model)
+
+The first part of gathering feedback is from a **Survey Response**. A **Survey Response** has core information, including the name of the person who the survey was related to, the channel it was originally obtained on, and when the response was created.
+
+
+
+A survey response can have multiple questions associated to it, which is displayed through the **Survey Question** table. The **Survey Question** table has only the question and the link to the originating **Survey Response**. 
+
+
+
+The survey response tracks what the **Survey Question** was and has a related table called **Question Response**. The response is linked back to the originating question and is the original response to the question from the respondent on the **Survey Response**.
+
+ 
+
+This initial data model allows for basic principles of feedback to be followed, and separating the **Survey Response**, **Survey Question**, and **Question Response** to allow for extension and additional reporting. By default, the Power Virtual Agent bot is setup for customer satisfaction (CSAT) type questions. 
+
+
+
+## Extending the Survey Data Model
+
+
+
+A canvas application using the Dataverse model allows users to track feedback in a list format, giving visibility of who the respondent is, the feedback, when it was obtained, and the satisfaction score where it is relevant. 
+
+The **Respondent Name** is currently logged as text, as well as ‘CSAT’. This can be sufficient in most cases where simply knowing and tracking the feedback is enough, however, to provide aggregation and metric-based reports, CSAT would need to be extended to be a number-type field to allow for aggregation. 
+
+This can be done in several ways, including in Power Automate, Dataverse or Power BI, based on the administrator's preference and specific needs. In the same way, **Respondent Name** can be extended to be a lookup reference to a **User** table by modifying the Power Automate contained in the solution to search for and get the related user record. 
+
+
+
+## Extending the Data Model itself
+
+In addition to using existing information available, administrators can also add lookups and other data points to the Survey Response table. 
+
+Examples include using the ‘User’ table to provide more information such as which team they are in, geography or region information, allowing feedback to be aggregated across additional dimensions and providing insight into the feedback in those areas. 
+
+Another example of extending the data model is to add choices to the choices field for ‘Channels’ to include additional options based on what is being used in the business (it currently defaults to ‘Bot’ in the provided solution)
+
+
+
+## Using the data model for user and customer feedback
+
+The current functionality for the Power Virtual Agent Bot has been developed to support logging user or internal requests and feedback. The same data model built for logging feedback from those users can also be used to track the same data model for customer experiences in some cases, depending upon the maturity of your organization. 
+
+An example of using the feedback data model for customers would be to log the survey question and response from a bot deployed on a website.
+
+Extensions can be made to the data model to capture specific dimensional data such as ‘Stores’ and ‘Locations’ in a retail or manufacturing industry to then report on feedback from those dimensions, identifying improvement or issues at a store or location.
+
+
+
+## Extending the number and types of questions asked
+
+Administrators can also extend the bot to ask more questions of the user, and modify the related flow using Power Automate to be able to tailor the feedback questions being asked after the request has been made. 
+
+This experience can be adding questions to the experience or tailoring the type of question asked of the user and what type of response is back. Currently supported are single-type text questions.
+
+
+
+## Extending with Power BI
+
+Enhanced reporting can be built on the data model using Power BI for a visual experience, adding charts and tables for extended viewing and sharing of the data. Power BI can also be used to provide high level branded reporting such as the overall CSAT based on related data for the year, and more.
+
+You can connect your data stored in Dataverse for Teams to Power BI to visualize that data in numerous ways. The main way to connect to your data is to click on ‘Dataverse’ button in Power BI Desktop in the toolbar and enter in your environment details.  
+
+To learn how to get your environment details and for a step by step guide on authenticating Power BI with Dataverse for Teams, check out the [View Dataverse for Teams table data in Power BI Desktop](https://docs.microsoft.com/powerapps/teams/view-table-data-power-bi) document.
+
+Once connected to Dataverse for Teams, select the Table’s you wish to view in the ‘Navigator’ window and click ‘Load’. Depending on the amount of data being loaded, this can take a few minutes. Once this is completed, you can then access your Tables on the right hand side of the ‘Report’ view. 

Templates/Employee FAQ/Images/Add to Teams

@@ -0,0 +1,199 @@
+Employee FAQ PVA Template
+
+## Overview
+
+The Employee FAQ [Power Virtual Agents](https://powervirtualagents.microsoft.com/) template is designed to allow organizations or departments easily create a bot to handle their employee’s common questions by adding content that matches the business’s needs. Whether it’s HR, IT or other internal employee functions, the Employee FAQ bot template is a great place to start. 
+
+Bots are great at providing automated responses to save your organization cost and time and help your employees, and when it can’t help, it needs a way to escalate to human agents. The Employee FAQ template is a Power Virtual Agents template that can be easily customized and extended to suite your needs. It comes with a built-in capability to log an employee’s escalation request, notify a human agent, and allow them to quickly respond to the employee - all within [Microsoft Teams](https://www.microsoft.com/microsoft-teams/group-chat-software). 
+
+Finally, the Employee FAQ template obtains feedback from the employee on the bot’s performance so you can continuously improve the bot.
+
+
+
+## Features
+
+The template supports the following features:
+
+
+
+#### Power Virtual Agents bot
+
+- Lessons Topics
+- Escalation requests (allow users to make requests with a **Title** and **Description** then post the request to a team for human support with an adaptive card)
+- Instant chat links from the request adaptive card to talk to the user that has made a request
+- Resolve requests directly in teams via the adaptive card
+- Status (provide the status of requests for both **all** and **active** requests)
+- Feedback (receive and display feedback to a teams channel with adaptive cards)
+
+
+
+#### Power Automate flows
+
+- Receives and stores information into Microsoft Dataverse
+- Posts adaptive cards to teams
+- Receives information from adaptive cards
+
+
+
+#### Power Apps - canvas app
+
+- View and filter requests
+- View and filter feedback
+
+
+
+## License requirement
+
+Employee FAQ template can be used with Office licenses that include Power Virtual Agents. Learn more about [Licensing for Power Virtual Agents for Teams]( https://docs.microsoft.com/power-virtual-agents/teams/requirements-licensing-teams). Easy way to check is if you can launch [Power Virtual Agents Teams app](https://aka.ms/PVAForTeams) in your Microsoft Teams client.
+
+As you extend the bot beyond what is included in the template, you may be required to upgrade to a premium license. Learn more on [Licensing for Power Virtual Agents](https://docs.microsoft.com/power-virtual-agents/requirements-licensing-subscriptions) on capabilities that require a standalone Power Virtual Agents subscription.
+
+
+
+## Prerequisites
+
+To install and use the Employee FAQ template you will need a Microsoft Teams account. If you do not have this, [sign up here](https://www.microsoft.com/microsoft-teams/group-chat-software) and make an account before proceeding.
+
+
+
+## Installation
+
+First, add the required apps to Teams, and create your Power Apps app:
+
+1. Download the Employee FAQ template solution.
+2. Add the [Power Virtual Agents app in Microsoft Teams](https://docs.microsoft.com/power-virtual-agents/teams/authoring-first-bot-teams#add-the-power-virtual-agents-app-in-microsoft-teams).
+3. Add the **Power Apps** app in Microsoft Teams, and open it.
+4. Go to the **Build** tab and select **Create+** at the bottom of the list of teams.
+5. Select the team you want to use, and create an application. When prompted, name the application **Demo** and select **Save** 
+
+ 
+
+Now, import the template solution:
+
+1. In the Power Apps app, select the **Build** tab to see your list of teams on the side panel. 
+   
+
+   ![Build Tab](Images\Build-Tab)
+   
+
+2. Select the team you choose in the previous step from the list. The app you just created will appear in the main section of the window, this may take a few minutes to update.
+
+3. Select **See all**.
+   
+
+   ![See All](Images\See-All)
+   
+
+4. On the top menu bar, select **Import**, then select **Browse** in the pane that appears.
+
+
+   ![Import](Images\Import)
+
+5. Select the template solution you downloaded, and then **Next**.
+
+6. When you see the items to choose to import, make sure everything is selected and click **Next**.
+
+7. If you have connections, select them, if you do not then add them. You will need to add Microsoft Teams, Office and Dataverse connection.
+
+
+   ![Connections](Images\Connections)
+
+8. Select **Import**.
+
+
+
+You have now imported the solution and your can go to the **Build** tab in Power Apps to see all of your items. To use the bot, you will need to go through some additional set up steps.
+
+
+
+## Set up your Power Virtual Agents bot
+
+We need to update our Power Automate Flows, validate the bot is working and add our Employee FAQ Admin application to a teams channel.
+
+
+
+#### Setting up Power Automate flows
+
+1. In the Power Apps app, select the **Build** tab to see your list of teams on the side panel.
+   
+
+    ![Build Tab](Images\Build-Tab)
+   
+
+2. Select the team you choose in the previous step from the list, then select **See all** to view the solution overview.
+
+
+   ![See All Imported](Images\Imported-See-All)
+
+   
+
+3. Select **Cloud flows** on the side panel.
+   
+
+   ![Cloud Flows](Images\Cloud-Flows)
+   
+
+4. Select the **FAQ Bot - Request** flow to open it.
+   1. Select **Edit**.
+   2. Open the action **Convert time zone - Select Your Timezone** and set the **destination time zone** to your timezone.
+   3. Open the action **Post adaptive card in a chat or channel - Select Team and Channel**.
+   4. Change the **Team** and **Channel** to your desired team and channel for the feedback information adaptive card to be posted to.
+   5. Expand the condition action.
+   6.  Open the action **Convert time zone - Select Your Timezone - Resolved** and set the **destination time zone** to your timezone.
+   7. Select **Save**.
+   8. Select the back arrow ←.
+
+5. Select the **FAQ Bot - Feedback** flow to open it.
+   1. Select **Edit**.
+   2. Open the action **Convert time zone - Select Your Timezone** and set the **destination time zone** to your timezone.
+   3. Open the action **Post adaptive card in a chat or channel - Select Team and Channel**.
+   4. Change the **Team** and **Channel** to your desired team and channel for the feedback information adaptive card to be posted to.
+   5. Select **Save**.
+
+
+
+#### Bot Validation
+
+1. Open the *Power Virtual Agents* Teams application.
+2. Select *Chatbots*.
+3. Select your team.
+4. Select your chat bot.
+5. Select *Publish* on the left menu.
+6. Select *Open the bot*
+7. Select *Add*
+8. You will now be taken to a chat window with your bot. Here you can try trigger phrases to ensure that the bot is functioning correctly. We have listed several phases you should consider trying below:
+   1. Hello
+   2. Talk to agent
+   3. What is the status of my request
+   4. Leave review
+
+
+
+#### Set up Power App Teams tab
+
+While we are setting the Canvas application up, it is important to note that you can also use the bot session performance in the PVA analytics.
+
+ 
+
+1. Select **Apps**.
+
+2. Select the three dots next to the app name (...).
+
+3. Select **Add to Teams**.
+
+
+   ![Add to Teams](Images\Add to Teams)
+
+4. Select **Add to Teams** on the side menu that opens.
+
+5. Select the dropdown arrow and select **Add to a team**.
+
+6. Search for your team.
+
+7. Select **Set Up a Tab**.
+
+8. Select **Save**.
+
+ 
+
+You have now fully set up the Employee FAQ template.