@azure/search-documents 12.1.0-alpha.20240513.1 → 12.1.0-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/dist/index.js +626 -216
  2. package/dist/index.js.map +1 -1
  3. package/dist-esm/src/generated/data/models/index.js +42 -22
  4. package/dist-esm/src/generated/data/models/index.js.map +1 -1
  5. package/dist-esm/src/generated/data/models/mappers.js +127 -0
  6. package/dist-esm/src/generated/data/models/mappers.js.map +1 -1
  7. package/dist-esm/src/generated/data/models/parameters.js +74 -74
  8. package/dist-esm/src/generated/data/models/parameters.js.map +1 -1
  9. package/dist-esm/src/generated/data/operations/documents.js +8 -8
  10. package/dist-esm/src/generated/data/operations/documents.js.map +1 -1
  11. package/dist-esm/src/generated/data/searchClient.js.map +1 -1
  12. package/dist-esm/src/generated/service/models/index.js +53 -9
  13. package/dist-esm/src/generated/service/models/index.js.map +1 -1
  14. package/dist-esm/src/generated/service/models/mappers.js +159 -16
  15. package/dist-esm/src/generated/service/models/mappers.js.map +1 -1
  16. package/dist-esm/src/generated/service/searchServiceClient.js.map +1 -1
  17. package/dist-esm/src/generatedStringLiteralUnions.js.map +1 -1
  18. package/dist-esm/src/index.js +2 -2
  19. package/dist-esm/src/index.js.map +1 -1
  20. package/dist-esm/src/indexModels.js.map +1 -1
  21. package/dist-esm/src/searchClient.js +2 -5
  22. package/dist-esm/src/searchClient.js.map +1 -1
  23. package/dist-esm/src/searchIndexingBufferedSender.js +2 -1
  24. package/dist-esm/src/searchIndexingBufferedSender.js.map +1 -1
  25. package/dist-esm/src/serialization.js +34 -70
  26. package/dist-esm/src/serialization.js.map +1 -1
  27. package/dist-esm/src/serviceModels.js.map +1 -1
  28. package/dist-esm/src/serviceUtils.js +38 -12
  29. package/dist-esm/src/serviceUtils.js.map +1 -1
  30. package/dist-esm/src/walk.js +79 -0
  31. package/dist-esm/src/walk.js.map +1 -0
  32. package/package.json +9 -9
  33. package/types/search-documents.d.ts +275 -28
  34. package/dist-esm/src/constants.js +0 -5
  35. package/dist-esm/src/constants.js.map +0 -1
@@ -9,6 +9,40 @@ import { Pipeline } from '@azure/core-rest-pipeline';
9
9
  import { RestError } from '@azure/core-rest-pipeline';
10
10
  import { TokenCredential } from '@azure/core-auth';
11
11
 
