Merge pull request MicrosoftDocs#4189 from MicrosoftDocs/main638145752223052359sync_temp

For protected CLA branch, push strategy should use PR and merge to target branch method to work around git push error

Author: learn-build-service-prod[bot]

powerapps-docs/maker/TOC.yml

@@ -245,7 +245,7 @@
       href: ./canvas-apps/help-desk-install.md
   - name: Create your first app
     items:
-    - name: 1 - Create an app from a design or a template
+    - name: Create an app from a design or a template
       items:
       - name: Create an app from a template
         href: ./canvas-apps/get-started-test-drive.md
@@ -268,7 +268,13 @@
           - name: Troubleshoot common errors
             href: ./canvas-apps/figma/common-errors.md
             displayName: Troubleshoot common errors when creating app from Figma
-    - name: 2 - Create an app using data
+    - name: Create an app using AI Copilot (preview)
+      items:
+      - name: Overview
+        href: ./canvas-apps/ai-overview.md
+      - name: Create an app from conversations
+        href: ./canvas-apps/ai-conversations-create-app.md
+    - name: Create an app using data
       items:
       - name: From Microsoft Dataverse
         href: ./canvas-apps/data-platform-create-app.md
@@ -278,13 +284,13 @@
         href: ./canvas-apps/get-started-create-from-data.md
       - name: From Azure SQL Database
         href: ./canvas-apps/app-from-azure-sql-database.md
-    - name: 3 - Make basic customizations
+    - name: Make basic customizations
       items:
-      - name: 1 - Galleries
+      - name: Galleries
         href: ./canvas-apps/customize-layout-sharepoint.md
-      - name: 2 - Forms
+      - name: Forms
         href: ./canvas-apps/customize-forms-sharepoint.md
-      - name: 3 - Cards
+      - name: Cards
         href: ./canvas-apps/customize-card.md
   - name: Create an app from scratch
     items:
@@ -378,6 +384,10 @@
                 href: ./canvas-apps/add-screen-context-variables.md
               - name: Add a scrolling screen
                 href: ./canvas-apps/add-scrolling-screen.md
+              - name: Add a chatbot (preview)
+                href: ./canvas-apps/add-ai-chatbot.md
+              - name: Add a copilot (preview)
+                href: ./canvas-apps/add-ai-copilot.md
               - name: Configure Office 365 screens
                 items:
                   - name: Calendar-screen overview

powerapps-docs/maker/canvas-apps/add-ai-chatbot.md

