|
| 1 | +--- |
| 2 | +title: Add a custom Copilot to a canvas app |
| 3 | +description: "Add a custom Copilot to a canvas app in Microsoft Power Apps." |
| 4 | +author: mduelae |
| 5 | +ms.topic: conceptual |
| 6 | +ms.custom: canvas |
| 7 | +ms.reviewer: |
| 8 | +ms.date: 7/8/2024 |
| 9 | +ms.subservice: canvas-maker |
| 10 | +ms.author: mkaur |
| 11 | +search.audienceType: |
| 12 | + - maker |
| 13 | +contributors: |
| 14 | + - mduelae |
| 15 | +--- |
| 16 | + |
| 17 | +# Add a custom Copilot to a canvas app (preview) |
| 18 | + |
| 19 | +[This article is prerelease documentation and is subject to change.] |
| 20 | + |
| 21 | +Microsoft Copilot Studio empowers makers to create their own custom Copilots with AI. In a few steps, you can add your custom Copilot across all your canvas app screens without modifying your app's design. You can use this feature both on the web and through the Power Apps mobile app. |
| 22 | + |
| 23 | +> [!IMPORTANT] |
| 24 | +> - App Copilot for canvas apps is currently rolling out and might not yet be available in your region. App Copilot may be available on [Power Apps mobile](../../mobile/run-powerapps-on-mobile.md) for mobile devices before it becomes available on the web browser during rollout. |
| 25 | +> - You must allow data movement across regions, for generative AI features, as a prerequisite to use copilots in Power Apps. This step is important if your organization and your environment are in different regions. For more information, see [Enable copilots and generative AI features](/power-platform/admin/geographical-availability-copilot\#enable-data-movement-across-regions). |
| 26 | +> - Preview features aren't meant for production use and might have restricted functionality. These features are available before an official release so that customers can get early access and provide feedback. |
| 27 | +> - For more information, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520). |
| 28 | +
|
| 29 | +## What is the difference between App Copilot in canvas apps and the Copilot control? |
| 30 | + |
| 31 | +**Copilot control** requires makers to update their canvas app to make space for the control and is only available on the web. The control feature supports asking questions about your data or connecting to a new (not existing) custom copilot from Copilot Studio. |
| 32 | + |
| 33 | +**App Copilot** doesn't require updating the canvas app layout. App Copilot is available across web and natively on mobile devices and can connect to pre-existing custom Copilots created in Copilot Studio. |
| 34 | + |
| 35 | +## How to enable App Copilot |
| 36 | + |
| 37 | +### Prerequisites |
| 38 | + |
| 39 | +- Create a custom Copilot in [Copilot Studio](/microsoft-copilot-studio/fundamentals-get-started?tabs=web) and publish it in the same environment as the app. |
| 40 | + |
| 41 | +- Configure the custom Copilot with [user authentication in Microsoft Entra ID](/microsoft-copilot-studio/configuration-authentication-azure-ad). |
| 42 | + |
| 43 | +- [Give makers and users access](/microsoft-copilot-studio/admin-share-bots?tabs=web) to the custom Copilot within the environment. |
| 44 | + |
| 45 | +## Connect your custom Copilot to your canvas app |
| 46 | + |
| 47 | + |
| 48 | +Open your [canvas app open for editing](edit-app.md) in Power Apps Studio: |
| 49 | + |
| 50 | +1. On the command bar, select **Settings** > **Updates** > **Preview** tab and enable **Copilot from app settings**. |
| 51 | + |
| 52 | +1. You see a **Copilot** tab appear in **Settings**. In the drop-down list, select a custom Copilot that is published and shared in the same environment as your canvas app. |
| 53 | + |
| 54 | + :::image type="content" source="media/add-custom-copilot/copilot-tab.png" alt-text="Screenshot that shows the Copilot tab in Settings and where you can select an app that was shared with you." lightbox="media/add-custom-copilot/copilot-tab.png"::: |
| 55 | + |
| 56 | +1. After choosing a copilot, close the settings dialog box and publish the app. App users are able to use App Copilot in the app. |
| 57 | + |
| 58 | +When previewing an app in Power Apps Studio, Copilot is not displayed. To see Copilot in action, you need to save and publish your app, and then open it in Power Apps mobile or the web browser. |
| 59 | + |
| 60 | +> [!TIP] |
| 61 | +> Removing the custom Copilot from the app disables the functionality. |
| 62 | +
|
| 63 | +## Use App Copilot |
| 64 | + |
| 65 | +- Open your canvas app in a web browser. On the command bar, select **Copilot**. |
| 66 | + |
| 67 | + :::image type="content" source="media/add-custom-copilot/copilot-chat-in-app.png" alt-text="Screenshot that shows the Copilot chat in the app." lightbox="media/add-custom-copilot/copilot-chat-in-app.png"::: |
| 68 | + |
| 69 | +- In Power Apps mobile running on iOS or Android devices, select the floating button to access App Copilot. You can move the button around or dismiss it. To use App Copilot after dismissing it, close and reopen the app. |
| 70 | + |
| 71 | +## See Also |
| 72 | + |
| 73 | +[FAQ for Copilot](/microsoft-copilot-studio/faqs-copilot) |
0 commit comments