fix ref link

Author: diberry

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

@@ -14,15 +14,15 @@ ms.date: 06/05/2025
   - [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).
   - [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).
 
-- An [Azure AI Search resource](search-create-service-portal.md).
+- An [Azure AI Search resource](../search-create-service-portal.md).
   - Use the same region as your Azure OpenAI resource.
   - We recommend using the Basic tier or higher.
-  - [Enable semantic ranking](semantic-how-to-enable-disable.md).
+  - [Enable semantic ranking](../semantic-how-to-enable-disable.md).
 
 - [Visual Studio Code](https://code.visualstudio.com/download).
 - [Node.JS with LTS](https://nodejs.org/en/download/).
 
-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).
+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).
 
 ## Configure access
 
@@ -63,7 +63,7 @@ A search index provides grounding data for the chat model. We recommend the hote
 
 1. In the Azure portal, [find your search service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices).
 
-1. On the **Overview** home page, select [**Import data**](search-get-started-portal.md) to start the wizard.
+1. On the **Overview** home page, select [**Import data**](../search-get-started-portal.md) to start the wizard.
 
 1. On the **Connect to your data** page, select **Samples** from the dropdown list.
 
@@ -118,9 +118,9 @@ A search index provides grounding data for the chat model. We recommend the hote
 
 1. **Save** your changes.
 
-1. Run the following query in [Search Explorer](search-explorer.md) to test your index: `complimentary breakfast`.
+1. Run the following query in [Search Explorer](../search-explorer.md) to test your index: `complimentary breakfast`.
 
-   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.
+   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.
 
    ```
    {
@@ -197,7 +197,7 @@ In the remaining sections, you set up API calls to Azure OpenAI and Azure AI Sea
 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/`.
 
 
-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). 
+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). 
 
 Run each of the following commands in sequence.
 
@@ -387,21 +387,21 @@ The preceding code does the following:
 
 ## Troubleshooting
 
-    If you get a **Forbidden** error message, check Azure AI Search configuration to make sure role-based access is enabled.
+If you get a **Forbidden** error message, check Azure AI Search configuration to make sure role-based access is enabled.
 
-    If you get an **Authorization failed** error message, wait a few minutes and try again. It can take several minutes for role assignments to become operational.
+If you get an **Authorization failed** error message, wait a few minutes and try again. It can take several minutes for role assignments to become operational.
 
-    If you get a **Resource not found** error message, check the resource URIs and make sure the API version on the chat model is valid.
+If you get a **Resource not found** error message, check the resource URIs and make sure the API version on the chat model is valid.
 
-    Otherwise, to experiment further, change the query and rerun the last step to better understand how the model works with the grounding data.
+Otherwise, to experiment further, change the query and rerun the last step to better understand how the model works with the grounding data.
 
-    You can also modify the prompt to change the tone or structure of the output.
+You can also modify the prompt to change the tone or structure of the output.
 
-    You might also try the query without semantic ranking by setting `use_semantic_reranker=False` in the query parameters step. Semantic ranking can noticably improve the relevance of query results and the ability of the LLM to return useful information. Experimentation can help you decide whether it makes a difference for your content.
+You might also try the query without semantic ranking by setting `use_semantic_reranker=False` in the query parameters step. Semantic ranking can noticably improve the relevance of query results and the ability of the LLM to return useful information. Experimentation can help you decide whether it makes a difference for your content.
 
 ## Send a complex RAG query
 
-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.
+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.
 
 If your index has complex types, change your prompt to include formatting instructions: 
 
@@ -595,4 +595,4 @@ You can find and manage resources in the Azure portal by using the **All resourc
 
 ## Related content
 
-- [Tutorial: Build a RAG solution in Azure AI Search](tutorial-rag-build-solution.md)
+- [Tutorial: Build a RAG solution in Azure AI Search](../tutorial-rag-build-solution.md)

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

@@ -14,14 +14,14 @@ ms.date: 06/05/2025
   - [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).
   - [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).
 
-- An [Azure AI Search resource](search-create-service-portal.md).
+- An [Azure AI Search resource](../search-create-service-portal.md).
   - Use the same region as your Azure OpenAI resource.
   - We recommend using the Basic tier or higher.
-  - [Enable semantic ranking](semantic-how-to-enable-disable.md).
+  - [Enable semantic ranking](../semantic-how-to-enable-disable.md).
 
 - [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).
 
-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).
+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).
 
 ## Download file
 
@@ -68,7 +68,7 @@ A search index provides grounding data for the chat model. We recommend the hote
 
 1. In the Azure portal, [find your search service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices).
 
-1. On the **Overview** home page, select [**Import data**](search-get-started-portal.md) to start the wizard.
+1. On the **Overview** home page, select [**Import data**](../search-get-started-portal.md) to start the wizard.
 
 1. On the **Connect to your data** page, select **Samples** from the dropdown list.
 
@@ -123,9 +123,9 @@ A search index provides grounding data for the chat model. We recommend the hote
 
 1. **Save** your changes.
 
-1. Run the following query in [Search Explorer](search-explorer.md) to test your index: `complimentary breakfast`.
+1. Run the following query in [Search Explorer](../search-explorer.md) to test your index: `complimentary breakfast`.
 
-   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.
+   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.
 
    ```
    {
@@ -215,7 +215,7 @@ It takes several minutes to create the environment. When the environment is read
 
 ## Sign in to Azure
 
-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). 
+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). 
 
 Run each of the following commands in sequence.
 
@@ -352,7 +352,7 @@ This section uses Visual Studio Code and Python to call the chat completion APIs
 
 ## Send a complex RAG query
 
-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.
+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.
 
 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.
 
@@ -459,4 +459,4 @@ You can find and manage resources in the Azure portal by using the **All resourc
 
 ## Related content
 
-- [Tutorial: Build a RAG solution in Azure AI Search](tutorial-rag-build-solution.md)
+- [Tutorial: Build a RAG solution in Azure AI Search](../tutorial-rag-build-solution.md)

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

@@ -14,16 +14,16 @@ ms.date: 06/05/2025
   - [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).
   - [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).
 
-- An [Azure AI Search resource](search-create-service-portal.md).
+- An [Azure AI Search resource](../search-create-service-portal.md).
   - Use the same region as your Azure OpenAI resource.
   - We recommend using the Basic tier or higher.
-  - [Enable semantic ranking](semantic-how-to-enable-disable.md).
+  - [Enable semantic ranking](../semantic-how-to-enable-disable.md).
 
 - [Visual Studio Code](https://code.visualstudio.com/download).
 - [Node.JS with LTS](https://nodejs.org/en/download/).
 - [TypeScript](https://www.typescriptlang.org/download).
 
-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).
+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).
 
 ## Configure access
 
@@ -64,7 +64,7 @@ A search index provides grounding data for the chat model. We recommend the hote
 
 1. In the Azure portal, [find your search service](https://portal.azure.com/#blade/HubsExtension/BrowseResourceBlade/resourceType/Microsoft.Search%2FsearchServices).
 
-1. On the **Overview** home page, select [**Import data**](search-get-started-portal.md) to start the wizard.
+1. On the **Overview** home page, select [**Import data**](../search-get-started-portal.md) to start the wizard.
 
 1. On the **Connect to your data** page, select **Samples** from the dropdown list.
 
@@ -119,9 +119,9 @@ A search index provides grounding data for the chat model. We recommend the hote
 
 1. **Save** your changes.
 
-1. Run the following query in [Search Explorer](search-explorer.md) to test your index: `complimentary breakfast`.
+1. Run the following query in [Search Explorer](../search-explorer.md) to test your index: `complimentary breakfast`.
 
-   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.
+   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.
 
    ```
    {
@@ -198,7 +198,7 @@ In the remaining sections, you set up API calls to Azure OpenAI and Azure AI Sea
 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/`.
 
 
-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). 
+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). 
 
 Run each of the following commands in sequence.
 
@@ -433,7 +433,7 @@ The preceding code does the following:
 
 ## Send a complex RAG query
 
-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.
+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.
 
 If your index has complex types, change your prompt to include formatting instructions: 
 
@@ -627,4 +627,4 @@ You can find and manage resources in the Azure portal by using the **All resourc
 
 ## Related content
 
-- [Tutorial: Build a RAG solution in Azure AI Search](tutorial-rag-build-solution.md)
+- [Tutorial: Build a RAG solution in Azure AI Search](../tutorial-rag-build-solution.md)