@@ -0,0 +1,114 @@
+---
+title: Add Chatbot control to your canvas app
+description: A control that enables embedding of any published Power Virtual Agent (PVA) bot into Power Apps for end-user.
+author: mduelae
+ms.topic: conceptual
+ms.custom: 
+  - canvas
+  - intro-internal
+ms.reviewer: 
+ms.date: 3/13/2023
+ms.subservice: canvas-maker
+ms.author: tapanm
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+contributors:
+  - mduelae
+---
+
+# Add Chatbot control to a canvas app (preview)
+
+[This article is prerelease documentation and is subject to change.]
+
+Add Chatbot control to your canvas apps and embed a published [Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) chatbot to assist your end-users with a variety of requests—from providing simple answers to common questions to resolving issues requiring complex conversations. 
+
+You can use an AI bot or AI boosted conversations bot:
+
+- With AI chatbots, you can create an extended tree of answers to support your users. More information: [Power Virtual Agents preview quickstart (preview)](/power-virtual-agents/preview/quickstart)
+
+- With AI boosted conversations Power Virtual Agents bot your bot can have a higher ability to respond to the user by using a number of prompts or generating a response based on provided "fallback" website which you set. The "fallback" website can include internal documents or publicly available websites. More information: [AI-based boosted conversations overview (preview)](/power-virtual-agents/nlu-gpt-overview)
+
+
+You can design the Chabot control by giving it a name, change the size of the control window, and position it anywhere on the screen.
+
+> [!div class="mx-imgBorder"]
+> ![Sample Chabot control in a canvas app.](media/chatbot-control/ai-chatbot-control-1.png)
+
+
+> [!IMPORTANT]
+> - This capability is in gated preview, and you'll need to apply for consideration to take part in the trial. To apply, go to [Limited preview request](https://go.microsoft.com/fwlink/?linkid=2227838).
+> - Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
+> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
+> - This capability is powered by [ Azure OpenAI Service](/azure/cognitive-services/openai/overview).
+> - This capability is in process of rolling out, and may not be available in your region yet.
+> - This capability  may be subject to usage limits or capacity throttling.
+
+
+## Prerequisites 
+
+- Follow the prerequisites for AI features: [AI Copilot overview (preview)](ai-overview.md)
+- To add the Chatbot control, you need to create and publish a bot on the [Power Virtual Agents web app](/power-virtual-agents/fundamentals-what-is-power-virtual-agents-portal).  You can create any bot such as an AI bot or a new generative AI enriched Power Virtual Agents bot.
+
+
+## Bot schema name 
+
+You need the bot schema name to add it to the Chatbot control properties in Power Apps Studio. Following these steps to get the schema name.
+
+1. In Power Virtual Agents, open the bot you want to use. 
+2. In the navigation menu, go to **Settings** > **Details**. 
+3. Select the **Advanced** tab and note the **Schema name**.
+
+
+## Turn on the Chatbot control
+
+With your [canvas app open for editing](edit-app.md):
+
+1. On the command bar, select **Settings** > **Upcoming features**.
+2. From the **Preview** tab, set the toggle for **Chatbot component** to **On**.
+
+   > [!div class="mx-imgBorder"]
+   > ![Turn on Chatbot control.](media/chatbot-control/ai-chatbot-control-2.png)
+
+## Add a control with a bot
+
+With your [canvas app open for editing](edit-app.md):
+
+1. On the app authoring menu, select **Insert**.
+2. Expand the **Input** menu and then select **Chatbot (preview)**). Place the chatbot control where you want to add it on the screen. 
+
+   > [!div class="mx-imgBorder"]
+   > ![Add the Chatbot control.](media/chatbot-control/ai-chatbot-control-3.png)
+
+2. In the Chatbot properties pane, enter the Power Virtual Agents bot schema name in the **Schema Name** field.
+
+    You can change the name, the position, and size of the control.
+
+### Key properties 
+
+The following are the main properties for Chatbot control: 
+
+- **Schema name**:  The schema name property must be entered to connect your published Power Virtual Agents bot to your canvas app. For more information on how to get the Schema name, see [Prerequisites](add-ai-chatbot.md#prerequisites) section in this article.
+
+- **Header label**: This is the name of the bot that your end-user will see. If don't enter a header label, it will be **Chatbot**.
+
+  > [!div class="mx-imgBorder"]
+  > ![Add schema name.](media/chatbot-control/ai-chatbot-control-4.png)
+
+Use the other properties or move the control on the screen to set position and size of the control on the screen. 
+
+## Limitations
+
+- You can only embed a bot with no user authentication.
+
+## See also
+
+[Power Virtual Agents preview quickstart (preview)](/power-virtual-agents/preview/quickstart)
+
+[AI-based boosted conversations overview (preview)](/power-virtual-agents/nlu-gpt-overview)
+
+[Use the Copilot control](add-ai-copilot.md)
+
+
+[!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/maker/canvas-apps/add-ai-copilot.md

@@ -0,0 +1,98 @@
+---
+title: Add Copilot control to a canvas app
+description: Add copilot AI control to your canvas app.
+author: mduelae
+ms.topic: conceptual
+ms.custom: 
+  - canvas
+  - intro-internal
+ms.reviewer: 
+ms.date: 3/13/2023
+ms.subservice: canvas-maker
+ms.author: tapanm
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+contributors:
+  - mduelae
+---
+
+# Add the Copilot control to a canvas app (preview)
+
+[This article is prerelease documentation and is subject to change.]
+
+The Copilot control is a next-generation AI assistant that makers can add to their apps for end-users. This is an AI-powered experience for app users to get insights about the data in their apps through conversation in natural language. Makers can add this control to any app and choose what data it can answer questions about.
+
+> [!IMPORTANT]
+> - This capability is in gated preview, and you'll need to apply for consideration to take part in the trial. To apply, go to [Limited preview request](https://go.microsoft.com/fwlink/?linkid=2227838).
+> - Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
+> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
+> - This capability is powered by [ Azure OpenAI Service](/azure/cognitive-services/openai/overview).
+> - This capability is in process of rolling out, and may not be available in your region yet.
+> - This capability  may be subject to usage limits or capacity throttling.
+
+
+## Prerequisites
+
+- Follow the prerequisites for AI features: [AI Copilot overview (preview)](ai-overview.md).
+
+
+## Enable Copilot control for your app:
+
+With your [canvas app open for editing](edit-app.md):
+
+1. On the command bar, select **Settings** > **Upcoming features**.
+2. From the **Preview** tab, set the toggle for **Copilot component** to **On**.
+
+   > [!div class="mx-imgBorder"]
+   > ![Turn on Copilot control.](media/copilot/copilot-1.png)
+
+## Add the Copilot control
+
+With your [canvas app open for editing](edit-app.md):
+
+1. On the app authoring menu, select **Insert**.
+2. Expand the **Input** menu and select **Copilot (preview)** to add this control.
+
+   > [!div class="mx-imgBorder"]
+   > ![Add teh copilot control.](media/copilot/copilot-2.png)
+
+## Choose data
+
+1. When the Copilot control is added, select a data source from the pane. Note that at this time, only a single Dataverse table can be selected for the Copilot control.
+
+   > [!div class="mx-imgBorder"]
+   > ![Select a data source.](media/copilot/copilot-3.png)
+
+2. Alternatively, on the **Properties** tab of the right-hand pane, set **Data source (Items)** to the desired Dataverse table as your source of data.
+
+3. Select the specific **Fields** and/or **View** over which the Copilot control answer questions.
+
+   > [!div class="mx-imgBorder"]
+   > ![Select fields or views.](media/copilot/copilot-4.png)
+
+Due to current limitations, the Copilot control can answer questions over Dataverse tables that are smaller in size.
+
+## Configure the control (optional)
+
+In addition to choosing the data source, you can also configure the following properties:
+
+- **Title**: Replaces the control's default title of **Copilot**, and can be updated to something more descriptive of what this Copilot control can help app users with.
+
+- **Data summary**: Helps Copilot control give better responses to questions from app users. We recommend a brief 2-3 lines describing what the app is and what sort of questions this Copilot control will answer. This property does not impact the control's UI.
+
+- **Placeholder text**: Replaces the control's default placeholder text in the text input box **Ask a question about the data**. We recommend updating this to a short line sharing guidance to app users about what type of questions this Copilot control can answer.
+
+   > [!div class="mx-imgBorder"]
+   > ![Configure the control.](media/copilot/copilot-5.png)
+
+
+
+
+
+
+
+
+
+[!INCLUDE[footer-include](../../includes/footer-banner.md)]

powerapps-docs/maker/canvas-apps/ai-conversations-create-app.md

@@ -0,0 +1,97 @@
+---
+title: Build apps through conversation
+description: Build apps through conversation with AI.
+author: mduelae
+ms.topic: conceptual
+ms.custom: 
+  - canvas
+  - intro-internal
+ms.reviewer: 
+ms.date: 3/13/2022
+ms.subservice: canvas-maker
+ms.author: tapanm
+search.audienceType: 
+  - maker
+search.app: 
+  - PowerApps
+contributors:
+  - mduelae
+---
+
+# Build apps through conversation (preview)
+
+[This article is prerelease documentation and is subject to change.]
+
+Create Power Apps with the help of AI. Simply describe the app that you want to build, and AI will design it for you.
+
+With the **Copilot** feature in Power Apps you'll get in-app guidance using natural language processing to help you build your app.
+
+The AI assistant is available from the Power Apps Home screen. You can tell the AI assistant what kind of information you want to collect, track, or show and the assistant will generate a Dataverse table and use it to build your canvas app.
+
+> [!div class="mx-imgBorder"]
+> ![Tell the AI assistant the information you want to track in your app.](media/artificial-intelligence/create-app-using-ai-1.png)
+
+> [!IMPORTANT]
+> - This capability is in gated preview, and you'll need to apply for consideration to take part in the trial. To apply, go to [Limited preview request](https://go.microsoft.com/fwlink/?linkid=2227838).
+> - Preview features aren’t meant for production use and may have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback.
+> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
+> - This capability is powered by [ Azure OpenAI Service](/azure/cognitive-services/openai/overview).
+> - This capability is in process of rolling out, and may not be available in your region yet.
+> - This capability  may be subject to usage limits or capacity throttling.
+
+
+## Prerequisites
+
+Prerequisites for AI features: [AI Copilot overview (preview)](ai-overview.md)
+
+
+## Step 1: Create an app with the help of AI
+
+To help you get started, let's build an app to track housekeeping tasks for a hotel.
+
+1. Sign in to [Power Apps](https://make.powerapps.com).
+
+2. In the text box enter **hotel housekeeping**.
+
+   > [!div class="mx-imgBorder"]
+   > ![Describle your app.](media/artificial-intelligence/describe-your-app.png)
+
+3. A Dataverse table with data that includes typical hotel housekeeping tasks is created for you.
+
+## Step 2: Review the table for your app
+
+Based on what you described, AI will generate a table for your app. The following are actions you can take:
+
+1. **Suggestions**: These are suggested actions that you can ask the AI assistant to take to help you finalize the table.
+
+2. **View column**: Select to view the column name.
+
+3. **Edit table name**: View the table name and its properties.
+
+4. **Copilot**: Enter text to instruct the AI assistant on how to modify the table, such as remove room type column.
+
+5. **Create app or Cancel**: Select **Create app** to create an app based on the table or select **Cancel** to start over.
+
+   > [!div class="mx-imgBorder"]
+   > ![Review table for your app.](media/artificial-intelligence/table-created.png)
+
+## Step 3: Make edits
+
+If you want to make changes, use the **Copilot** panel to describe what you want to do, and it will make the change for you. Let's ask **Copilot** to add a column to track cleaning start and end time.
+
+1. In the **Copilot** text box enter, **Add columns to track start and end time**.
+
+   > [!div class="mx-imgBorder"]
+   > ![Enter text to tell Copilot how you want to edit the table.](media/artificial-intelligence/add-column.png)
+
+2. **Copilot** has added two new columns called, **Start Time** and **End Time**.
+
+   > [!div class="mx-imgBorder"]
+   > ![Example of columns that Copilot created.](media/artificial-intelligence/column-created.png)
+
+
+3. You can continue editing the table by adding features such as room status, change rooms, or set priority levels for each room. When you're ready to create your app, select **Create app**.
+
+ 
+
+[!INCLUDE[footer-include](../../includes/footer-banner.md)]