12
+ /** Specifies the AI Services Vision parameters for vectorizing a query image or text. */
13
+ export declare interface AIServicesVisionParameters {
14
+ /** The version of the model to use when calling the AI Services Vision service. It will default to the latest available when not specified. */
15
+ modelVersion?: string;
16
+ /** The resource URI of the AI Services resource. */
17
+ resourceUri: string;
18
+ /** API key of the designated AI Services resource. */
19
+ apiKey?: string;
20
+ /** The user-assigned managed identity used for outbound connections. If an authResourceId is provided and it's not specified, the system-assigned managed identity is used. On updates to the index, if the identity is unspecified, the value remains unchanged. If set to "none", the value of this property is cleared. */
21
+ authIdentity?: SearchIndexerDataIdentity;
22
+ }
23
+
24
+ /** Specifies the AI Services Vision parameters for vectorizing a query image or text. */
25
+ export declare interface AIServicesVisionVectorizer extends BaseVectorSearchVectorizer {
26
+ /** Polymorphic discriminator, which specifies the different types this object can be */
27
+ kind: "aiServicesVision";
28
+ /** Contains the parameters specific to AI Services Vision embedding vectorization. */
29
+ aIServicesVisionParameters?: AIServicesVisionParameters;
30
+ }
31
+
32
+ /**
33
+ * Defines values for AIStudioModelCatalogName. \
34
+ * {@link KnownAIStudioModelCatalogName} can be used interchangeably with AIStudioModelCatalogName,
35
+ * this enum contains the known values that the service supports.
36
+ * ### Known values supported by the service
37
+ * **OpenAI-CLIP-Image-Text-Embeddings-vit-base-patch32** \
38
+ * **OpenAI-CLIP-Image-Text-Embeddings-ViT-Large-Patch14-336** \
39
+ * **Facebook-DinoV2-Image-Embeddings-ViT-Base** \
40
+ * **Facebook-DinoV2-Image-Embeddings-ViT-Giant** \
41
+ * **Cohere-embed-v3-english** \
42
+ * **Cohere-embed-v3-multilingual**
43
+ */
44
+ export declare type AIStudioModelCatalogName = string;
45
+
12
46
  /**
13
47
  * An iterator for listing the aliases that exist in the Search service. Will make requests
14
48
  * as needed during iteration. Use .byPage() to make one request to the server
@@ -214,20 +248,37 @@ export declare interface AzureMachineLearningSkill extends BaseSearchIndexerSkil
214
248
  degreeOfParallelism?: number;
215
249
  }
216
250
 
217
- /** Allows you to generate a vector embedding for a given text input using the Azure Open AI service. */
218
- export declare interface AzureOpenAIEmbeddingSkill extends BaseSearchIndexerSkill {
251
+ /** Specifies an Azure Machine Learning endpoint deployed via the Azure AI Studio Model Catalog for generating the vector embedding of a query string. */
252
+ export declare interface AzureMachineLearningVectorizer extends BaseVectorSearchVectorizer {
253
+ /** Polymorphic discriminator, which specifies the different types this object can be */
254
+ kind: "aml";
255
+ /** Specifies the properties of the AML vectorizer. */
256
+ amlParameters?: AzureMachineLearningVectorizerParameters;
257
+ }
258
+
259
+ /** Specifies the properties for connecting to an AML vectorizer. */
260
+ export declare type AzureMachineLearningVectorizerParameters = NoAuthAzureMachineLearningVectorizerParameters | KeyAuthAzureMachineLearningVectorizerParameters | TokenAuthAzureMachineLearningVectorizerParameters;
261
+
262
+ /** Allows you to generate a vector embedding for a given text input using the Azure OpenAI resource. */
263
+ export declare interface AzureOpenAIEmbeddingSkill extends BaseSearchIndexerSkill, AzureOpenAIParameters {
219
264
  /** Polymorphic discriminator, which specifies the different types this object can be */
220
265
  odatatype: "#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill";
221
- /** The resource uri for your Azure Open AI resource. */
222
- resourceUri?: string;
223
- /** ID of your Azure Open AI model deployment on the designated resource. */
224
- deploymentId?: string;
225
- /** API key for the designated Azure Open AI resource. */
226
- apiKey?: string;
227
- /** The user-assigned managed identity used for outbound connections. */
228
- authIdentity?: SearchIndexerDataIdentity;
266
+ /** The number of dimensions the resulting output embeddings should have. Only supported in text-embedding-3 and later models. */
267
+ dimensions?: number;
229
268
  }
230
269
 
270
+ /**
271
+ * Defines values for AzureOpenAIModelName. \
272
+ * {@link KnownAzureOpenAIModelName} can be used interchangeably with AzureOpenAIModelName,
273
+ * this enum contains the known values that the service supports.
274
+ * ### Known values supported by the service
275
+ * **text-embedding-ada-002** \
276
+ * **text-embedding-3-large** \
277
+ * **text-embedding-3-small** \
278
+ * **experimental**
279
+ */
280
+ export declare type AzureOpenAIModelName = string;
281
+
231
282
  /** Contains the parameters specific to using an Azure Open AI service for vectorization at query time. */
232
283
  export declare interface AzureOpenAIParameters {
233
284
  /** The resource uri for your Azure Open AI resource. */
@@ -238,15 +289,25 @@ export declare interface AzureOpenAIParameters {
238
289
  apiKey?: string;
239
290
  /** The user-assigned managed identity used for outbound connections. */
240
291
  authIdentity?: SearchIndexerDataIdentity;
292
+ /** The name of the embedding model that is deployed at the provided deploymentId path. */
293
+ modelName?: AzureOpenAIModelName;
241
294
  }
242
295
 
243
296
  /** Contains the parameters specific to using an Azure Open AI service for vectorization at query time. */
244
- export declare type AzureOpenAIVectorizer = BaseVectorSearchVectorizer & {
297
+ export declare interface AzureOpenAIVectorizer extends BaseVectorSearchVectorizer {
245
298
  /** Polymorphic discriminator, which specifies the different types this object can be */
246
299
  kind: "azureOpenAI";
247
300
  /** Contains the parameters specific to Azure Open AI embedding vectorization. */
248
301
  azureOpenAIParameters?: AzureOpenAIParameters;
249
- };
302
+ }
303
+
304
+ /** Specifies the properties common between all AML vectorizer auth types. */
305
+ export declare interface BaseAzureMachineLearningVectorizerParameters {
306
+ /** When specified, indicates the timeout for the http client making the API call. */
307
+ timeout?: string;
308
+ /** The name of the embedding model from the Azure AI Studio Catalog that is deployed at the provided endpoint. */
309
+ modelName?: AIStudioModelCatalogName;
310
+ }
250
311
 
251
312
  /** Base type for character filters. */
252
313
  export declare interface BaseCharFilter {
@@ -321,7 +382,7 @@ export declare interface BaseSearchIndexerDataIdentity {
321
382
  /** Base type for skills. */
322
383
  export declare interface BaseSearchIndexerSkill {
323
384
  /** Polymorphic discriminator, which specifies the different types this object can be */
324
- odatatype: "#Microsoft.Skills.Util.ConditionalSkill" | "#Microsoft.Skills.Text.KeyPhraseExtractionSkill" | "#Microsoft.Skills.Vision.OcrSkill" | "#Microsoft.Skills.Vision.ImageAnalysisSkill" | "#Microsoft.Skills.Text.LanguageDetectionSkill" | "#Microsoft.Skills.Util.ShaperSkill" | "#Microsoft.Skills.Text.MergeSkill" | "#Microsoft.Skills.Text.EntityRecognitionSkill" | "#Microsoft.Skills.Text.SentimentSkill" | "#Microsoft.Skills.Text.V3.SentimentSkill" | "#Microsoft.Skills.Text.V3.EntityLinkingSkill" | "#Microsoft.Skills.Text.V3.EntityRecognitionSkill" | "#Microsoft.Skills.Text.PIIDetectionSkill" | "#Microsoft.Skills.Text.SplitSkill" | "#Microsoft.Skills.Text.CustomEntityLookupSkill" | "#Microsoft.Skills.Text.TranslationSkill" | "#Microsoft.Skills.Util.DocumentExtractionSkill" | "#Microsoft.Skills.Custom.WebApiSkill" | "#Microsoft.Skills.Custom.AmlSkill" | "#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill";
385
+ odatatype: "#Microsoft.Skills.Util.ConditionalSkill" | "#Microsoft.Skills.Text.KeyPhraseExtractionSkill" | "#Microsoft.Skills.Vision.OcrSkill" | "#Microsoft.Skills.Vision.ImageAnalysisSkill" | "#Microsoft.Skills.Text.LanguageDetectionSkill" | "#Microsoft.Skills.Util.ShaperSkill" | "#Microsoft.Skills.Text.MergeSkill" | "#Microsoft.Skills.Text.EntityRecognitionSkill" | "#Microsoft.Skills.Text.SentimentSkill" | "#Microsoft.Skills.Text.V3.SentimentSkill" | "#Microsoft.Skills.Text.V3.EntityLinkingSkill" | "#Microsoft.Skills.Text.V3.EntityRecognitionSkill" | "#Microsoft.Skills.Text.PIIDetectionSkill" | "#Microsoft.Skills.Text.SplitSkill" | "#Microsoft.Skills.Text.CustomEntityLookupSkill" | "#Microsoft.Skills.Text.TranslationSkill" | "#Microsoft.Skills.Util.DocumentExtractionSkill" | "#Microsoft.Skills.Custom.WebApiSkill" | "#Microsoft.Skills.Custom.AmlSkill" | "#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill" | "#Microsoft.Skills.Vision.VectorizeSkill";
325
386
  /** The name of the skill which uniquely identifies it within the skillset. A skill with no name defined will be given a default name of its 1-based index in the skills array, prefixed with the character '#'. */
326
387
  name?: string;
327
388
  /** The description of the skill which describes the inputs, outputs, and usage of the skill. */
@@ -455,6 +516,8 @@ export declare interface BaseSearchRequestOptions<TModel extends object, TFields
455
516
  * Defines options for vector search queries
456
517
  */
457
518
  vectorSearchOptions?: VectorSearchOptions<TModel>;
519
+ /** The query parameters to configure hybrid search behaviors. */
520
+ hybridSearch?: HybridSearchOptions;
458
521
  }
459
522
 
460
523
  /** Base type for token filters. */
@@ -467,7 +530,13 @@ export declare interface BaseTokenFilter {
467
530
 
468
531
  /** The query parameters for vector and hybrid search queries. */
469
532
  export declare interface BaseVectorQuery<TModel extends object> {
470
- /** Polymorphic discriminator, which specifies the different types this object can be */
533
+ /**
534
+ * ### Known values supported by the service
535
+ * **vector**: Vector query where a raw vector value is provided.
536
+ * **text**: Vector query where a text value that needs to be vectorized is provided.
537
+ * **imageUrl**: Vector query where an url that represents an image value that needs to be vectorized is provided.
538
+ * **imageBinary**: Vector query where a base 64 encoded binary of an image that needs to be vectorized is provided.
539
+ */
471
540
  kind: VectorQueryKind;
472
541
  /** Number of nearest neighbors to return as top hits. */
473
542
  kNearestNeighborsCount?: number;
@@ -486,6 +555,10 @@ export declare interface BaseVectorQuery<TModel extends object> {
486
555
  * vector field.
487
556
  */
488
557
  oversampling?: number;
558
+ /** Relative weight of the vector query when compared to other vector query and/or the text query within the same search request. This value is used when combining the results of multiple ranking lists produced by the different vector queries and/or the results retrieved through the text query. The higher the weight, the higher the documents that matched that query will be in the final ranking. Default is 1.0 and the value needs to be a positive number larger than zero. */
559
+ weight?: number;
560
+ /** The threshold used for vector queries. Note this can only be set if all 'fields' use the same similarity metric. */
561
+ threshold?: VectorThreshold;
489
562
  }
490
563
 
491
564
  /** Contains configuration options specific to the algorithm used during indexing and/or querying. */
@@ -516,6 +589,12 @@ export declare interface BaseVectorSearchVectorizer {
516
589
  name: string;
517
590
  }
518
591
 
592
+ /** The threshold used for vector queries. */
593
+ export declare interface BaseVectorThreshold {
594
+ /** Polymorphic discriminator, which specifies the different types this object can be */
595
+ kind: "vectorSimilarity" | "searchScore";
596
+ }
597
+
519
598
  export declare type BlobIndexerDataToExtract = "storageMetadata" | "allMetadata" | "contentAndMetadata";
520
599
 
521
600
  export declare type BlobIndexerImageAction = "none" | "generateNormalizedImages" | "generateNormalizedImagePerPage";
@@ -875,12 +954,12 @@ export declare interface CustomNormalizer extends BaseLexicalNormalizer {
875
954
  }
876
955
 
877
956
  /** Contains the parameters specific to generating vector embeddings via a custom endpoint. */
878
- export declare type CustomVectorizer = BaseVectorSearchVectorizer & {
957
+ export declare interface CustomVectorizer extends BaseVectorSearchVectorizer {
879
958
  /** Polymorphic discriminator, which specifies the different types this object can be */
880
959
  kind: "customWebApi";
881
960
  /** Contains the parameters specific to generating vector embeddings via a custom endpoint. */
882
961
  customVectorizerParameters?: CustomVectorizerParameters;
883
- };
962
+ }
884
963
 
885
964
  /** Contains the parameters specific to generating vector embeddings via a custom endpoint. */
886
965
  export declare interface CustomVectorizerParameters {
@@ -1374,6 +1453,24 @@ export declare interface HnswParameters {
1374
1453
  metric?: VectorSearchAlgorithmMetric;
1375
1454
  }
1376
1455
 
1456
+ /**
1457
+ * Defines values for HybridCountAndFacetMode. \
1458
+ * {@link KnownHybridCountAndFacetMode} can be used interchangeably with HybridCountAndFacetMode,
1459
+ * this enum contains the known values that the service supports.
1460
+ * ### Known values supported by the service
1461
+ * **countRetrievableResults**: Only include documents that were matched within the 'maxTextRecallSize' retrieval window when computing 'count' and 'facets'. \
1462
+ * **countAllResults**: Include all documents that were matched by the search query when computing 'count' and 'facets', regardless of whether or not those documents are within the 'maxTextRecallSize' retrieval window.
1463
+ */
1464
+ export declare type HybridCountAndFacetMode = string;
1465
+
1466
+ /** TThe query parameters to configure hybrid search behaviors. */
1467
+ export declare interface HybridSearchOptions {
1468
+ /** Determines the maximum number of documents to be retrieved by the text query portion of a hybrid search request. Those documents will be combined with the documents matching the vector queries to produce a single final list of results. Choosing a larger maxTextRecallSize value will allow retrieving and paging through more documents (using the top and skip parameters), at the cost of higher resource utilization and higher latency. The value needs to be between 1 and 10,000. Default is 1000. */
1469
+ maxTextRecallSize?: number;
1470
+ /** Determines whether the count and facets should includes all documents that matched the search query, or only the documents that are retrieved within the 'maxTextRecallSize' window. */
1471
+ countAndFacetMode?: HybridCountAndFacetMode;
1472
+ }
1473
+
1377
1474
  /** A skill that analyzes image files. It extracts a rich set of visual features based on the image content. */
1378
1475
  export declare interface ImageAnalysisSkill extends BaseSearchIndexerSkill {
1379
1476
  /** Polymorphic discriminator, which specifies the different types this object can be */
@@ -1748,6 +1845,18 @@ export declare interface KeepTokenFilter extends BaseTokenFilter {
1748
1845
  lowerCaseKeepWords?: boolean;
1749
1846
  }
1750
1847
 
1848
+ /**
1849
+ * Specifies the properties for connecting to an AML vectorizer with an authentication key.
1850
+ */
1851
+ export declare interface KeyAuthAzureMachineLearningVectorizerParameters extends BaseAzureMachineLearningVectorizerParameters {
1852
+ /** Indicates how the service should attempt to identify itself to the AML instance */
1853
+ authKind: "key";
1854
+ /** The scoring URI of the AML service to which the JSON payload will be sent. Only the https URI scheme is allowed. */
1855
+ scoringUri: string;
1856
+ /** The key for the AML service. */
1857
+ authenticationKey: string;
1858
+ }
1859
+
1751
1860
  /** A skill that uses text analytics for key phrase extraction. */
1752
1861
  export declare interface KeyPhraseExtractionSkill extends BaseSearchIndexerSkill {
1753
1862
  /** Polymorphic discriminator, which specifies the different types this object can be */
@@ -1793,6 +1902,22 @@ export declare interface KeywordTokenizer {
1793
1902
  maxTokenLength?: number;
1794
1903
  }
1795
1904
 
1905
+ /** Known values of {@link AIStudioModelCatalogName} that the service accepts. */
1906
+ export declare enum KnownAIStudioModelCatalogName {
1907
+ /** OpenAIClipImageTextEmbeddingsVitBasePatch32 */
1908
+ OpenAIClipImageTextEmbeddingsVitBasePatch32 = "OpenAI-CLIP-Image-Text-Embeddings-vit-base-patch32",
1909
+ /** OpenAIClipImageTextEmbeddingsViTLargePatch14336 */
1910
+ OpenAIClipImageTextEmbeddingsViTLargePatch14336 = "OpenAI-CLIP-Image-Text-Embeddings-ViT-Large-Patch14-336",
1911
+ /** FacebookDinoV2ImageEmbeddingsViTBase */
1912
+ FacebookDinoV2ImageEmbeddingsViTBase = "Facebook-DinoV2-Image-Embeddings-ViT-Base",
1913
+ /** FacebookDinoV2ImageEmbeddingsViTGiant */
1914
+ FacebookDinoV2ImageEmbeddingsViTGiant = "Facebook-DinoV2-Image-Embeddings-ViT-Giant",
1915
+ /** CohereEmbedV3English */
1916
+ CohereEmbedV3English = "Cohere-embed-v3-english",
1917
+ /** CohereEmbedV3Multilingual */
1918
+ CohereEmbedV3Multilingual = "Cohere-embed-v3-multilingual"
1919
+ }
1920
+
1796
1921
  /**
1797
1922
  * Defines values for AnalyzerName.
1798
1923
  * See https://docs.microsoft.com/rest/api/searchservice/Language-support
@@ -2172,6 +2297,18 @@ export declare enum KnownAnalyzerNames {
2172
2297
  Whitespace = "whitespace"
2173
2298
  }
2174
2299
 
2300
+ /** Known values of {@link AzureOpenAIModelName} that the service accepts. */
2301
+ export declare enum KnownAzureOpenAIModelName {
2302
+ /** TextEmbeddingAda002 */
2303
+ TextEmbeddingAda002 = "text-embedding-ada-002",
2304
+ /** TextEmbedding3Large */
2305
+ TextEmbedding3Large = "text-embedding-3-large",
2306
+ /** TextEmbedding3Small */
2307
+ TextEmbedding3Small = "text-embedding-3-small",
2308
+ /** Experimental */
2309
+ Experimental = "experimental"
2310
+ }
2311
+
2175
2312
  /** Known values of {@link BlobIndexerDataToExtract} that the service accepts. */
2176
2313
  export declare enum KnownBlobIndexerDataToExtract {
2177
2314
  /** Indexes just the standard blob properties and user-specified metadata. */
@@ -2324,6 +2461,14 @@ export declare enum KnownEntityRecognitionSkillLanguage {
2324
2461
  Tr = "tr"
2325
2462
  }
2326
2463
 
2464
+ /** Known values of {@link HybridCountAndFacetMode} that the service accepts. */
2465
+ export declare enum KnownHybridCountAndFacetMode {
2466
+ /** Only include documents that were matched within the 'maxTextRecallSize' retrieval window when computing 'count' and 'facets'. */
2467
+ CountRetrievableResults = "countRetrievableResults",
2468
+ /** Include all documents that were matched by the search query when computing 'count' and 'facets', regardless of whether or not those documents are within the 'maxTextRecallSize' retrieval window. */
2469
+ CountAllResults = "countAllResults"
2470
+ }
2471
+
2327
2472
  /** Known values of {@link ImageAnalysisSkillLanguage} that the service accepts. */
2328
2473
  export declare enum KnownImageAnalysisSkillLanguage {
2329
2474
  /** Arabic */
@@ -3321,7 +3466,9 @@ export declare enum KnownSearchIndexerDataSourceType {
3321
3466
  /** Indicates a MySql datasource. */
3322
3467
  MySql = "mysql",
3323
3468
  /** Indicates an ADLS Gen2 datasource. */
3324
- AdlsGen2 = "adlsgen2"
3469
+ AdlsGen2 = "adlsgen2",
3470
+ /** Indicates a Microsoft Fabric OneLake datasource. */
3471
+ OneLake = "onelake"
3325
3472
  }
3326
3473
 
3327
3474
  /** Known values of {@link SemanticErrorMode} that the service accepts. */
@@ -3954,12 +4101,22 @@ export declare enum KnownTokenizerNames {
3954
4101
  Whitespace = "whitespace"
3955
4102
  }
3956
4103
 
4104
+ /** Known values of {@link VectorEncodingFormat} that the service accepts. */
4105
+ export declare enum KnownVectorEncodingFormat {
4106
+ /** Encoding format representing bits packed into a wider data type. */
4107
+ PackedBit = "packedBit"
4108
+ }
4109
+
3957
4110
  /** Known values of {@link VectorQueryKind} that the service accepts. */
3958
4111
  export declare enum KnownVectorQueryKind {
3959
4112
  /** Vector query where a raw vector value is provided. */
3960
4113
  Vector = "vector",
3961
4114
  /** Vector query where a text value that needs to be vectorized is provided. */
3962
- Text = "text"
4115
+ Text = "text",
4116
+ /** Vector query where an url that represents an image value that needs to be vectorized is provided. */
4117
+ ImageUrl = "imageUrl",
4118
+ /** Vector query where a base 64 encoded binary of an image that needs to be vectorized is provided. */
4119
+ ImageBinary = "imageBinary"
3963
4120
  }
3964
4121
 
3965
4122
  /** Known values of {@link VectorSearchCompressionKind} that the service accepts. */
@@ -3979,7 +4136,19 @@ export declare enum KnownVectorSearchVectorizerKind {
3979
4136
  /** Generate embeddings using an Azure OpenAI resource at query time. */
3980
4137
  AzureOpenAI = "azureOpenAI",
3981
4138
  /** Generate embeddings using a custom web endpoint at query time. */
3982
- CustomWebApi = "customWebApi"
4139
+ CustomWebApi = "customWebApi",
4140
+ /** Generate embeddings for an image or text input at query time using the Azure AI Services Vision Vectorize API. */
4141
+ AIServicesVision = "aiServicesVision",
4142
+ /** Generate embeddings using an Azure Machine Learning endpoint deployed via the Azure AI Studio Model Catalog at query time. */
4143
+ AML = "aml"
4144
+ }
4145
+
4146
+ /** Known values of {@link VectorThresholdKind} that the service accepts. */
4147
+ export declare enum KnownVectorThresholdKind {
4148
+ /** The results of the vector query will be filtered based on the vector similarity metric. Note this is the canonical definition of similarity metric, not the 'distance' version. The threshold direction (larger or smaller) will be chosen automatically according to the metric used by the field. */
4149
+ VectorSimilarity = "vectorSimilarity",
4150
+ /** The results of the vector query will filter based on the '@search.score' value. Note this is the @search.score returned as part of the search response. The threshold direction will be chosen for higher @search.score. */
4151
+ SearchScore = "searchScore"
3983
4152
  }
3984
4153
 
3985
4154
  /** Known values of {@link VisualFeature} that the service accepts. */
@@ -4389,6 +4558,16 @@ export declare interface NGramTokenizer extends BaseLexicalTokenizer {
4389
4558
  tokenChars?: TokenCharacterKind[];
4390
4559
  }
4391
4560
 
4561
+ /**
4562
+ * Specifies the properties for connecting to an AML vectorizer with no authentication.
4563
+ */
4564
+ export declare interface NoAuthAzureMachineLearningVectorizerParameters extends BaseAzureMachineLearningVectorizerParameters {
4565
+ /** Indicates how the service should attempt to identify itself to the AML instance */
4566
+ authKind: "none";
4567
+ /** The scoring URI of the AML service to which the JSON payload will be sent. Only the https URI scheme is allowed. */
4568
+ scoringUri: string;
4569
+ }
4570
+
4392
4571
  /** A skill that extracts text from image files. */
4393
4572
  export declare interface OcrSkill extends BaseSearchIndexerSkill {
4394
4573
  /** Polymorphic discriminator, which specifies the different types this object can be */
@@ -5226,7 +5405,7 @@ export declare type SearchFieldArray<TModel extends object = object> = (<T>() =>
5226
5405
  * NB: `Edm.Single` alone is not a valid data type. It must be used as part of a collection type.
5227
5406
  * @readonly
5228
5407
  */
5229
- export declare type SearchFieldDataType = "Edm.String" | "Edm.Int32" | "Edm.Int64" | "Edm.Double" | "Edm.Boolean" | "Edm.DateTimeOffset" | "Edm.GeographyPoint" | "Collection(Edm.String)" | "Collection(Edm.Int32)" | "Collection(Edm.Int64)" | "Collection(Edm.Double)" | "Collection(Edm.Boolean)" | "Collection(Edm.DateTimeOffset)" | "Collection(Edm.GeographyPoint)" | "Collection(Edm.Single)" | "Collection(Edm.Half)" | "Collection(Edm.Int16)" | "Collection(Edm.SByte)";
5408
+ export declare type SearchFieldDataType = "Edm.String" | "Edm.Int32" | "Edm.Int64" | "Edm.Double" | "Edm.Boolean" | "Edm.DateTimeOffset" | "Edm.GeographyPoint" | "Collection(Edm.String)" | "Collection(Edm.Int32)" | "Collection(Edm.Int64)" | "Collection(Edm.Double)" | "Collection(Edm.Boolean)" | "Collection(Edm.DateTimeOffset)" | "Collection(Edm.GeographyPoint)" | "Collection(Edm.Single)" | "Collection(Edm.Half)" | "Collection(Edm.Int16)" | "Collection(Edm.SByte)" | "Collection(Edm.Byte)";
5230
5409
 
5231
5410
  /**
5232
5411
  * Represents a search index definition, which describes the fields and search behavior of an
@@ -5887,7 +6066,7 @@ export declare interface SearchIndexerDataSourceConnection {
5887
6066
  encryptionKey?: SearchResourceEncryptionKey;
5888
6067
  }
5889
6068
 
5890
- export declare type SearchIndexerDataSourceType = "azuresql" | "cosmosdb" | "azureblob" | "azuretable" | "mysql" | "adlsgen2";
6069
+ export declare type SearchIndexerDataSourceType = "azuresql" | "cosmosdb" | "azureblob" | "azuretable" | "mysql" | "adlsgen2" | "onelake";
5891
6070
 
5892
6071
  /** Specifies the identity for a datasource to use. */
5893
6072
  export declare interface SearchIndexerDataUserAssignedIdentity extends BaseSearchIndexerDataIdentity {
@@ -6054,7 +6233,7 @@ export declare interface SearchIndexerLimits {
6054
6233
  /**
6055
6234
  * Contains the possible cases for Skill.
6056
6235
  */
6057
- export declare type SearchIndexerSkill = AzureMachineLearningSkill | AzureOpenAIEmbeddingSkill | ConditionalSkill | CustomEntityLookupSkill | DocumentExtractionSkill | EntityLinkingSkill | EntityRecognitionSkill | EntityRecognitionSkillV3 | ImageAnalysisSkill | KeyPhraseExtractionSkill | LanguageDetectionSkill | MergeSkill | OcrSkill | PIIDetectionSkill | SentimentSkill | SentimentSkillV3 | ShaperSkill | SplitSkill | TextTranslationSkill | WebApiSkill;
6236
+ export declare type SearchIndexerSkill = AzureMachineLearningSkill | AzureOpenAIEmbeddingSkill | ConditionalSkill | CustomEntityLookupSkill | DocumentExtractionSkill | EntityLinkingSkill | EntityRecognitionSkill | EntityRecognitionSkillV3 | ImageAnalysisSkill | KeyPhraseExtractionSkill | LanguageDetectionSkill | MergeSkill | OcrSkill | PIIDetectionSkill | SentimentSkill | SentimentSkillV3 | ShaperSkill | SplitSkill | TextTranslationSkill | VisionVectorizeSkill | WebApiSkill;
6058
6237
 
6059
6238
  /**
6060
6239
  * A list of skills.
@@ -6516,6 +6695,14 @@ export declare type SearchResult<TModel extends object, TFields extends SelectFi
6516
6695
  readonly documentDebugInfo?: DocumentDebugInfo[];
6517
6696
  };
6518
6697
 
6698
+ /** The results of the vector query will filter based on the '\@search.score' value. Note this is the \@search.score returned as part of the search response. The threshold direction will be chosen for higher \@search.score. */
6699
+ export declare interface SearchScoreThreshold extends BaseVectorThreshold {
6700
+ /** Polymorphic discriminator, which specifies the different types this object can be */
6701
+ kind: "searchScore";
6702
+ /** The threshold will filter based on the '\@search.score' value. Note this is the \@search.score returned as part of the search response. The threshold direction will be chosen for higher \@search.score. */
6703
+ value: number;
6704
+ }
6705
+
6519
6706
  /**
6520
6707
  * Response from a get service statistics request. If successful, it includes service level
6521
6708
  * counters and limits.
@@ -6732,6 +6919,8 @@ export declare interface ServiceLimits {
6732
6919
  maxComplexCollectionFieldsPerIndex?: number;
6733
6920
  /** The maximum number of objects in complex collections allowed per document. */
6734
6921
  maxComplexObjectsInCollectionsPerDocument?: number;
6922
+ /** The maximum amount of storage in bytes allowed per index. */
6923
+ maxStoragePerIndex?: number;
6735
6924
  }
6736
6925
 
6737
6926
  /** A skill for reshaping the outputs. It creates a complex type to support composite fields (also known as multipart fields). */
@@ -6894,6 +7083,8 @@ export declare interface SimpleField {
6894
7083
  * optional parameters for searching the vector field.
6895
7084
  */
6896
7085
  vectorSearchProfileName?: string;
7086
+ /** The encoding format to interpret the field contents. */
7087
+ vectorSearchEncodingFormat?: VectorEncodingFormat;
6897
7088
  }
6898
7089
 
6899
7090
  /** A filter that stems words using a Snowball-generated stemmer. This token filter is implemented using Apache Lucene. */
@@ -7166,6 +7357,18 @@ export declare interface TextWeights {
7166
7357
  };
7167
7358
  }
7168
7359
 
7360
+ /**
7361
+ * Specifies the properties for connecting to an AML vectorizer with a managed identity.
7362
+ */
7363
+ export declare interface TokenAuthAzureMachineLearningVectorizerParameters extends BaseAzureMachineLearningVectorizerParameters {
7364
+ /** Indicates how the service should attempt to identify itself to the AML instance */
7365
+ authKind: "token";
7366
+ /** The Azure Resource Manager resource ID of the AML service. It should be in the format subscriptions/\{guid\}/resourceGroups/\{resource-group-name\}/Microsoft.MachineLearningServices/workspaces/\{workspace-name\}/services/\{service_name\}. */
7367
+ resourceId: string;
7368
+ /** The region the AML service is deployed in. */
7369
+ region?: string;
7370
+ }
7371
+
7169
7372
  /** Defines values for TokenCharacterKind. */
7170
7373
  export declare type TokenCharacterKind = "letter" | "digit" | "whitespace" | "punctuation" | "symbol";
7171
7374
 
@@ -7247,14 +7450,39 @@ export declare interface UniqueTokenFilter extends BaseTokenFilter {
7247
7450
  */
7248
7451
  export declare type UploadDocumentsOptions = IndexDocumentsOptions;
7249
7452
 
7453
+ /**
7454
+ * Defines values for VectorEncodingFormat. \
7455
+ * {@link KnownVectorEncodingFormat} can be used interchangeably with VectorEncodingFormat,
7456
+ * this enum contains the known values that the service supports.
7457
+ * ### Known values supported by the service
7458
+ * **packedBit**: Encoding format representing bits packed into a wider data type.
7459
+ */
7460
+ export declare type VectorEncodingFormat = string;
7461
+
7250
7462
  export declare type VectorFilterMode = "postFilter" | "preFilter";
7251
7463
 
7464
+ /** The query parameters to use for vector search when a base 64 encoded binary of an image that needs to be vectorized is provided. */
7465
+ export declare interface VectorizableImageBinaryQuery<TModel extends object> extends BaseVectorQuery<TModel> {
7466
+ /** Polymorphic discriminator, which specifies the different types this object can be */
7467
+ kind: "imageBinary";
7468
+ /** The base64 encoded binary of an image to be vectorized to perform a vector search query. */
7469
+ binaryImage: string;
7470
+ }
7471
+
7472
+ /** The query parameters to use for vector search when an url that represents an image value that needs to be vectorized is provided. */
7473
+ export declare interface VectorizableImageUrlQuery<TModel extends object> extends BaseVectorQuery<TModel> {
7474
+ /** Polymorphic discriminator, which specifies the different types this object can be */
7475
+ kind: "imageUrl";
7476
+ /** The URL of an image to be vectorized to perform a vector search query. */
7477
+ url: string;
7478
+ }
7479
+
7252
7480
  /** The query parameters to use for vector search when a text value that needs to be vectorized is provided. */
7253
7481
  export declare interface VectorizableTextQuery<TModel extends object> extends BaseVectorQuery<TModel> {
7254
7482
  /** Polymorphic discriminator, which specifies the different types this object can be */
7255
7483
  kind: "text";
7256
7484
  /** The text to be vectorized to perform a vector search query. */
7257
- text?: string;
7485
+ text: string;
7258
7486
  }
7259
7487
 
7260
7488
  /** The query parameters to use for vector search when a raw vector value is provided. */
@@ -7266,9 +7494,9 @@ export declare interface VectorizedQuery<TModel extends object> extends BaseVect
7266
7494
  }
7267
7495
 
7268
7496
  /** The query parameters for vector and hybrid search queries. */
7269
- export declare type VectorQuery<TModel extends object> = VectorizedQuery<TModel> | VectorizableTextQuery<TModel>;
7497
+ export declare type VectorQuery<TModel extends object> = VectorizedQuery<TModel> | VectorizableTextQuery<TModel> | VectorizableImageUrlQuery<TModel> | VectorizableImageBinaryQuery<TModel>;
7270
7498
 
7271
- export declare type VectorQueryKind = "vector" | "text";
7499
+ export declare type VectorQueryKind = "vector" | "text" | "imageUrl" | "imageBinary";
7272
7500
 
7273
7501
  /** Contains configuration options related to vector search. */
7274
7502
  export declare interface VectorSearch {
@@ -7290,7 +7518,7 @@ export declare type VectorSearchAlgorithmConfiguration = HnswAlgorithmConfigurat
7290
7518
 
7291
7519
  export declare type VectorSearchAlgorithmKind = "hnsw" | "exhaustiveKnn";
7292
7520
 
7293
- export declare type VectorSearchAlgorithmMetric = "cosine" | "euclidean" | "dotProduct";
7521
+ export declare type VectorSearchAlgorithmMetric = "cosine" | "euclidean" | "dotProduct" | "hamming";
7294
7522
 
7295
7523
  /**
7296
7524
  * Contains configuration options specific to the compression method used during indexing or
@@ -7344,9 +7572,28 @@ export declare interface VectorSearchProfile {
7344
7572
  }
7345
7573
 
7346
7574
  /** Contains configuration options on how to vectorize text vector queries. */
7347
- export declare type VectorSearchVectorizer = AzureOpenAIVectorizer | CustomVectorizer;
7575
+ export declare type VectorSearchVectorizer = AzureOpenAIVectorizer | CustomVectorizer | AIServicesVisionVectorizer | AzureMachineLearningVectorizer;
7576
+
7577
+ export declare type VectorSearchVectorizerKind = "azureOpenAI" | "customWebApi" | "aiServicesVision" | "aml";
7578
+
7579
+ /** The results of the vector query will be filtered based on the vector similarity metric. Note this is the canonical definition of similarity metric, not the 'distance' version. The threshold direction (larger or smaller) will be chosen automatically according to the metric used by the field. */
7580
+ export declare interface VectorSimilarityThreshold extends BaseVectorThreshold {
7581
+ /** Polymorphic discriminator, which specifies the different types this object can be */
7582
+ kind: "vectorSimilarity";
7583
+ /** The threshold will filter based on the similarity metric value. Note this is the canonical definition of similarity metric, not the 'distance' version. The threshold direction (larger or smaller) will be chosen automatically according to the metric used by the field. */
7584
+ value: number;
7585
+ }
7586
+
7587
+ /** The threshold used for vector queries. */
7588
+ export declare type VectorThreshold = VectorSimilarityThreshold | SearchScoreThreshold;
7348
7589
 
7349
- export declare type VectorSearchVectorizerKind = "azureOpenAI" | "customWebApi";
7590
+ /** Allows you to generate a vector embedding for a given image or text input using the Azure AI Services Vision Vectorize API. */
7591
+ export declare interface VisionVectorizeSkill extends BaseSearchIndexerSkill {
7592
+ /** Polymorphic discriminator, which specifies the different types this object can be */
7593
+ odatatype: "#Microsoft.Skills.Vision.VectorizeSkill";
7594
+ /** The version of the model to use when calling the AI Services Vision service. It will default to the latest available when not specified. */
7595
+ modelVersion?: string;
7596
+ }
7350
7597
 
7351
7598
  export declare type VisualFeature = "adult" | "brands" | "categories" | "description" | "faces" | "objects" | "tags";
7352
7599
 
@@ -1,5 +0,0 @@
1
- "use strict";
2
- // Copyright (c) Microsoft Corporation.
3
- // Licensed under the MIT license.
4
- const SDK_VERSION = "12.1.0-beta.2";
5
- //# sourceMappingURL=constants.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";AAAA,uCAAuC;AACvC,kCAAkC;AAElC,MAAM,WAAW,GAAW,eAAe,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation.\n// Licensed under the MIT license.\n\nconst SDK_VERSION: string = \"12.1.0-beta.2\";\n"]}