Merge pull request #191844 from ssalgadodev/searchportal

Updates to add search bar in portal

Author: v-regandowner

articles/machine-learning/how-to-manage-workspace.md

@@ -330,6 +330,50 @@ The Workspace.list(..) method does not return the full workspace object. It incl
 
 ---
 
+## Search for assets across a workspace (preview)
+
+With the public preview search capability, you can search for machine learning assets such as jobs, models, components, environments, and datasets across all workspaces, resource groups, and subscriptions in your organization through a unified global view.
+
+### Free text search
+
+Type search text into the global search bar on the top of portal and hit enter to trigger a 'contains' search.
+A contains search scans across all metadata fields for the given asset and sorts results relevance.
+
+You can use the asset quick links to navigate to search results for jobs, models, and components that you created.
+
+Also,  you can change the scope of applicable subscriptions and workspaces via the 'Change' link in the search bar drop down.
+
+:::image type="content" source="./media/how-to-manage-workspace/search-bar.png" alt-text="Search-bar list":::
+
+### Structured search
+
+Select any number of filters to create more specific search queries. The following filters are supported:
+
+* Job:
+* Model:
+* Component:
+* Tags:
+* SubmittedBy:
+* Environment:
+* Dataset:
+
+If an asset filter (job, model, component) is present, results are scoped to those tabs. Other filters apply to all assets unless an asset filter is also present in the query. Similarly, free text search can be provided alongside filters, but are scoped to the tabs chosen by asset filters, if present.
+
+> [!TIP]
+> * Filters search for exact matches of text. Use free text queries for a contains search.
+> * Quotations are required around values that include spaces or other special characters.  
+> * If duplicate filters are provided, only the first will be recognized in search results.
+> * Input text of any language is supported but filter strings must match the provided options (ex. submittedBy:).
+> * The tags filter can accept multiple key:value pairs separated by a comma (ex. tags:"key1:value1, key2:value2").
+
+### View search results
+
+You can view your search results in the individual **Jobs**, **Models** and **Components** tabs. Select an asset to open its **Details** page in the context of the relevant workspace. Results from workspaces you don't have permissions to view are not displayed.
+
+:::image type="content" source="./media/how-to-manage-workspace/results.png" alt-text="Results displayed after search":::
+
+If you've used this feature in a previous update, a search result error may occur. Reselect your preferred workspaces in the Directory + Subscription + Workspace tab.
+
 
 ## Delete a workspace