Edit

Share via

Embed a Power BI report with a Copilot narrative visual

  • Article

APPLIES TO: Power BI Desktop Power BI service

The narrative visual with Copilot is supported in "embed for your organization" scenarios where the user owns the data and in secure embed scenarios.

Scenarios

There are a few embedded scenarios. Only two are supported at this time. This chart makes it clear which scenarios are supported with the Copilot narrative visual.

Scenario Supported
Embed a report in a secure portal or website Power BI. Yes
User owns data A user embeds a report containing the narrative visual in a solution where users have to sign in. They need a license to sign in. This action is also known as embed for your organization. It includes when users want to embed visuals in solutions like PowerPoint as well. Yes: user must be signed in with a valid workspace.
App owns data A customer embeds a narrative visual on a website where users visit, and don't need to sign in. Also known as embed for your customer's application. No

Follow the instructions here to set up Power BI embed and begin embedding your content for your organization: Set up Power BI Embedded.

Why embed?

Embedding a Power BI report in an application in the "embed for your organization" scenario allows organizations to seamlessly integrate rich, interactive data visualizations directly into their internal tools and workflows, and now the Copilot visual is supported in this solution. This enhances data-driven decision-making by providing users with real-time insights within the context of the applications they already use. Additionally, it ensures secure data access and consistent user experience by leveraging existing organizational permissions and authentication mechanisms.

A sales team might want to embed a Power BI report in their internal CRM application to streamline their workflow. By integrating sales performance dashboards directly into the CRM, team members can easily monitor key metrics like monthly sales targets, pipeline status, and individual performance without switching between different tools. This integration enables quicker access to actionable insights, helping the team make informed decisions, identify trends, and react swiftly to market changes, all within the secure environment of their organization's data infrastructure.

Get started

Let's get started unlocking this scenario for your organization. To unlock this scenario, you must add a permission that authorizes your application to generate Copilot responses.

Navigate to the Azure portal (Microsoft Entra ID) and find the registered application. For more information on registering applications, see the documentation Set up Power BI Embedded. Microsoft Entra ID is where you can set up and manage the authentication for the embedded scenario. For more information, see the article Edit your Microsoft Entra app permission settings - Power BI.

Under API permissions in the left navigation, you can set up different permissions that users can access with this application.

Screenshot showing setting up API permissions.

Next steps

In the permission section on the right, select Add a permission.

Screenshot showing Select add permission.

Under APIs my organizations uses, find and select Power BI Service.

Screenshot showing Find and select Power BI service.

Select Delegated permissions.

Screenshot showing selecting delegated permissions.

After you select delegated permissions, search for ML model in the search bar and expand the ML model option that shows up. To enable the embed scenario for the narrative visual with Copilot, select the MLModel.Execute.All permission. Now the visual can show up in the embedded application for signed in users that meet all other Copilot requirements. See the Requirements section on the main Power BI Copilot documentation page. Add this permission to the registered application, and you have finished.

Keep in mind, as with other embed for your organization scenarios, end users are asked for consent for the application to use ML models upon using the application. For more information on user consent and delegated access, read this documentation, Overview of permissions and consent in the Microsoft identity platform.

Send feedback

We always welcome your feedback about our products. Especially during public preview, your feedback helps us improve the product faster.

Related content