Add Semantic configuration to Azure Search specs (#16777)

* Add semantic skeleton

* Add query time semantic configuration parameter

* Add example for semantic configuration

* Update descriptions

* Fix syntax issue

* IoT Central Public API 1.1-preview Oct Release (#16514)

* Add new 2.0-preview.1 version for IoT Central

* fix typo on enum value

* rollback 1.0 changes, applied 2.0-preview.1

* fix typo

* remove non-used examples

* fix style

* update version from 2.0-preview.1 to 1.1-preview

* update code review comments, fix patch consumes with json-patch support, fix examples for fileupload

* add nextLink to collection of orgs

* fix typo

* fix wrong position of paging

* fix the paging

* add . to description

* update default to use enum for api-version

* add oct release with query, cde v2, device filter, device template filter, relationship, edge template, simplified template patching

* update examples

* fix lint error, model validation

* fix missing type in examples, remove url format

* fix ID case

* fix id case

* fix ID case

* add iotc query language reference

* fix typo

* Update descriptions + add newly supported languages

* Add enum descriptions for languages

* Fix syntax and spelling

* Fix semantic configuration name

* Run prettier

* Add sdk naming for semantic

* Rename internal semantic object

* Add language names

* Add MA-in

* Add farsi

* Fix country name typoes and add spelling entries

Co-authored-by: Raouf Merouche <[email protected]>
Co-authored-by: Johnson Yang <[email protected]>
Co-authored-by: Wenyang Fu <[email protected]>

Author: 4 people

custom-words.txt

@@ -479,6 +479,7 @@ dacl
 dailyforecast
 dailyhistorical
 darkgrey
+Darussalam
 databox
 Databricks
 datacatalog

specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/examples/SearchServiceCreateIndex.json

@@ -125,6 +125,34 @@
         "@odata.type": "#Microsoft.Azure.Search.BM25Similarity",
         "b": 0.5,
         "k1": 1.3
+      },
+      "semantic": {
+        "configurations": [
+          {
+            "name": "semanticHotels",
+            "prioritizedFields": {
+              "titleField": {
+                "fieldName": "hotelName"
+              },
+              "prioritizedContentFields": [
+                {
+                  "fieldName": "description"
+                },
+                {
+                  "fieldName": "description_fr"
+                }
+              ],
+              "prioritizedKeywordsFields": [
+                {
+                  "fieldName": "tags"
+                },
+                {
+                  "fieldName": "category"
+                }
+              ]
+            }
+          }
+        ]
       }
     }
   },
@@ -366,6 +394,34 @@
           "@odata.type": "#Microsoft.Azure.Search.BM25Similarity",
           "b": 0.5,
           "k1": 1.3
+        },
+        "semantic": {
+          "configurations": [
+            {
+              "name": "semanticHotels",
+              "prioritizedFields": {
+                "titleField": {
+                  "fieldName": "hotelName"
+                },
+                "prioritizedContentFields": [
+                  {
+                    "fieldName": "description"
+                  },
+                  {
+                    "fieldName": "description_fr"
+                  }
+                ],
+                "prioritizedKeywordsFields": [
+                  {
+                    "fieldName": "tags"
+                  },
+                  {
+                    "fieldName": "category"
+                  }
+                ]
+              }
+            }
+          ]
         }
       }
     }

specification/search/data-plane/Azure.Search/preview/2021-04-30-Preview/examples/SearchServiceCreateOrUpdateIndex.json

@@ -123,6 +123,34 @@
       },
       "similarity": {
         "@odata.type": "#Microsoft.Azure.Search.ClassicSimilarity"
+      },
+      "semantic": {
+        "configurations": [
+          {
+            "name": "semanticHotels",
+            "prioritizedFields": {
+              "titleField": {
+                "fieldName": "hotelName"
+              },
+              "prioritizedContentFields": [
+                {
+                  "fieldName": "description"
+                },
+                {
+                  "fieldName": "description_fr"
+                }
+              ],
+              "prioritizedKeywordsFields": [
+                {
+                  "fieldName": "tags"
+                },
+                {
+                  "fieldName": "category"
+                }
+              ]
+            }
+          }
+        ]
       }
     }
   },
@@ -591,6 +619,34 @@
           "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
           "keyVaultUri": "https://myKeyVault.vault.azure.net",
           "accessCredentials": null
+        },
+        "semantic": {
+          "configurations": [
+            {
+              "name": "semanticHotels",
+              "prioritizedFields": {
+                "titleField": {
+                  "fieldName": "hotelName"
+                },
+                "prioritizedContentFields": [
+                  {
+                    "fieldName": "description"
+                  },
+                  {
+                    "fieldName": "description_fr"
+                  }
+                ],
+                "prioritizedKeywordsFields": [
+                  {
+                    "fieldName": "tags"
+                  },
+                  {
+                    "fieldName": "category"
+                  }
+                ]
+              }
+            }
+          ]
         }
       }
     }