Merge pull request #10193 from MicrosoftDocs/20230603-updates-for-reasons-and-limits

update for reasons and limits

Author: sericks007

powerapps-docs/user/smartGrid.md

@@ -1,7 +1,7 @@
 ---
 title: Filter, sort, and search galleries with Copilot (preview)
-description: Learn how to use Copilot to quickly sort, filter, and search canvas app galleries using natural language.
-ms.date: 05/16/2024
+description: Learn how to use Copilot to quickly filter, sort, and search canvas app galleries using natural language.
+ms.date: 06/04/2024
 ms.topic: article
 ms.component: pa-user
 ms.subservice: end-user
@@ -10,40 +10,56 @@ ms.author: jordanchodak
 ms.reviewer: sericks
 search.audienceType: 
   - enduser
+contributors:
+- lancedMicrosoft
 ---
 
 
 # Filter, sort, and search galleries with Copilot (preview)
 
 [This article is prerelease documentation and is subject to change.]
 
-You can use Copilot to quickly sort, filter, and search the items in canvas app galleries. Using Copilot saves time because you won’t have to worry about scrolling through the gallery to find the items you need.  
+You can use Copilot to quickly filter, sort, and search the items in canvas app galleries. Copilot uses a natural language expression to generate a query to the database that scopes the current view of records in a gallery or grid so users can quickly find the records they need. 
 
-When trying to quickly find the gallery items you need, you might worry about spending time scrolling without success. With the assistance of Copilot, you can quickly use natural language to sort, filter, and search the gallery to find the items you need.
+Filter, sort, and search galleries with Copilot supports three key kinds of commands: 
+
+- Filter the list of records to a specific set with complex criteria. This list includes _and_ and _or_ statements and relational operators such as _equal_, _greater than_, and more).
+- Sort the list of records, such as in ascending or descending order.
+- Search for a specific set of records using _starts with_ text. 
+
+Copilot doesn't support aggregate queries, for example, _top_, _min_, _max_, _sum_, and _average_, as these answers can't be shown as a list of records. 
+
+Filter, sort, and search galleries with Copilot provides five key benefits:
+
+- Copilot enables natural language commands. Users can express commands (filter, sort, and search) in natural language. The prompt user interface (UI) helps users formulate sentences by showing different examples of natural language sentences that work. 
+- Copilot enables queries over the full query result. Users can filter, sort, and search on fields even if the application doesn't provide UI controls for these tasks. For example, you can search for records even if the application doesn't have a search bar.  
+- Copilot saves development time. Authors save time developing apps because they don't need to develop all the UI controls necessary for the app. Instead, they can rely on Copilot for this functionality. 
+- Copilot is query safe. It only generates queries that can be run on the server. Authors don't need to worry about whether or not their queries can be delegated. 
+- Copilot keeps private data private. It only works with the data that is normally returned to the application. It doesn't access fields that aren't returned to the app in a gallery/grid or form.
 
 > [!IMPORTANT]
-> - This feature is not yet available and is expected to begin rollout as on-by-default in early June.  However, if you turn the feature off before the release, the feature should be turned off when it rolls out to you.
+> - This feature is not yet available and is expected to begin rollout as on-by-default in late June.  However, if you turn the feature off before the release, the feature should be turned off when it rolls out to you.
 > - To use this feature, your environment must be in a region with GPU (graphics processing unit) capacity, or your tenant must have the **Move data across regions** checkbox selected.  Learn more: [Turn on copilots and generative AI features](/power-platform/admin/geographical-availability-copilot)
 > - To use this feature, the browser language must be US English.
 > - This capability is powered by [Azure OpenAI Service](/azure/cognitive-services/openai/overview).
 > - This capability may be subject to usage limits or capacity throttling.
 > - Copilot isn't supported and won't work for environments that have customer-managed key (CMK) or have lockbox.
 > - 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.
-> - This feature is designed for galleries that use SharePoint as their sole data source. More data sources will be added to have this capability in the future.
+> - This feature is designed for galleries that use SharePoint as their sole data source. More data sources will be added to have this capability in the future. SharePoint effectively only supports filter, sort, and search. When this feature is extended to other data sources, this feature will still only support filter, sort, and search.
 > - For more information about the preview, go to our [preview terms](https://go.microsoft.com/fwlink/?linkid=2189520).
 
 ## Use this feature
 
 1. Select an item in the gallery. 
 2. The option to **Sort, filter, and search with Copilot** should appear. Select that option. 
-3. Write your desired sort, filter, or search query into the text box or select one of the suggested queries.  
+3. Write your desired filter, sort, or search query into the text box or select one of the suggested queries.  
      > [!Note] 
      > You must enter the text in English. This feature only supports the English language at this time. 
 4. Select the **Send** icon. 
 5. Copilot updates the gallery for you. Review the filters applied. The following options are available: 
     - If you want to remove any filters you have applied, select the **x** on the tag displaying the filter you want to remove. 
     - To clear all applied filters, select the trash icon button. 
-    - If you are satisfied with the filters that are applied to the gallery, select **Keep it**.  You can always go back and remove or add more filters. 
+    - If you're satisfied with the filters that are applied to the gallery, select **Keep it**.  You can always go back and remove or add more filters. 
 
 ## Turn off gallery filtering in web player
 
@@ -57,7 +73,7 @@ You can turn off gallery filtering for an app or an environment using a PowerShe
 
 ### Turn off gallery filtering for an app
 
-You can use a PowerShell cmdlet to turn this setting off for an app.
+You can use a PowerShell cmdlet to turn off this setting for an app.
 
 To turn off for an app using PowerShell: