Copilot is available in apps two ways:

• A report-scoped Copilot that can help users with summaries of the report in view or answer questions based on that report in view
• An app-scoped Copilot (preview) that can help users find items in the app based on their interests, summarize an item in the app, or answer questions based on items in the app.

Report-scoped Copilot in apps

Report Copilot is available in workspace apps and org apps (the new version of apps in preview). Report Copilot, when opened, is scoped to the report in view only. SeeCopilot for Power BI reports for information on how report Copilot works.

App-scoped Copilot (preview)

App-scoped Copilot is available in workspace apps. Copilot for apps is similar to standalone Copilot for Power BI. While standalone Copilot is scoped to all Copilot-supported items types a user has access to in Power BI, app-scoped Copilot scoped to only the Copilot-supported item types in the app. Seestandalone Copilot for Power BI for information on how standalone Copilot works. Continue to read this article for more information on how app-scoped Copilot works similarly for an app.

Item types supported by app-scoped Copilot (preview)

App-scoped Copilot supports the following item types included in an app:

• Power BI reports
• Semantic models

There are item types support by apps that app-scoped Copilot doesn't support:

• Paginated reports
• Dashboards
• Workbooks
• Linked content, including link-embedded Power BI items such as reports.

How to use app-scoped Copilot (preview)

App-scoped Copilot is available in tenants where Copilot is enabled and the app author enabled app-scoped Copilot and visible in the app navigation.

To open app-scoped Copilot, click Copilot in the app navigation:

If the app author chose for the app navigation to be collapsed by default, users need to expand the app navigation to view the app navigation and see Copilot:

App users Copilot activity must be linked to a capacity. Learn more about thegeneral requirements for Copilot use and howcapacity assignment and autoselection works.

Find items in the app

You can ask Copilot to find reports you have access to in the app. In response, you get a hyperlinked list of relevant items, with helpful details to make it easy for you to find the right thing. Learn more aboutsearching for items Selecting an item listed in the results opens that item in a new tab within the app.

Summarize an item in the app

Copilot can provide summaries about an entire report or a specific topic within that report. You can use prompts like:

• "Give me a summary about customer sentiment on smart materials."
• "Summarize trends in sales last year."

Summaries in the app-scoped Copilot experience include both textual insights and relevant visuals within the narrative. Currently, summaries are only available for reports, not for semantic models. Learn more aboutsummarizing a report or topic.

Asks questions and get answers based on an item in the app

The app-scoped Copilot experience can summarize data from reports and use the report visuals to answer specific questions. If the answer can't be found in the report, Copilot defaults to using the semantic model to generate rich answers for users.Learn more aboutasking questions about your data.

Attach an item from the app to summarize or ask questions

At times, you may want to ask questions about your data based on a specific item. In app-scoped Copilot, you can attach a specific report for Copilot to reference.

If you know exactly which report, attach it to your chat using theAdd content for Copilot to reference option.

Then it appears in the Copilot conversation and is used to answer your questions.

Clear chat

The "clear chat" button removes the contents of the current conversation and any previous context set throughout the conversation. Clearing the chat is essentially the same as starting a new chat. Chats are also cleared when navigating away from app-scoped Copilot.

See more howclear chat works for Copilot in Power BI.

Share feedback

User feedback is important for continued Copilot improvements. After each Copilot response, users can provide feedback on the response by selecting the feedback buttons corresponding with their sentiment.

Limitations and considerations for app users

• In select cases app-scoped Copilot uses item names that app authors configure. The original item name may differ from the name shown in the app and used in app-scoped Copilot responses.
• Clicking an item link opens the item in a new browser tab.
• Clicking a citation link opens the item in a new browser tab outside the app.
• Conversations are cleared when navigating away from or closing Copilot in apps.
• App-scoped Copilot and report-scoped Copilot in apps are separate functionality. Prompts and responses in each Copilot may differ and aren't shared between each Copilot.
• App-scoped Copilot is available for workspace apps only, not org apps (preview).
• Report-scoped Copilot in apps is available in both workspace apps and org apps (preview).

Limitations and considerations for app authors

• Items in apps are versioned upon app update. Copilot uses the version of the item in the app. Update the app to ensure Copilot is reasoning over the latest changes to items in the app.
• Verified answers are supported in Copilot for apps. To ensure verified answers are available to app users, update the app after verified answers are configured.
• Copilot only uses items in the app users have access to. Copilot doesn't use items a user doesn't have access to. For example: If a report is built on a semantic model in a workspace not associated with the app, the app doesn't manage user access for that semantic model. Manage user access on the semantic model separately so Copilot can use that item.

Learn more aboutpublishing and updating apps for more considerations and limitations.