@azure/search-documents 12.2.0-beta.1 → 12.2.0-beta.2

package/types/search-documents.d.ts

@@ -1,13 +1,33 @@
 /// <reference lib="esnext.asynciterable" />
 
 import { AzureKeyCredential } from '@azure/core-auth';
-import { ExtendedCommonClientOptions } from '@azure/core-http-compat';
-import { KeyCredential } from '@azure/core-auth';
-import { OperationOptions } from '@azure/core-client';
-import { PagedAsyncIterableIterator } from '@azure/core-paging';
-import { Pipeline } from '@azure/core-rest-pipeline';
-import { RestError } from '@azure/core-rest-pipeline';
-import { TokenCredential } from '@azure/core-auth';
+import type { ExtendedCommonClientOptions } from '@azure/core-http-compat';
+import type { KeyCredential } from '@azure/core-auth';
+import type { OperationOptions } from '@azure/core-client';
+import type { PagedAsyncIterableIterator } from '@azure/core-paging';
+import type { Pipeline } from '@azure/core-rest-pipeline';
+import type { RestError } from '@azure/core-rest-pipeline';
+import type { TokenCredential } from '@azure/core-auth';
+
+/** The multi-region account of an Azure AI service resource that's attached to a skillset. */
+export declare interface AIServicesAccountIdentity extends BaseCognitiveServicesAccount {
+    /** Polymorphic discriminator, which specifies the different types this object can be */
+    odatatype: "#Microsoft.Azure.Search.AIServicesByIdentity";
+    /** The user-assigned managed identity used for connections to AI Service. If not specified, the system-assigned managed identity is used. On updates to the skillset, if the identity is unspecified, the value remains unchanged. If set to "none", the value of this property is cleared. */
+    identity?: SearchIndexerDataIdentity;
+    /** The subdomain url for the corresponding AI Service. */
+    subdomainUrl: string;
+}
+
+/** The account key of an Azure AI service resource that's attached to a skillset, to be used with the resource's subdomain. */
+export declare interface AIServicesAccountKey extends BaseCognitiveServicesAccount {
+    /** Polymorphic discriminator, which specifies the different types this object can be */
+    odatatype: "#Microsoft.Azure.Search.AIServicesByKey";
+    /** The key used to provision the Azure AI service resource attached to a skillset. */
+    key: string;
+    /** The subdomain url for the corresponding AI Service. */
+    subdomainUrl: string;
+}
 
 /** Specifies the AI Services Vision parameters for vectorizing a query image or text. */
 export declare interface AIServicesVisionParameters {
@@ -326,7 +346,7 @@ export declare interface BaseCharFilter {
 /** Base type for describing any Azure AI service resource attached to a skillset. */
 export declare interface BaseCognitiveServicesAccount {
     /** Polymorphic discriminator, which specifies the different types this object can be */
-    odatatype: "#Microsoft.Azure.Search.DefaultCognitiveServices" | "#Microsoft.Azure.Search.CognitiveServicesByKey";
+    odatatype: "#Microsoft.Azure.Search.DefaultCognitiveServices" | "#Microsoft.Azure.Search.CognitiveServicesByKey" | "#Microsoft.Azure.Search.AIServicesByKey" | "#Microsoft.Azure.Search.AIServicesByIdentity";
     /** Description of the Azure AI service resource attached to a skillset. */
     description?: string;
 }
@@ -388,7 +408,7 @@ export declare interface BaseSearchIndexerDataIdentity {
 /** Base type for skills. */
 export declare interface BaseSearchIndexerSkill {
     /** Polymorphic discriminator, which specifies the different types this object can be */
-    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";
+    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.Util.DocumentIntelligenceLayoutSkill" | "#Microsoft.Skills.Custom.WebApiSkill" | "#Microsoft.Skills.Custom.AmlSkill" | "#Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill" | "#Microsoft.Skills.Vision.VectorizeSkill";
     /** 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 '#'. */
     name?: string;
     /** The description of the skill which describes the inputs, outputs, and usage of the skill. */
@@ -480,7 +500,7 @@ export declare interface BaseSearchRequestOptions<TModel extends object, TFields
     /**
      * Improve search recall by spell-correcting individual search query terms.
      */
-    speller?: Speller;
+    speller?: QuerySpeller;
     /**
      * A value that specifies whether any or all of the search terms must be matched in order to
      * count the document as a match. Possible values include: 'any', 'all'
@@ -588,6 +608,8 @@ export declare interface BaseVectorSearchCompression {
     rerankWithOriginalVectors?: boolean;
     /** Default oversampling factor. Oversampling will internally request more documents (specified by this multiplier) in the initial search. This increases the set of results that will be reranked using recomputed similarity scores from full-precision vectors. Minimum value is 1, meaning no oversampling (1x). This parameter can only be set when rerankWithOriginalVectors is true. Higher values improve recall at the expense of latency. */
     defaultOversampling?: number;
+    /** Contains the options for rescoring. */
+    rescoringOptions?: RescoringOptions;
     /** The number of dimensions to truncate the vectors to. Truncating the vectors reduces the size of the vectors and the amount of data that needs to be transferred during search. This can save storage cost and improve search performance at the expense of recall. It should be only used for embeddings trained with Matryoshka Representation Learning (MRL) such as OpenAI text-embedding-3-large (small). The default value is null, which means no truncation. */
     truncationDimension?: number;
 }
@@ -674,7 +696,7 @@ export declare interface ClassicTokenizer extends BaseLexicalTokenizer {
 /**
  * Contains the possible cases for CognitiveServicesAccount.
  */
-export declare type CognitiveServicesAccount = DefaultCognitiveServicesAccount | CognitiveServicesAccountKey;
+export declare type CognitiveServicesAccount = DefaultCognitiveServicesAccount | CognitiveServicesAccountKey | AIServicesAccountKey | AIServicesAccountIdentity;
 
 /** The multi-region account key of an Azure AI service resource that's attached to a skillset. */
 export declare interface CognitiveServicesAccountKey extends BaseCognitiveServicesAccount {
@@ -980,6 +1002,15 @@ export declare type DataChangeDetectionPolicy = HighWaterMarkChangeDetectionPoli
  */
 export declare type DataDeletionDetectionPolicy = SoftDeleteColumnDeletionDetectionPolicy | NativeBlobSoftDeleteDeletionDetectionPolicy;
 
+/** Contains debugging information that can be used to further explore your search results. */
+export declare interface DebugInfo {
+    /**
+     * Contains debugging information specific to query rewrites.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly queryRewrites?: QueryRewritesDebugInfo;
+}
+
 /**
  * Default Batch Size
  */
@@ -1126,6 +1157,39 @@ export declare interface DocumentExtractionSkill extends BaseSearchIndexerSkill
     };
 }
 
+/** A skill that extracts content and layout information (as markdown), via Azure AI Services, from files within the enrichment pipeline. */
+export declare interface DocumentIntelligenceLayoutSkill extends BaseSearchIndexerSkill {
+    /** Polymorphic discriminator, which specifies the different types this object can be */
+    odatatype: "#Microsoft.Skills.Util.DocumentIntelligenceLayoutSkill";
+    /** Controls the cardinality of the output produced by the skill. Default is 'oneToMany'. */
+    outputMode?: DocumentIntelligenceLayoutSkillOutputMode;
+    /** The depth of headers in the markdown output. Default is h6. */
+    markdownHeaderDepth?: DocumentIntelligenceLayoutSkillMarkdownHeaderDepth;
+}
+
+/**
+ * Defines values for DocumentIntelligenceLayoutSkillMarkdownHeaderDepth. \
+ * {@link KnownDocumentIntelligenceLayoutSkillMarkdownHeaderDepth} can be used interchangeably with DocumentIntelligenceLayoutSkillMarkdownHeaderDepth,
+ *  this enum contains the known values that the service supports.
+ * ### Known values supported by the service
+ * **h1**: Header level 1. \
+ * **h2**: Header level 2. \
+ * **h3**: Header level 3. \
+ * **h4**: Header level 4. \
+ * **h5**: Header level 5. \
+ * **h6**: Header level 6.
+ */
+export declare type DocumentIntelligenceLayoutSkillMarkdownHeaderDepth = string;
+
+/**
+ * Defines values for DocumentIntelligenceLayoutSkillOutputMode. \
+ * {@link KnownDocumentIntelligenceLayoutSkillOutputMode} can be used interchangeably with DocumentIntelligenceLayoutSkillOutputMode,
+ *  this enum contains the known values that the service supports.
+ * ### Known values supported by the service
+ * **oneToMany**: Specify the deepest markdown header section to parse.
+ */
+export declare type DocumentIntelligenceLayoutSkillOutputMode = string;
+
 /**
  * Generates n-grams of the given size(s) starting from the front or the back of an input token.
  * This token filter is implemented using Apache Lucene.
@@ -1262,12 +1326,20 @@ export declare interface ExtractiveQueryAnswer {
      * The confidence threshold. Default threshold is 0.7
      */
     threshold?: number;
+    /**
+     * An optional upper bound on the number of characters in each answer.
+     */
+    maxAnswerLength?: number;
 }
 
 /** Extracts captions from the matching documents that contain passages relevant to the search query. */
 export declare interface ExtractiveQueryCaption {
     captionType: "extractive";
     highlight?: boolean;
+    /**
+     * An optional upper bound on the number of characters in each caption.
+     */
+    maxCaptionLength?: number;
 }
 
 /** A single bucket of a facet query result. Reports the number of documents with a field value falling within a particular range or having a particular value or interval. */
@@ -1279,6 +1351,13 @@ export declare interface FacetResult {
      * NOTE: This property will not be serialized. It can only be populated by the server.
      */
     readonly count?: number;
+    /**
+     * The nested facet query results for the search operation, organized as a collection of buckets for each faceted field; null if the query did not contain any nested facets.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly facets?: {
+        [propertyName: string]: FacetResult[];
+    };
 }
 
 /** Defines a mapping between a field in a data source and a target field in an index. */
@@ -1315,6 +1394,14 @@ export declare interface FreshnessScoringParameters {
     boostingDuration: string;
 }
 
+/** Generate alternative query terms to increase the recall of a search request. */
+export declare interface GenerativeQueryRewrites {
+    /** Polymorphic discriminator, which specifies the different types this object can be */
+    rewritesType: "generative";
+    /** The number of query rewrites to generate. Defaults to 10.*/
+    count?: number;
+}
+
 /**
  * Represents a geographic point in global coordinates.
  */
@@ -1741,7 +1828,7 @@ export declare interface IndexingParametersConfiguration {
     failOnUnsupportedContentType?: boolean;
     /** For Azure blobs, set to false if you want to continue indexing if a document fails indexing. */
     failOnUnprocessableDocument?: boolean;
-    /** For Azure blobs, set this property to true to still index storage metadata for blob content that is too large to process. Oversized blobs are treated as errors by default. For limits on blob size, see https://docs.microsoft.com/azure/search/search-limits-quotas-capacity. */
+    /** For Azure blobs, set this property to true to still index storage metadata for blob content that is too large to process. Oversized blobs are treated as errors by default. For limits on blob size, see https://learn.microsoft.com/azure/search/search-limits-quotas-capacity. */
     indexStorageMetadataOnlyForOversizedDocuments?: boolean;
     /** For CSV blobs, specifies a comma-delimited list of column headers, useful for mapping source fields to destination fields in an index. */
     delimitedTextHeaders?: string;
@@ -1749,6 +1836,10 @@ export declare interface IndexingParametersConfiguration {
     delimitedTextDelimiter?: string;
     /** For CSV blobs, indicates that the first (non-blank) line of each blob contains headers. */
     firstLineContainsHeaders?: boolean;
+    /** Specifies the submode that will determine whether a markdown file will be parsed into exactly one search document or multiple search documents. Default is `oneToMany`. */
+    markdownParsingSubmode?: MarkdownParsingSubmode;
+    /** Specifies the max header depth that will be considered while grouping markdown content. Default is `h6`. */
+    markdownHeaderDepth?: MarkdownHeaderDepth;
     /** For JSON arrays, given a structured or semi-structured document, you can specify a path to the array using this property. */
     documentRoot?: string;
     /** Specifies the data to extract from Azure blob storage and tells the indexer which data to extract from image content when "imageAction" is set to a value other than "none".  This applies to embedded image content in a .PDF or other application, or image files such as .jpg and .png, in Azure blobs. */
@@ -2338,7 +2429,9 @@ export declare enum KnownBlobIndexerParsingMode {
     /** Set to jsonArray to extract individual elements of a JSON array as separate documents. */
     JsonArray = "jsonArray",
     /** Set to jsonLines to extract individual JSON entities, separated by a new line, as separate documents. */
-    JsonLines = "jsonLines"
+    JsonLines = "jsonLines",
+    /** Set to markdown to extract content from markdown files. */
+    Markdown = "markdown"
 }
 
 /** Known values of {@link BlobIndexerPDFTextRotationAlgorithm} that the service accepts. */
@@ -2383,6 +2476,28 @@ export declare enum KnownCustomEntityLookupSkillLanguage {
     Pt = "pt"
 }
 
+/** Known values of {@link DocumentIntelligenceLayoutSkillMarkdownHeaderDepth} that the service accepts. */
+export declare enum KnownDocumentIntelligenceLayoutSkillMarkdownHeaderDepth {
+    /** Header level 1. */
+    H1 = "h1",
+    /** Header level 2. */
+    H2 = "h2",
+    /** Header level 3. */
+    H3 = "h3",
+    /** Header level 4. */
+    H4 = "h4",
+    /** Header level 5. */
+    H5 = "h5",
+    /** Header level 6. */
+    H6 = "h6"
+}
+
+/** Known values of {@link DocumentIntelligenceLayoutSkillOutputMode} that the service accepts. */
+export declare enum KnownDocumentIntelligenceLayoutSkillOutputMode {
+    /** Specify the deepest markdown header section to parse. */
+    OneToMany = "oneToMany"
+}
+
 /** Known values of {@link EntityCategory} that the service accepts. */
 export declare enum KnownEntityCategory {
     /** Entities describing a physical location. */
@@ -2847,6 +2962,30 @@ declare enum KnownLexicalNormalizerName {
 export { KnownLexicalNormalizerName }
 export { KnownLexicalNormalizerName as KnownNormalizerNames }
 
+/** Known values of {@link MarkdownHeaderDepth} that the service accepts. */
+export declare enum KnownMarkdownHeaderDepth {
+    /** Indicates that headers up to a level of h1 will be considered while grouping markdown content. */
+    H1 = "h1",
+    /** Indicates that headers up to a level of h2 will be considered while grouping markdown content. */
+    H2 = "h2",
+    /** Indicates that headers up to a level of h3 will be considered while grouping markdown content. */
+    H3 = "h3",
+    /** Indicates that headers up to a level of h4 will be considered while grouping markdown content. */
+    H4 = "h4",
+    /** Indicates that headers up to a level of h5 will be considered while grouping markdown content. */
+    H5 = "h5",
+    /** Indicates that headers up to a level of h6 will be considered while grouping markdown content. This is the default. */
+    H6 = "h6"
+}
+
+/** Known values of {@link MarkdownParsingSubmode} that the service accepts. */
+export declare enum KnownMarkdownParsingSubmode {
+    /** Indicates that each section of the markdown file (up to a specified depth) will be parsed into individual search documents. This can result in a single markdown file producing multiple search documents. This is the default sub-mode. */
+    OneToMany = "oneToMany",
+    /** Indicates that each markdown file will be parsed into a single search document. */
+    OneToOne = "oneToOne"
+}
+
 /** Known values of {@link OcrLineEnding} that the service accepts. */
 export declare enum KnownOcrLineEnding {
     /** Lines are separated by a single space character. */
@@ -3216,7 +3355,13 @@ export declare enum KnownQueryDebugMode {
     /** No query debugging information will be returned. */
     Disabled = "disabled",
     /** Allows the user to further explore their reranked results. */
-    Semantic = "semantic"
+    Semantic = "semantic",
+    /** Allows the user to further explore their hybrid and vector query results. */
+    Vector = "vector",
+    /** Allows the user to explore the list of query rewrites generated for their search request. */
+    QueryRewrites = "queryRewrites",
+    /** Turn on all debug options. */
+    All = "all"
 }
 
 /** Known values of {@link QueryLanguage} that the service accepts. */
@@ -3368,7 +3513,7 @@ export declare enum KnownQueryLanguage {
 }
 
 /** Known values of {@link QuerySpellerType} that the service accepts. */
-export declare enum KnownQuerySpellerType {
+export declare enum KnownQuerySpeller {
     /** Speller not enabled. */
     None = "none",
     /** Speller corrects individual query terms using a static lexicon for the language specified by the queryLanguage parameter. */
@@ -3489,6 +3634,12 @@ export declare enum KnownSemanticFieldState {
     Partial = "partial"
 }
 
+/** Known values of {@link SemanticQueryRewritesResultType} that the service accepts. */
+export declare enum KnownSemanticQueryRewritesResultType {
+    /** Query rewrites were not successfully generated for this request. Only the original query was used to retrieve the results. */
+    OriginalQueryOnly = "originalQueryOnly"
+}
+
 /** Known values of {@link SemanticSearchResultsType} that the service accepts. */
 export declare enum KnownSemanticSearchResultsType {
     /** Results without any semantic enrichment or reranking. */
@@ -3531,14 +3682,6 @@ export declare enum KnownSentimentSkillLanguage {
     Tr = "tr"
 }
 
-/** Known values of {@link Speller} that the service accepts. */
-export declare enum KnownSpeller {
-    /** Speller not enabled. */
-    None = "none",
-    /** Speller corrects individual query terms using a static lexicon for the language specified by the queryLanguage parameter. */
-    Lexicon = "lexicon"
-}
-
 /** Known values of {@link SplitSkillEncoderModelName} that the service accepts. */
 export declare enum KnownSplitSkillEncoderModelName {
     /** Refers to a base model trained with a 50,000 token vocabulary, often used in general natural language processing tasks. */
@@ -4093,6 +4236,14 @@ export declare enum KnownVectorSearchCompressionKind {
     BinaryQuantization = "binaryQuantization"
 }
 
+/** Known values of {@link VectorSearchCompressionRescoreStorageMethod} that the service accepts. */
+export declare enum KnownVectorSearchCompressionRescoreStorageMethod {
+    /** This option preserves the original full-precision vectors. Choose this option for maximum flexibility and highest quality of compressed search results. This consumes more storage but allows for rescoring and oversampling. */
+    PreserveOriginals = "preserveOriginals",
+    /** This option discards the original full-precision vectors. Choose this option for maximum storage savings. Since this option does not allow for rescoring and oversampling, it will often cause slight to moderate reductions in quality. */
+    DiscardOriginals = "discardOriginals"
+}
+
 /** Known values of {@link VectorSearchCompressionTarget} that the service accepts. */
 export declare enum KnownVectorSearchCompressionTarget {
     /** Int8 */
@@ -4416,6 +4567,30 @@ export declare interface MappingCharFilter extends BaseCharFilter {
     mappings: string[];
 }
 
+/**
+ * Defines values for MarkdownHeaderDepth. \
+ * {@link KnownMarkdownHeaderDepth} can be used interchangeably with MarkdownHeaderDepth,
+ *  this enum contains the known values that the service supports.
+ * ### Known values supported by the service
+ * **h1**: Indicates that headers up to a level of h1 will be considered while grouping markdown content. \
+ * **h2**: Indicates that headers up to a level of h2 will be considered while grouping markdown content. \
+ * **h3**: Indicates that headers up to a level of h3 will be considered while grouping markdown content. \
+ * **h4**: Indicates that headers up to a level of h4 will be considered while grouping markdown content. \
+ * **h5**: Indicates that headers up to a level of h5 will be considered while grouping markdown content. \
+ * **h6**: Indicates that headers up to a level of h6 will be considered while grouping markdown content. This is the default.
+ */
+export declare type MarkdownHeaderDepth = string;
+
+/**
+ * Defines values for MarkdownParsingSubmode. \
+ * {@link KnownMarkdownParsingSubmode} can be used interchangeably with MarkdownParsingSubmode,
+ *  this enum contains the known values that the service supports.
+ * ### Known values supported by the service
+ * **oneToMany**: Indicates that each section of the markdown file (up to a specified depth) will be parsed into individual search documents. This can result in a single markdown file producing multiple search documents. This is the default sub-mode. \
+ * **oneToOne**: Indicates that each markdown file will be parsed into a single search document.
+ */
+export declare type MarkdownParsingSubmode = string;
+
 /**
  * Options for the merge documents operation.
  */
@@ -4783,7 +4958,10 @@ export declare interface QueryCaptionResult {
  *  this enum contains the known values that the service supports.
  * ### Known values supported by the service
  * **disabled**: No query debugging information will be returned. \
- * **semantic**: Allows the user to further explore their reranked results.
+ * **semantic**: Allows the user to further explore their reranked results. \
+ * **vector**: Allows the user to further explore their hybrid and vector query results. \
+ * **queryRewrites**: Allows the user to explore the list of query rewrites generated for their search request. \
+ * **all**: Turn on all debug options.
  */
 export declare type QueryDebugMode = string;
 
@@ -4921,6 +5099,37 @@ export declare interface QueryResultDocumentSubscores {
     readonly documentBoost?: number;
 }
 
+/** Defines options for query rewrites. */
+export declare type QueryRewrites = GenerativeQueryRewrites;
+
+/** Contains debugging information specific to query rewrites. */
+export declare interface QueryRewritesDebugInfo {
+    /**
+     * List of query rewrites generated for the text query.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly text?: QueryRewritesValuesDebugInfo;
+    /**
+     * List of query rewrites generated for the vectorizable text queries.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly vectors?: QueryRewritesValuesDebugInfo[];
+}
+
+/** Contains debugging information specific to query rewrites. */
+export declare interface QueryRewritesValuesDebugInfo {
+    /**
+     * The input text to the generative query rewriting model. There may be cases where the user query and the input to the generative model are not identical.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly inputQuery?: string;
+    /**
+     * List of query rewrites.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly rewrites?: string[];
+}
+
 /**
  * Defines values for QuerySpellerType. \
  * {@link KnownQuerySpellerType} can be used interchangeably with QuerySpellerType,
@@ -4929,13 +5138,23 @@ export declare interface QueryResultDocumentSubscores {
  * **none**: Speller not enabled. \
  * **lexicon**: Speller corrects individual query terms using a static lexicon for the language specified by the queryLanguage parameter.
  */
-export declare type QuerySpellerType = string;
+export declare type QuerySpeller = string;
 
 /** Defines values for QueryType. */
 export declare type QueryType = "simple" | "full" | "semantic";
 
 export declare type RegexFlags = `${KnownRegexFlags}`;
 
+/** Contains the options for rescoring. */
+export declare interface RescoringOptions {
+    /** If set to true, after the initial search on the compressed vectors, the similarity scores are recalculated using the full-precision vectors. This will improve recall at the expense of latency. */
+    enableRescoring?: boolean;
+    /** Default oversampling factor. Oversampling retrieves a greater set of potential documents to offset the resolution loss due to quantization. This increases the set of results that will be rescored on full-precision vectors. Minimum value is 1, meaning no oversampling (1x). This parameter can only be set when 'enableRescoring' is true. Higher values improve recall at the expense of latency. */
+    defaultOversampling?: number;
+    /** Controls the storage method for original vectors. This setting is immutable. */
+    rescoreStorageMethod?: VectorSearchCompressionRescoreStorageMethod;
+}
+
 /**
  * Options for reset docs operation.
  */
@@ -5279,6 +5498,7 @@ export declare class SearchClient<TModel extends object> implements IndexDocumen
     private convertQueryAnswers;
     private convertQueryCaptions;
     private convertVectorQuery;
+    private convertQueryRewrites;
 }
 
 /**
@@ -5361,6 +5581,11 @@ export declare interface SearchDocumentsResultBase {
      * NOTE: This property will not be serialized. It can only be populated by the server.
      */
     readonly answers?: QueryAnswerResult[];
+    /**
+     * Debug information that applies to the search results as a whole.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly debugInfo?: DebugInfo;
     /**
      * Reason that a partial response was returned for a semantic search request.
      * NOTE: This property will not be serialized. It can only be populated by the server.
@@ -5371,6 +5596,11 @@ export declare interface SearchDocumentsResultBase {
      * NOTE: This property will not be serialized. It can only be populated by the server.
      */
     readonly semanticSearchResultsType?: SemanticSearchResultsType;
+    /**
+     * Type of query rewrite that was used to retrieve documents.
+     * NOTE: This property will not be serialized. It can only be populated by the server.
+     */
+    readonly semanticQueryRewritesResultType?: SemanticQueryRewritesResultType;
 }
 
 /**
@@ -6252,7 +6482,7 @@ export declare interface SearchIndexerLimits {
 /**
  * Contains the possible cases for Skill.
  */
-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;
+export declare type SearchIndexerSkill = AzureMachineLearningSkill | AzureOpenAIEmbeddingSkill | ConditionalSkill | CustomEntityLookupSkill | DocumentExtractionSkill | DocumentIntelligenceLayoutSkill | EntityLinkingSkill | EntityRecognitionSkill | EntityRecognitionSkillV3 | ImageAnalysisSkill | KeyPhraseExtractionSkill | LanguageDetectionSkill | MergeSkill | OcrSkill | PIIDetectionSkill | SentimentSkill | SentimentSkillV3 | ShaperSkill | SplitSkill | TextTranslationSkill | VisionVectorizeSkill | WebApiSkill;
 
 /**
  * A list of skills.
@@ -6711,7 +6941,7 @@ export declare type SearchResult<TModel extends object, TFields extends SelectFi
      * Contains debugging information that can be used to further explore your search results.
      * NOTE: This property will not be serialized. It can only be populated by the server.
      */
-    readonly documentDebugInfo?: DocumentDebugInfo[];
+    readonly documentDebugInfo?: DocumentDebugInfo;
 };
 
 /** 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. */
@@ -6825,6 +7055,15 @@ export declare interface SemanticPrioritizedFields {
     keywordsFields?: SemanticField[];
 }
 
+/**
+ * Defines values for SemanticQueryRewritesResultType. \
+ * {@link KnownSemanticQueryRewritesResultType} can be used interchangeably with SemanticQueryRewritesResultType,
+ *  this enum contains the known values that the service supports.
+ * ### Known values supported by the service
+ * **originalQueryOnly**: Query rewrites were not successfully generated for this request. Only the original query was used to retrieve the results.
+ */
+export declare type SemanticQueryRewritesResultType = string;
+
 /** Defines parameters for a search index that influence semantic capabilities. */
 export declare interface SemanticSearch {
     /** Allows you to set the name of a default semantic configuration in your index, making it optional to pass it on as a query parameter every time. */
@@ -6862,6 +7101,11 @@ export declare interface SemanticSearchOptions {
      * to 'None'.
      */
     captions?: QueryCaption;
+    /**
+     * When QueryRewrites is set to `generative`, the query terms are sent to a generate model which will
+     * produce 10 (default) rewrites to help increase the recall of the request. Defaults to `none`.
+     */
+    queryRewrites?: QueryRewrites;
     /**
      * Allows setting a separate search query that will be solely used for semantic reranking,
      * semantic captions and semantic answers. Is useful for scenarios where there is a need to use
@@ -7140,16 +7384,6 @@ export declare interface SoftDeleteColumnDeletionDetectionPolicy extends BaseDat
     softDeleteMarkerValue?: string;
 }
 
-/**
- * Defines values for Speller. \
- * {@link KnownSpeller} can be used interchangeably with Speller,
- *  this enum contains the known values that the service supports.
- * ### Known values supported by the service
- * **none**: Speller not enabled. \
- * **lexicon**: Speller corrects individual query terms using a static lexicon for the language specified by the queryLanguage parameter.
- */
-export declare type Speller = string;
-
 /** A skill to split a string into chunks of text. */
 export declare interface SplitSkill extends BaseSearchIndexerSkill {
     /** Polymorphic discriminator, which specifies the different types this object can be */
@@ -7554,6 +7788,11 @@ export declare interface VectorizableTextQuery<TModel extends object> extends Ba
     kind: "text";
     /** The text to be vectorized to perform a vector search query. */
     text: string;
+    /**
+     * Can be configured to let a generative model rewrite the query before sending it to be
+     * vectorized.
+     */
+    queryRewrites?: QueryRewrites;
 }
 
 /** The query parameters to use for vector search when a raw vector value is provided. */
@@ -7612,6 +7851,16 @@ export declare type VectorSearchCompression = BinaryQuantizationCompression | Sc
  */
 export declare type VectorSearchCompressionKind = string;
 
+/**
+ * Defines values for VectorSearchCompressionRescoreStorageMethod. \
+ * {@link KnownVectorSearchCompressionRescoreStorageMethod} can be used interchangeably with VectorSearchCompressionRescoreStorageMethod,
+ *  this enum contains the known values that the service supports.
+ * ### Known values supported by the service
+ * **preserveOriginals**: This option preserves the original full-precision vectors. Choose this option for maximum flexibility and highest quality of compressed search results. This consumes more storage but allows for rescoring and oversampling. \
+ * **discardOriginals**: This option discards the original full-precision vectors. Choose this option for maximum storage savings. Since this option does not allow for rescoring and oversampling, it will often cause slight to moderate reductions in quality.
+ */
+export declare type VectorSearchCompressionRescoreStorageMethod = string;
+
 /**
  * Defines values for VectorSearchCompressionTarget. \
  * {@link KnownVectorSearchCompressionTarget} can be used interchangeably with VectorSearchCompressionTarget,