Skip to content

Commit 1df3f41

Browse files
committed
[azure search] Semantic quickstart zone pivot
1 parent f7d969b commit 1df3f41

File tree

3 files changed

+15
-23
lines changed

3 files changed

+15
-23
lines changed

articles/search/includes/quickstarts/dotnet-semantic.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
author: HeidiSteen
3-
ms.author: heidist
2+
author: haileytap
3+
ms.author: haileytapia
44
ms.service: azure-ai-search
55
ms.custom:
66
- ignite-2023

articles/search/includes/quickstarts/python-semantic.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
author: HeidiSteen
3-
ms.author: heidist
2+
author: haileytap
3+
ms.author: haileytapia
44
ms.service: azure-ai-search
55
ms.custom:
66
- ignite-2023

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

Lines changed: 11 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -12,50 +12,42 @@ ms.custom:
1212
- ignite-2023
1313
ms.topic: quickstart
1414
ms.date: 06/13/2025
15+
zone_pivot_groups: search-get-started-semantic
1516
---
1617

1718
# Quickstart: Semantic ranking using .NET or Python
1819

1920
In this quickstart, you learn about the index and query modifications that invoke semantic ranker.
2021

21-
In Azure AI Search, [semantic ranking](semantic-search-overview.md) is query-side functionality that uses machine reading comprehension from Microsoft to rescore search results, promoting the most semantically relevant matches to the top of the list. Depending on the content and the query, semantic ranking can [significantly improve search relevance](https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-cognitive-search-outperforming-vector-search-with-hybrid/ba-p/3929167) with minimal developer effort.
22-
23-
> [!NOTE]
24-
> For an example of an Azure AI Search solution with ChatGPT interaction, see [this demo](https://github.com/Azure-Samples/azure-search-openai-demo/blob/main/README.md) or [this accelerator](https://github.com/Azure-Samples/chat-with-your-data-solution-accelerator).
22+
In Azure AI Search, [semantic ranking](semantic-search-overview.md) is query-side functionality that uses machine reading comprehension from Microsoft to rescore search results, promoting the most semantically relevant matches to the top of the list. Depending on the content and the query, semantic ranking can [significantly improve search relevance](https://techcommunity.microsoft.com/t5/azure-ai-services-blog/azure-cognitive-search-outperforming-vector-search-with-hybrid/ba-p/3929167) with minimal developer effort. Semantic ranking is also required for [agentic retrieval (preview)](search-agentic-retrieval-concept.md).
2523

2624
## Prerequisites
2725

2826
+ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
2927

3028
+ An [Azure AI Search service](search-create-service-portal.md), at Basic tier or higher, with [semantic ranker enabled](semantic-how-to-enable-disable.md).
3129

32-
+ An API key and a search service endpoint. To obtain them:
33-
34-
1. Sign in to the [Azure portal](https://portal.azure.com) and find your search service.
35-
36-
1. On **Overview**, copy the URL and save it for a later step. An example endpoint might look like `https://mydemo.search.windows.net`.
37-
38-
1. On **Keys**, copy and save an admin key for full rights to create and delete objects. There are two interchangeable primary and secondary keys. Choose either one.
30+
+ A new or existing index with descriptive or verbose text fields, attributed as retrievable in your index. You can add a semantic configuration to an existing index with no rebuild requirement. Semantic ranking is effective on content that's informational or descriptive.
3931

40-
:::image type="content" source="media/search-get-started-rest/get-url-key.png" alt-text="Screenshot showing where to find your search service's HTTP endpoint and access key.":::
41-
42-
## Add semantic ranking
32+
## How to add a semantic ranker
4333

4434
To use semantic ranker, add a *semantic configuration* to a search index, and add parameters to a query. If you have an existing index, you can make these changes without having to reindex your content because there's no impact on the structure of your searchable content.
4535

4636
+ A semantic configuration sets a priority order for fields that contribute a title, keywords, and content used in semantic reranking. Field prioritization allows for faster processing.
4737

4838
+ Queries that invoke semantic ranker include parameters for query type and whether captions and answers are returned. You can add these parameters to your existing query logic. There's no conflict with other parameters.
4939

50-
### [**.NET**](#tab/dotnet)
40+
::: zone pivot="programming-language-csharp"
5141

52-
[!INCLUDE [dotnet-sdk-semantic-quickstart](includes/quickstarts/dotnet-semantic.md)]
42+
[!INCLUDE [C# quickstart](includes/quickstarts/semantic-ranker-csharp.md)]
5343

54-
### [**Python**](#tab/python)
44+
::: zone-end
5545

56-
[!INCLUDE [python-sdk-semantic-quickstart](includes/quickstarts/python-semantic.md)]
46+
::: zone pivot="programming-language-python"
5747

58-
---
48+
[!INCLUDE [Python quickstart](includes/quickstarts/semantic-ranker-python.md)]
49+
50+
::: zone-end
5951

6052
## Clean up resources
6153

0 commit comments

Comments
 (0)