Skip to content

Commit dd59717

Browse files
committed
Updating quickstarts
1 parent d92b683 commit dd59717

10 files changed

+20
-20
lines changed

articles/search/knowledge-store-create-portal.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,13 @@ First, you set up sample data in Azure Storage. Next, you run the **Import data*
2323

2424
+ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/).
2525

26-
+ An Azure AI Search service. [Create a service](search-create-service-portal.md) or [find an existing service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices) in your account. For this quickstart, you can use a free service.
26+
+ An Azure AI Search service. [Create a service](search-create-service-portal.md) or [find an existing service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices) in your current subscription. For this quickstart, you can use a free service.
2727

2828
+ An Azure Storage account. [Create an account](/azure/storage/common/storage-account-create) or [find an existing account](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Storage%2storageAccounts/). The account type must be **StorageV2 (general purpose V2)**.
2929

3030
+ Sample data hosted in Azure Storage:
3131

32-
+ [Download HotelReviews_Free.csv](https://github.com/Azure-Samples/azure-search-sample-data/blob/main/hotelreviews/HotelReviews_data.csv). This CSV contains 19 pieces of customer feedback about a single hotel (originates from Kaggle.com). The file is in a repo with other sample data. If you don't want the whole repo, copy the raw content and paste it into a spreadsheet app on your device.
32+
+ [Download HotelReviews_Free.csv](https://github.com/Azure-Samples/azure-search-sample-data/blob/main/hotelreviews/HotelReviews_data.csv), which contains 19 pieces of customer feedback about a single hotel (originates from Kaggle.com). This CSV is in a repo with other sample data. If you don't want the whole repo, copy the raw content and paste it into a spreadsheet app on your device.
3333

3434
+ [Upload the file to a blob container](/azure/storage/blobs/storage-quickstart-blobs-portal) in Azure Storage.
3535

@@ -174,7 +174,7 @@ If you're using a free service, remember that you're limited to three indexes, i
174174
175175
## Next step
176176

177-
Now that you've been introduced to a knowledge store, take a closer look at each step by switching over to the REST API walkthrough. Tasks that the wizard handled internally are explained in the REST walkthrough.
177+
Now that you've been introduced to a knowledge store, take a closer look at each step by completing the REST API walkthrough. The walkthrough explains tasks that the wizard handled internally.
178178

179179
> [!div class="nextstepaction"]
180180
> [Create a knowledge store using REST](knowledge-store-create-rest.md)

articles/search/search-create-app-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Quickstart: Create a Demo Search App in the Azure Portal"
2+
title: "Quickstart: Create a Demo App in the Azure Portal"
33
titleSuffix: Azure AI Search
44
description: Run the Create demo app wizard to generate HTML pages and script for an operational web app. The page includes a search bar, results area, sidebar, and typeahead support.
55
manager: nitinme

articles/search/search-explorer.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,13 +19,13 @@ In this quickstart, you learn how to use **Search explorer**, a built-in query t
1919
This quickstart uses an existing index to demonstrate Search explorer.
2020

2121
> [!TIP]
22-
> Search explorer now supports image search. To learn more, see[Quickstart: Image search in the Azure portal](search-get-started-portal-image-search.md).
22+
> Search explorer now supports image search. To learn more, see [Quickstart: Image search in the Azure portal](search-get-started-portal-image-search.md).
2323
2424
## Prerequisites
2525

2626
+ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/).
2727

28-
+ An Azure AI Search service. [Create a service](search-create-service-portal.md) or [find an existing service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices) in your current subscription. For this quickstart, you can use a free servic.
28+
+ An Azure AI Search service. [Create a service](search-create-service-portal.md) or [find an existing service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices) in your current subscription. For this quickstart, you can use a free service.
2929

3030
+ This quickstart uses the realestate-us-sample index. To create the index, run the [**Import data wizard**](search-import-data-portal.md), select the built-in sample data, and step through the wizard using all the default values.
3131

@@ -52,7 +52,7 @@ There are two approaches for querying in Search explorer.
5252
+ JSON view supports parameterized queries. Filters, orderby, select, count, searchFields, and all other parameters must be set in JSON view.
5353

5454
> [!TIP]
55-
> JSON view provides intellisense for parameter name completion. Place the cursor inside the JSON view and type a space character to show a list of all query parameters, or type a single letter like "s" to show just the query parameters starting with "s". Intellisense doesn't exclude invalid parameters so use your best judgment.
55+
> JSON view provides intellisense for parameter name completion. Place your cursor inside the JSON view and type a space character to see a list of all query parameters. You can also type a letter, like "s," to see only the query parameters that begin with that letter. Intellisense doesn't exclude invalid parameters, so use your best judgment.
5656
5757
Switch to **JSON view** for parameterized queries. The examples in this article assume JSON view throughout. You can paste JSON examples from this article into the text area.
5858

@@ -191,7 +191,7 @@ In this quickstart, you used **Search explorer** to query an index using the RES
191191

192192
+ Search results are composed of all fields marked as "retrievable" in the index. Select the adjacent **Fields** tab to review attributes.
193193

194-
+ Keyword search, similar to what you might enter in a commercial web browser, are useful for testing an end-user experience. For example, assuming the built-in real estate sample index, you could enter "Seattle apartments lake washington", and then you can use Ctrl-F to find terms within the search results.
194+
+ Keyword search, similar to what you might enter in a commercial web browser, are useful for testing an end-user experience. For example, assuming the built-in real estate sample index, you could enter "Seattle apartments lake washington," and then you can use Ctrl-F to find terms within the search results.
195195

196196
+ Query and filter expressions are articulated in a syntax implemented by Azure AI Search. The default is a [simple syntax](/rest/api/searchservice/simple-query-syntax-in-azure-search), but you can optionally use [full Lucene](/rest/api/searchservice/lucene-query-syntax-in-azure-search) for more powerful queries. [Filter expressions](/rest/api/searchservice/odata-expression-syntax-for-azure-search) are articulated in an OData syntax.
197197

@@ -208,4 +208,4 @@ If you're using a free service, remember that you're limited to three indexes, i
208208
To learn more about query structures and syntax, use a REST client to create query expressions that use more parts of the API. The [Search POST REST API](/rest/api/searchservice/documents/search-post?view=rest-searchservice-2024-05-01-preview&preserve-view=true) is especially helpful for learning and exploration.
209209

210210
> [!div class="nextstepaction"]
211-
> [Create a basic query in REST](search-get-started-rest.md)
211+
> [Quickstart: Create a basic query in REST](search-get-started-rest.md)

articles/search/search-get-started-arm.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,14 +47,14 @@ Select the following image to sign in to Azure and open a template. The template
4747

4848
:::image type="content" source="~/reusable-content/ce-skilling/azure/media/template-deployments/deploy-to-azure-button.svg" alt-text="Button to deploy the Resource Manager template to Azure." border="false" link="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fazure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.search%2Fazure-search-create%2Fazuredeploy.json":::
4949

50-
the Azure portal displays a form that allows you to easily provide parameter values. Some parameters are pre-filled with the default values from the template. You will need to provide your subscription, resource group, location, and service name. If you want to use Azure AI services in an [AI enrichment](cognitive-search-concept-intro.md) pipeline, for example to analyze binary image files for text, choose a location that offers both Azure AI Search and Azure AI services. Both services are required to be in the same region for AI enrichment workloads. Once you have completed the form, you will need to agree to the terms and conditions and then select the purchase button to complete your deployment.
50+
The Azure portal displays a form that allows you to easily provide parameter values. Some parameters are prefilled with the default values from the template. Provide your subscription, resource group, location, and service name. If you want to use Azure AI services in an [AI enrichment](cognitive-search-concept-intro.md) pipeline, for example to analyze binary image files for text, choose a location that offers both Azure AI Search and Azure AI services. Both services are required to be in the same region for AI enrichment workloads. After you complete the form, agree to the terms and conditions and then select the purchase button to complete your deployment.
5151

5252
> [!div class="mx-imgBorder"]
5353
> ![Azure portal display of template](./media/search-get-started-arm/arm-portalscrnsht.png)
5454
5555
## Review deployed resources
5656

57-
When your deployment is complete you can access your new resource group and new search service in the Azure portal.
57+
When your deployment is complete, you can access your new resource group and new search service in the Azure portal.
5858

5959
## Clean up resources
6060

articles/search/search-get-started-portal-import-vectors.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Quickstart: Vectorize Text and Images in the Azure Portal"
2+
title: "Quickstart: Vectorize Content in the Azure Portal"
33
titleSuffix: Azure AI Search
44
description: Learn how to use a wizard to automate data chunking and vectorization in a search index.
55
author: haileytap
@@ -104,7 +104,7 @@ This section points you to the content that works for this quickstart.
104104

105105
1. If you're using [native soft delete](search-howto-index-changed-deleted-blobs.md#native-blob-soft-delete), no further steps are required on Azure Storage.
106106

107-
1. Otherwise, [add custom metadata](search-howto-index-changed-deleted-blobs.md#soft-delete-strategy-using-custom-metadata) that an indexer can scan to determine which blobs are marked for deletion. Give your custom property a descriptive name. For example, you could name the property "IsDeleted", set to false. Do this for every blob in the container. Later, when you want to delete the blob, change the property to true. For more information, see [Change and delete detection when indexing from Azure Storage](search-howto-index-changed-deleted-blobs.md)
107+
1. Otherwise, [add custom metadata](search-howto-index-changed-deleted-blobs.md#soft-delete-strategy-using-custom-metadata) that an indexer can scan to determine which blobs are marked for deletion. Give your custom property a descriptive name. For example, you could name the property "IsDeleted", set to false. Do this for every blob in the container. Later, when you want to delete the blob, change the property to true. For more information, see [Change and delete detection when indexing from Azure Storage](search-howto-index-changed-deleted-blobs.md).
108108

109109
### [ADLS Gen2](#tab/sample-data-adlsgen2)
110110

articles/search/search-get-started-portal.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Quickstart: Create a Search Index in the Azure Portal"
2+
title: "Quickstart: Create an Index in the Azure Portal"
33
titleSuffix: Azure AI Search
44
description: Learn how to create, load, and query your first search index using the Import Data wizard in the Azure portal. This quickstart uses a fictitious hotel dataset for sample data.
55
manager: nitinme
@@ -265,4 +265,4 @@ In the Azure portal, you can find and manage resources for your service under **
265265
Try an Azure portal wizard to generate a ready-to-use web app that runs in a browser. Use this wizard on the small index you created in this quickstart, or use one of the built-in sample datasets for a richer search experience.
266266

267267
> [!div class="nextstepaction"]
268-
> [Create a demo app in the Azure portal](search-create-app-portal.md)
268+
> [Quickstart: Create a demo search app in the Azure portal](search-create-app-portal.md)

articles/search/search-get-started-powershell.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: 'Quickstart: Create a Search Index in PowerShell Using REST APIs'
2+
title: 'Quickstart: Create a Search Index Using PowerShell and REST APIs'
33
titleSuffix: Azure AI Search
44
description: Learn how to create an index, load data, and run queries using PowerShell's Invoke-RestMethod and the Azure AI Search REST APIs.
55
manager: nitinme

articles/search/search-get-started-rag.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: 'Quickstart: RAG'
2+
title: 'Quickstart: Generative Search (RAG)'
33
titleSuffix: Azure AI Search
44
description: Learn how to use grounding data from Azure AI Search with a chat model on Azure OpenAI.
55
author: haileytap

articles/search/search-get-started-rbac.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.topic: quickstart
99
ms.date: 03/04/2025
1010
---
1111

12-
# Quickstart: Connect to Azure AI Search without keys
12+
# Quickstart: Connect without keys
1313

1414
In this quickstart, you configure Azure AI Search to use Microsoft Entra ID authentication and role-based access control (RBAC) to connect from your local system without API keys. You then use Jupyter notebooks or a REST client to interact with your search service.
1515

articles/search/search-get-started-semantic.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,9 +63,9 @@ When you're working in your own subscription, it's a good idea at the end of a p
6363

6464
You can find and manage resources in the Azure portal, using the **All resources** or **Resource groups** link in the left-navigation pane.
6565

66-
## Next steps
66+
## Next step
6767

68-
In this quickstart, you learned how to invoke semantic ranking on an existing index. We recommend trying semantic ranking on your own indexes as a next step. However, if you want to continue with demos, visit the following link.
68+
In this quickstart, you learned how to invoke semantic ranking on an existing index. We recommend trying semantic ranking on your own indexes as a next step. However, if you want to continue with demos, try the following tutorial:
6969

7070
> [!div class="nextstepaction"]
7171
> [Tutorial: Add search to web apps](tutorial-csharp-overview.md)

0 commit comments

Comments
 (0)