Skip to content

Commit 8a2d574

Browse files
committed
fix 2
1 parent ab9a44c commit 8a2d574

File tree

3 files changed

+24
-35
lines changed

3 files changed

+24
-35
lines changed

articles/search/includes/quickstarts/search-get-started-rag-javascript.md

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -14,15 +14,15 @@ ms.date: 06/05/2025
1414
- [Choose a region](/azure/ai-services/openai/concepts/models?tabs=global-standard%2Cstandard-chat-completions#global-standard-model-availability) that supports the chat completion model you want to use (gpt-4o, gpt-4o-mini, or an equivalent model).
1515
- [Deploy the chat completion model](/azure/ai-foundry/how-to/deploy-models-openai) in Azure AI Foundry or [use another approach](/azure/ai-services/openai/how-to/working-with-models).
1616

17-
- An [Azure AI Search resource](../search-create-service-portal.md).
17+
- An [Azure AI Search resource](../../search-create-service-portal.md).
1818
- Use the same region as your Azure OpenAI resource.
1919
- We recommend using the Basic tier or higher.
20-
- [Enable semantic ranking](../semantic-how-to-enable-disable.md).
20+
- [Enable semantic ranking](../../semantic-how-to-enable-disable.md).
2121

2222
- [Visual Studio Code](https://code.visualstudio.com/download).
2323
- [Node.JS with LTS](https://nodejs.org/en/download/).
2424

25-
To meet the same-region requirement, start by reviewing the [regions for the chat model](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) you want to use. After you identify a region, confirm that Azure AI Search is available in the [same region](../search-region-support.md#azure-public-regions).
25+
To meet the same-region requirement, start by reviewing the [regions for the chat model](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) you want to use. After you identify a region, confirm that Azure AI Search is available in the [same region](../../search-region-support.md#azure-public-regions).
2626

2727
## Configure access
2828

@@ -63,7 +63,7 @@ A search index provides grounding data for the chat model. We recommend the hote
6363

6464
1. In the Azure portal, [find your search service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices).
6565

66-
1. On the **Overview** home page, select [**Import data**](../search-get-started-portal.md) to start the wizard.
66+
1. On the **Overview** home page, select [**Import data**](../../search-get-started-portal.md) to start the wizard.
6767

6868
1. On the **Connect to your data** page, select **Samples** from the dropdown list.
6969

@@ -118,9 +118,9 @@ A search index provides grounding data for the chat model. We recommend the hote
118118

119119
1. **Save** your changes.
120120

121-
1. Run the following query in [Search Explorer](../search-explorer.md) to test your index: `complimentary breakfast`.
121+
1. Run the following query in [Search Explorer](../../search-explorer.md) to test your index: `complimentary breakfast`.
122122

123-
Output should look similar to the following example. Results that are returned directly from the search engine consist of fields and their verbatim values, along with metadata like a search score and a semantic ranking score and caption if you use semantic ranker. We used a [select statement](../search-query-odata-select.md) to return just the HotelName, Description, and Tags fields.
123+
Output should look similar to the following example. Results that are returned directly from the search engine consist of fields and their verbatim values, along with metadata like a search score and a semantic ranking score and caption if you use semantic ranker. We used a [select statement](../../search-query-odata-select.md) to return just the HotelName, Description, and Tags fields.
124124

125125
```
126126
{
@@ -197,7 +197,7 @@ In the remaining sections, you set up API calls to Azure OpenAI and Azure AI Sea
197197
1. On the **Overview** home page, select the link to view the endpoints. Copy the URL. An example endpoint might look like `https://example.openai.azure.com/`.
198198
199199
200-
You're using Microsoft Entra ID and role assignments for the connection. Make sure you're logged in to the same tenant and subscription as Azure AI Search and Azure OpenAI. You can use the Azure CLI on the command line to show current properties, change properties, and to sign in. For more information, see [Connect without keys](../search-get-started-rbac.md).
200+
You're using Microsoft Entra ID and role assignments for the connection. Make sure you're logged in to the same tenant and subscription as Azure AI Search and Azure OpenAI. You can use the Azure CLI on the command line to show current properties, change properties, and to sign in. For more information, see [Connect without keys](../../search-get-started-rbac.md).
201201
202202
Run each of the following commands in sequence.
203203
@@ -401,7 +401,7 @@ You might also try the query without semantic ranking by setting `use_semantic_r
401401
402402
## Send a complex RAG query
403403
404-
Azure AI Search supports [complex types](../search-howto-complex-data-types.md) for nested JSON structures. In the hotels-sample-index, `Address` is an example of a complex type, consisting of `Address.StreetAddress`, `Address.City`, `Address.StateProvince`, `Address.PostalCode`, and `Address.Country`. The index also has complex collection of `Rooms` for each hotel.
404+
Azure AI Search supports [complex types](../../search-howto-complex-data-types.md) for nested JSON structures. In the hotels-sample-index, `Address` is an example of a complex type, consisting of `Address.StreetAddress`, `Address.City`, `Address.StateProvince`, `Address.PostalCode`, and `Address.Country`. The index also has complex collection of `Rooms` for each hotel.
405405
406406
If your index has complex types, change your prompt to include formatting instructions:
407407
@@ -592,7 +592,3 @@ Once you have your tenant ID, run `az login --tenant <YOUR-TENANT-ID>` at a comm
592592
When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
593593

594594
You can find and manage resources in the Azure portal by using the **All resources** or **Resource groups** link in the leftmost pane.
595-
596-
## Related content
597-
598-
- [Tutorial: Build a RAG solution in Azure AI Search](../tutorial-rag-build-solution.md)

articles/search/includes/quickstarts/search-get-started-rag-python.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -14,14 +14,14 @@ ms.date: 06/05/2025
1414
- [Choose a region](/azure/ai-services/openai/concepts/models?tabs=global-standard%2Cstandard-chat-completions#global-standard-model-availability) that supports the chat completion model you want to use (gpt-4o, gpt-4o-mini, or an equivalent model).
1515
- [Deploy the chat completion model](/azure/ai-foundry/how-to/deploy-models-openai) in Azure AI Foundry or [use another approach](/azure/ai-services/openai/how-to/working-with-models).
1616

17-
- An [Azure AI Search resource](../search-create-service-portal.md).
17+
- An [Azure AI Search resource](../../search-create-service-portal.md).
1818
- Use the same region as your Azure OpenAI resource.
1919
- We recommend using the Basic tier or higher.
20-
- [Enable semantic ranking](../semantic-how-to-enable-disable.md).
20+
- [Enable semantic ranking](../../semantic-how-to-enable-disable.md).
2121

2222
- [Visual Studio Code](https://code.visualstudio.com/download) with the [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python) and the [Jupyter package](https://pypi.org/project/jupyter/). For more information, see [Python in Visual Studio Code](https://code.visualstudio.com/docs/languages/python).
2323

24-
To meet the same-region requirement, start by reviewing the [regions for the chat model](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) you want to use. After you identify a region, confirm that Azure AI Search is available in the [same region](../search-region-support.md#azure-public-regions).
24+
To meet the same-region requirement, start by reviewing the [regions for the chat model](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) you want to use. After you identify a region, confirm that Azure AI Search is available in the [same region](../../search-region-support.md#azure-public-regions).
2525

2626
## Download file
2727

@@ -68,7 +68,7 @@ A search index provides grounding data for the chat model. We recommend the hote
6868

6969
1. In the Azure portal, [find your search service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices).
7070

71-
1. On the **Overview** home page, select [**Import data**](../search-get-started-portal.md) to start the wizard.
71+
1. On the **Overview** home page, select [**Import data**](../../search-get-started-portal.md) to start the wizard.
7272

7373
1. On the **Connect to your data** page, select **Samples** from the dropdown list.
7474

@@ -123,9 +123,9 @@ A search index provides grounding data for the chat model. We recommend the hote
123123

124124
1. **Save** your changes.
125125

126-
1. Run the following query in [Search Explorer](../search-explorer.md) to test your index: `complimentary breakfast`.
126+
1. Run the following query in [Search Explorer](../../search-explorer.md) to test your index: `complimentary breakfast`.
127127

128-
Output should look similar to the following example. Results that are returned directly from the search engine consist of fields and their verbatim values, along with metadata like a search score and a semantic ranking score and caption if you use semantic ranker. We used a [select statement](../search-query-odata-select.md) to return just the HotelName, Description, and Tags fields.
128+
Output should look similar to the following example. Results that are returned directly from the search engine consist of fields and their verbatim values, along with metadata like a search score and a semantic ranking score and caption if you use semantic ranker. We used a [select statement](../../search-query-odata-select.md) to return just the HotelName, Description, and Tags fields.
129129

130130
```
131131
{
@@ -215,7 +215,7 @@ It takes several minutes to create the environment. When the environment is read
215215
216216
## Sign in to Azure
217217
218-
You're using Microsoft Entra ID and role assignments for the connection. Make sure you're logged in to the same tenant and subscription as Azure AI Search and Azure OpenAI. You can use the Azure CLI on the command line to show current properties, change properties, and to sign in. For more information, see [Connect without keys](../search-get-started-rbac.md).
218+
You're using Microsoft Entra ID and role assignments for the connection. Make sure you're logged in to the same tenant and subscription as Azure AI Search and Azure OpenAI. You can use the Azure CLI on the command line to show current properties, change properties, and to sign in. For more information, see [Connect without keys](../../search-get-started-rbac.md).
219219
220220
Run each of the following commands in sequence.
221221
@@ -352,7 +352,7 @@ This section uses Visual Studio Code and Python to call the chat completion APIs
352352

353353
## Send a complex RAG query
354354

355-
Azure AI Search supports [complex types](../search-howto-complex-data-types.md) for nested JSON structures. In the hotels-sample-index, `Address` is an example of a complex type, consisting of `Address.StreetAddress`, `Address.City`, `Address.StateProvince`, `Address.PostalCode`, and `Address.Country`. The index also has complex collection of `Rooms` for each hotel.
355+
Azure AI Search supports [complex types](../../search-howto-complex-data-types.md) for nested JSON structures. In the hotels-sample-index, `Address` is an example of a complex type, consisting of `Address.StreetAddress`, `Address.City`, `Address.StateProvince`, `Address.PostalCode`, and `Address.Country`. The index also has complex collection of `Rooms` for each hotel.
356356

357357
If your index has complex types, your query can provide those fields if you first convert the search results output to JSON, and then pass the JSON to the chat model. The following example adds complex types to the request. The formatting instructions include a JSON specification.
358358

@@ -457,6 +457,3 @@ When you're working in your own subscription, it's a good idea at the end of a p
457457

458458
You can find and manage resources in the Azure portal by using the **All resources** or **Resource groups** link in the leftmost pane.
459459

460-
## Related content
461-
462-
- [Tutorial: Build a RAG solution in Azure AI Search](../tutorial-rag-build-solution.md)

articles/search/includes/quickstarts/search-get-started-rag-typescript.md

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -14,16 +14,16 @@ ms.date: 06/05/2025
1414
- [Choose a region](/azure/ai-services/openai/concepts/models?tabs=global-standard%2Cstandard-chat-completions#global-standard-model-availability) that supports the chat completion model you want to use (gpt-4o, gpt-4o-mini, or an equivalent model).
1515
- [Deploy the chat completion model](/azure/ai-foundry/how-to/deploy-models-openai) in Azure AI Foundry or [use another approach](/azure/ai-services/openai/how-to/working-with-models).
1616

17-
- An [Azure AI Search resource](../search-create-service-portal.md).
17+
- An [Azure AI Search resource](../../search-create-service-portal.md).
1818
- Use the same region as your Azure OpenAI resource.
1919
- We recommend using the Basic tier or higher.
20-
- [Enable semantic ranking](../semantic-how-to-enable-disable.md).
20+
- [Enable semantic ranking](../../semantic-how-to-enable-disable.md).
2121

2222
- [Visual Studio Code](https://code.visualstudio.com/download).
2323
- [Node.JS with LTS](https://nodejs.org/en/download/).
2424
- [TypeScript](https://www.typescriptlang.org/download).
2525

26-
To meet the same-region requirement, start by reviewing the [regions for the chat model](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) you want to use. After you identify a region, confirm that Azure AI Search is available in the [same region](../search-region-support.md#azure-public-regions).
26+
To meet the same-region requirement, start by reviewing the [regions for the chat model](/azure/ai-services/openai/concepts/models#model-summary-table-and-region-availability) you want to use. After you identify a region, confirm that Azure AI Search is available in the [same region](../../search-region-support.md#azure-public-regions).
2727

2828
## Configure access
2929

@@ -64,7 +64,7 @@ A search index provides grounding data for the chat model. We recommend the hote
6464

6565
1. In the Azure portal, [find your search service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices).
6666

67-
1. On the **Overview** home page, select [**Import data**](../search-get-started-portal.md) to start the wizard.
67+
1. On the **Overview** home page, select [**Import data**](../../search-get-started-portal.md) to start the wizard.
6868

6969
1. On the **Connect to your data** page, select **Samples** from the dropdown list.
7070

@@ -119,9 +119,9 @@ A search index provides grounding data for the chat model. We recommend the hote
119119

120120
1. **Save** your changes.
121121

122-
1. Run the following query in [Search Explorer](../search-explorer.md) to test your index: `complimentary breakfast`.
122+
1. Run the following query in [Search Explorer](../../search-explorer.md) to test your index: `complimentary breakfast`.
123123

124-
Output should look similar to the following example. Results that are returned directly from the search engine consist of fields and their verbatim values, along with metadata like a search score and a semantic ranking score and caption if you use semantic ranker. We used a [select statement](../search-query-odata-select.md) to return just the HotelName, Description, and Tags fields.
124+
Output should look similar to the following example. Results that are returned directly from the search engine consist of fields and their verbatim values, along with metadata like a search score and a semantic ranking score and caption if you use semantic ranker. We used a [select statement](../../search-query-odata-select.md) to return just the HotelName, Description, and Tags fields.
125125

126126
```
127127
{
@@ -198,7 +198,7 @@ In the remaining sections, you set up API calls to Azure OpenAI and Azure AI Sea
198198
1. On the **Overview** home page, select the link to view the endpoints. Copy the URL. An example endpoint might look like `https://example.openai.azure.com/`.
199199
200200
201-
You're using Microsoft Entra ID and role assignments for the connection. Make sure you're logged in to the same tenant and subscription as Azure AI Search and Azure OpenAI. You can use the Azure CLI on the command line to show current properties, change properties, and to sign in. For more information, see [Connect without keys](../search-get-started-rbac.md).
201+
You're using Microsoft Entra ID and role assignments for the connection. Make sure you're logged in to the same tenant and subscription as Azure AI Search and Azure OpenAI. You can use the Azure CLI on the command line to show current properties, change properties, and to sign in. For more information, see [Connect without keys](../../search-get-started-rbac.md).
202202
203203
Run each of the following commands in sequence.
204204
@@ -433,7 +433,7 @@ The preceding code does the following:
433433
434434
## Send a complex RAG query
435435
436-
Azure AI Search supports [complex types](../search-howto-complex-data-types.md) for nested JSON structures. In the hotels-sample-index, `Address` is an example of a complex type, consisting of `Address.StreetAddress`, `Address.City`, `Address.StateProvince`, `Address.PostalCode`, and `Address.Country`. The index also has complex collection of `Rooms` for each hotel.
436+
Azure AI Search supports [complex types](../../search-howto-complex-data-types.md) for nested JSON structures. In the hotels-sample-index, `Address` is an example of a complex type, consisting of `Address.StreetAddress`, `Address.City`, `Address.StateProvince`, `Address.PostalCode`, and `Address.Country`. The index also has complex collection of `Rooms` for each hotel.
437437
438438
If your index has complex types, change your prompt to include formatting instructions:
439439
@@ -624,7 +624,3 @@ Once you have your tenant ID, run `az login --tenant <YOUR-TENANT-ID>` at a comm
624624
When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Resources left running can cost you money. You can delete resources individually or delete the resource group to delete the entire set of resources.
625625

626626
You can find and manage resources in the Azure portal by using the **All resources** or **Resource groups** link in the leftmost pane.
627-
628-
## Related content
629-
630-
- [Tutorial: Build a RAG solution in Azure AI Search](../tutorial-rag-build-solution.md)

0 commit comments

Comments
 (0)