You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/search/semantic-how-to-query-request.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,30 +34,23 @@ To use semantic ranking:
34
34
+ Review [semantic ranking](semantic-search-overview.md) if you need an introduction to the feature.
35
35
36
36
> [!NOTE]
37
-
> Captions and answers are extracted verbatim from text in the search document. The semantic subsystem uses language understanding to determine what part of your content have the characteristics of a caption or answer, but it doesn't compose new sentences or phrases. For this reason, content that includes explanations or definitions work best for semantic ranking.
37
+
> Captions and answers are extracted verbatim from text in the search document. The semantic subsystem uses language understanding to recognize what part of your content has the characteristics of a caption or answer, but it doesn't compose new sentences or phrases. For this reason, content that includes explanations or definitions work best for semantic ranking.
38
38
39
39
## 1 - Choose a client
40
40
41
41
Choose a search client that supports preview APIs on the query request. Here are some options:
42
42
43
43
+[Search explorer](search-explorer.md) in Azure portal, recommended for initial exploration.
44
44
45
-
+[Postman app](https://www.postman.com/downloads/) using the [2021-04-30-Preview REST APIs](/rest/api/searchservice/preview-api/search-documents). See this [Quickstart](search-get-started-rest.md) for help with setting up your requests.
45
+
+[Postman app](https://www.postman.com/downloads/) using [Preview REST APIs](/rest/api/searchservice/preview-api/search-documents). See this [Quickstart](search-get-started-rest.md) for help with setting up your requests.
46
46
47
-
+[Azure.Search.Documents 11.4.0-beta.5](https://www.nuget.org/packages/Azure.Search.Documents/11.4.0-beta.5) in the Azure SDK for .NET Preview.
47
+
+[Azure.Search.Documents 11.4.0-beta.5](https://www.nuget.org/packages/Azure.Search.Documents/11.4.0-beta.5) in the Azure SDK for .NET.
48
48
49
49
+[Azure.Search.Documents 11.3.0b6](https://azuresdkdocs.blob.core.windows.net/$web/python/azure-search-documents/11.3.0b6/azure.search.documents.aio.html) in the Azure SDK for Python.
50
50
51
51
## 2 - Create a semantic configuration
52
52
53
-
A *semantic configuration* establishes field inputs for semantic ranking. You can add or update a semantic configuration to an index definition at any time, no rebuild necessary. At query time, specify one on a query request.
54
-
55
-
+ Fields must be `searchable` and `retrievable`.
56
-
+ Fields must be a string: `Edm.String`, `Edm.ComplexType`,`Collection(Edm.String)`.
57
-
58
-
String subfields of `Collection(Edm.ComplexType)` fields aren't currently supported in semantic ranking, captions, or answers.
59
-
60
-
A semantic configuration has a name and the following properties:
53
+
A *semantic configuration* is a section in your index that establishes field inputs for semantic ranking. You can add or update a semantic configuration at any time, no rebuild necessary. At query time, specify one on a query request. A semantic configuration has a name and the following properties:
61
54
62
55
| Property | Characteristics |
63
56
|----------|-----------------|
@@ -67,6 +60,13 @@ A semantic configuration has a name and the following properties:
67
60
68
61
You can only specify one title field, but you can specify as many content and keyword fields as you like. For content and keyword fields, list the fields in priority order because lower priority fields may get truncated.
69
62
63
+
Across all configuration properties, fields must be:
64
+
65
+
+ Attributed as `searchable` and `retrievable`.
66
+
+ Strings of type `Edm.String`, `Edm.ComplexType`, or `Collection(Edm.String)`.
67
+
68
+
String subfields of `Collection(Edm.ComplexType)` fields aren't currently supported in semantic ranking, captions, or answers.
69
+
70
70
### [**Azure portal**](#tab/portal)
71
71
72
72
1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to a search service that has [semantic search enabled](semantic-how-to-enable-disable.md).
0 commit comments