> ## Documentation Index
> Fetch the complete documentation index at: https://docs.curator.interworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enabling Copilot

> Enable the Power BI Copilot AI assistant pane in embedded reports for natural-language data analysis within Curator.

export const BackendNavPath = ({levelOne, levelTwo, levelThree, tab, section}) => {
  const levels = [levelOne, levelTwo, levelThree].filter(Boolean);
  const lastLevel = levels.length ? levels[levels.length - 1] : '';
  return <span>
      In the <a href="/setup/installation/linux_installation">backend of Curator</a> using the left-hand navigation,
      navigate to the
      {levelOne && <strong>{" " + levelOne}</strong>}
      {levelOne && levelTwo && " > "}
      {levelTwo && <strong>{levelTwo}</strong>}
      {levelTwo && levelThree && " > "}
      {levelThree && <strong>{levelThree}</strong>} page.
      {(tab || section) && <>
          {" "}On the {lastLevel} page
          {tab && <> click the <strong>{tab}</strong> tab</>}
          {tab && section && " and"}
          {section && <> expand the <strong>{section}</strong> section</>}.
        </>}
    </span>;
};

Copilot is Microsoft's AI assistant for Power BI, enabling users to explore and analyze report data using
natural-language prompts. It is currently the only built-in AI feature available in Curator, and it requires
either Power BI Premium or paid Fabric capacity in your workspace. Curator supports displaying the Copilot pane
within embedded reports, allowing users to interact with Copilot directly from your portal.

## Requirements

Before enabling Copilot in Curator, ensure the following requirements are met in your Power BI environment:

1. **Copilot is available in your Power BI tenant.** This feature requires an active Copilot tenant switch and either
   Power BI Premium or paid Fabric capacity in your workspace. If you can see the Copilot button in the action bar when
   viewing the report in the Power BI service, then your tenant meets this requirement.

2. **The `MLModel.Execute.All` permission is added to your Azure AD app registration.** This permission allows the
   embedded report to communicate with the Copilot service. See the
   [Azure App Setup - API Permissions](https://docs.curator.interworks.com/creating_integrations/power_bi_connection/azure_app_setup#api-permissions)
   guide for instructions on adding API permissions to your app registration.

## Enabling Copilot on a Report

Once the requirements above are met, follow these steps to enable Copilot on a report in Curator:

1. <BackendNavPath levelOne="Power BI" levelTwo="Reports" />
2. Click on the report you want to enable Copilot for, or create a new report.
3. On the Report tab, toggle **Enable Copilot** to on.

<Note>
  Enabling Copilot will automatically enable the action bar, as the Copilot pane is accessed through it. While Copilot
  is enabled, the action bar cannot be independently disabled.
</Note>

1. Click **Save**.

Users will now see the Copilot button in the action bar when viewing this report in Curator.