Merge pull request #7882 from MicrosoftDocs/main

updating branch

Author: mduelae

powerapps-docs/cards/card-requirements.md

@@ -49,4 +49,4 @@ Cards has the same [system requirements as Power Apps](../limits-and-config.md)
 
 ## Supported platforms for sending cards
 
-Cards can be sent to [Microsoft Teams](/send-a-card/send-card-in-teams.md) in desktop, mobile, or web clients.
+Cards can be sent to [Microsoft Teams](send-a-card/send-card-in-teams.md) in desktop, mobile, or web clients.

powerapps-docs/developer/data-platform/org-service/overview.md

@@ -7,7 +7,6 @@ ms.author: dikamath
 ms.reviewer: pehecke
 ms.topic: overview
 ms.custom: bap-template
-ms.service: power-platform
 contributors:
  - JimDaly
  - phecke

powerapps-docs/docfx.json

@@ -50,10 +50,6 @@
       "feedback_system": "GitHub",
       "feedback_github_repo": "MicrosoftDocs/powerapps-docs",
       "feedback_product_url": "https://ideas.powerapps.com",
-      "search.appverid": "met150",
-      "search.app": [
-        "PowerApps"
-      ],
       "recommendations": true
     },
     "fileMetadata": {
@@ -78,7 +74,13 @@
         ]
       },
       "searchScope": {
-        "**.*": [ "Power Platform", "Power Apps" ]
+        "**.*": [
+          "Power Platform",
+          "Power Apps"
+        ]
+      },
+      "ms.topic": {
+        "developer/**/*.md": "overview"
       },
       "ms.service": {
         "**.*": "powerapps"
@@ -97,6 +99,31 @@
         "mobile/**/*.md": "mobile",
         "sample-apps/**/*.md": "sample-apps",
         "guidance/**/*.md": "guidance"
+      },
+      "search.app": {
+        "**.*": [
+          "PowerApps",
+          "powerapps-docs"
+        ],
+        "developer/data-platform/**/*.md": [
+          "PowerApps",
+          "powerapps-docs",
+          "dataverse-docs"
+        ],
+        "maker/data-platform/**/*.md": [
+          "PowerApps",
+          "powerapps-docs",
+          "dataverse-docs"
+        ],
+        "teams/**/*.md": [
+          "PowerApps",
+          "powerapps-docs",
+          "teams-docs"
+        ],
+        "maker/portals/**/*.md": [
+          "PowerApps",
+          "powerpages-docs"
+        ]
       }
     },
     "template": [],

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
@@ -642,7 +652,7 @@
             href: ./canvas-apps/working-with-flows.md
           - name: Add a flow (retired)
             href: ./canvas-apps/using-logic-flows.md
-        - name: Create a rule in canvas apps
+        - name: Convert rules to expressions
           href: ./canvas-apps/working-with-rules.md
         - name: Create or update bulk records
           href: ./canvas-apps/create-update-records-bulk.md
@@ -735,7 +745,7 @@
           - name: CountRows
             href: /power-platform/power-fx/reference/function-table-counts
           - name: Data types
-            href: /power-platform/power-fx/reference/data-types
+            href: /power-platform/power-fx/data-types
           - name: DataSourceInfo
             href: /power-platform/power-fx/reference/function-datasourceinfo
           - name: Date
@@ -1306,7 +1316,7 @@
           href: ./model-driven-apps/create-a-model-driven-app.md
         - name: Understanding app navigation
           href: ./model-driven-apps/app-navigation.md
-        - name: Work with pages (preview)
+        - name: Work with pages
           href: ./model-driven-apps/create-remove-pages.md
         - name: Manage app settings
           href: ./model-driven-apps/app-properties.md         

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 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)]