Skip to content

Commit 37adf07

Browse files
committed
added semantic ranking fix
1 parent a452dd9 commit 37adf07

File tree

2 files changed

+9
-13
lines changed

2 files changed

+9
-13
lines changed

articles/search/search-synonyms.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,11 +19,11 @@ On a search service, a synonym map associates equivalent terms, expanding the sc
1919

2020
Some key points about synonym maps:
2121

22-
- A synonym map is an asset that can be created once and used by many indexes.
23-
- Synonyms apply to string fields.
24-
- You can create one at any time with no disruption to indexing or queries.
25-
- The [service tier](search-limits-quotas-capacity.md#synonym-limits) sets the limits on how many synonyms maps you can create.
26-
- A search service can have multiple synonym maps, but within an index, a field definition can only have one synonym map assignment.
22+
- A synonym map is a top-level resource that can be created once and used by many indexes.
23+
- A synonym map applies to string fields.
24+
- You can create and assign a synonym map at any time with no disruption to indexing or queries.
25+
- Your [service tier](search-limits-quotas-capacity.md#synonym-limits) sets the limits on how many synonyms maps you can create.
26+
- Your search service can have multiple synonym maps, but within an index, a field definition can only have one synonym map assignment.
2727

2828
## Create a synonym map
2929

articles/search/semantic-how-to-query-request.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.service: cognitive-search
1010
ms.custom:
1111
- ignite-2023
1212
ms.topic: how-to
13-
ms.date: 06/13/2024
13+
ms.date: 07/24/2024
1414
---
1515

1616
# Add semantic ranking to queries in Azure AI Search
@@ -43,11 +43,9 @@ You can use any of the following tools and SDKs to build a query that uses seman
4343

4444
## Avoid features that bypass relevance scoring
4545

46-
Several query capabilities in Azure AI Search bypass relevance scoring or are otherwise incompatible with semantic ranking. If your query logic includes the following features, you can't semantically rank your results:
46+
A few query capabilities bypass relevance scoring, which makes them incompatible with semantic ranking. If your query logic includes the following features, you can't semantically rank your results:
4747

48-
+ A query with `search=*` or an empty search string, such as pure filter-only query, won't work because there's nothing to measure semantic relevance against. The query must provide terms or phrases that can be assessed during processing.
49-
50-
+ A query composed in the [full Lucene syntax](query-lucene-syntax.md) (`queryType=full`) is incompatible with semantic ranking (`queryType=semantic`). The semantic model doesn't support the full Lucene syntax.
48+
+ A query with `search=*` or an empty search string, such as pure filter-only query, won't work because there's nothing to measure semantic relevance against and so the search scores are zero. The query must provide terms or phrases that can be evaluated during processing.
5149

5250
+ Sorting (orderBy clauses) on specific fields overrides search scores and a semantic score. Given that the semantic score is supposed to provide the ranking, adding an orderby clause results in an HTTP 400 error if you apply semantic ranking over ordered results.
5351

@@ -116,9 +114,7 @@ The following example in this section uses the [hotels-sample-index](search-get-
116114
117115
1. Set "queryType" to "semantic".
118116
119-
In other queries, the "queryType" is used to specify the query parser. In semantic ranking, it's set to "semantic". For the "search" field, you can specify queries that conform to the [simple syntax](query-simple-syntax.md).
120-
121-
1. Set "search" to a full text search query based on the [simple syntax](query-simple-syntax.md). Semantic ranking is an extension of full text search, so while this parameter isn't required, you won't get an expected outcome if it's null.
117+
1. Set "search" to a full text search query. Your search string can support either the [simple syntax](query-simple-syntax.md) or [full Lucene syntax](query-lucene-syntax.md). Semantic ranking is an extension of full text search, so while "search" isn't required, you won't get an expected outcome if it's an empty search (`"search": "*"`).
122118
123119
1. Set "semanticConfiguration" to a [predefined semantic configuration](semantic-how-to-configure.md) that's embedded in your index.
124120

0 commit comments

Comments
 (0)