@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.
- package/dist/index.js +626 -216
- package/dist/index.js.map +1 -1
- package/dist-esm/src/generated/data/models/index.js +42 -22
- package/dist-esm/src/generated/data/models/index.js.map +1 -1
- package/dist-esm/src/generated/data/models/mappers.js +127 -0
- package/dist-esm/src/generated/data/models/mappers.js.map +1 -1
- package/dist-esm/src/generated/data/models/parameters.js +74 -74
- package/dist-esm/src/generated/data/models/parameters.js.map +1 -1
- package/dist-esm/src/generated/data/operations/documents.js +8 -8
- package/dist-esm/src/generated/data/operations/documents.js.map +1 -1
- package/dist-esm/src/generated/data/searchClient.js.map +1 -1
- package/dist-esm/src/generated/service/models/index.js +53 -9
- package/dist-esm/src/generated/service/models/index.js.map +1 -1
- package/dist-esm/src/generated/service/models/mappers.js +159 -16
- package/dist-esm/src/generated/service/models/mappers.js.map +1 -1
- package/dist-esm/src/generated/service/searchServiceClient.js.map +1 -1
- package/dist-esm/src/generatedStringLiteralUnions.js.map +1 -1
- package/dist-esm/src/index.js +2 -2
- package/dist-esm/src/index.js.map +1 -1
- package/dist-esm/src/indexModels.js.map +1 -1
- package/dist-esm/src/searchClient.js +2 -5
- package/dist-esm/src/searchClient.js.map +1 -1
- package/dist-esm/src/searchIndexingBufferedSender.js +2 -1
- package/dist-esm/src/searchIndexingBufferedSender.js.map +1 -1
- package/dist-esm/src/serialization.js +34 -70
- package/dist-esm/src/serialization.js.map +1 -1
- package/dist-esm/src/serviceModels.js.map +1 -1
- package/dist-esm/src/serviceUtils.js +38 -12
- package/dist-esm/src/serviceUtils.js.map +1 -1
- package/dist-esm/src/walk.js +79 -0
- package/dist-esm/src/walk.js.map +1 -0
- package/package.json +9 -9
- package/types/search-documents.d.ts +275 -28
- package/dist-esm/src/constants.js +0 -5
- 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
|
-
/**
|
|
218
|
-
export declare interface
|
|
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
|
|
222
|
-
|
|
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
|
|
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
|
-
/**
|
|
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
|
|
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
|
|
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
|
-
|
|
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 +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"]}
|