Search May 2025 Preview (#45293)

Search May 2025 Preview

Author: jairmyree

.vscode/cspell.json

@@ -478,7 +478,9 @@
         "TGIANT",
         "tiktoken",
         "AITOKENS",
-        "Matryoshka"
+        "Matryoshka",
+        "OMINI",
+        "resyncing"
       ]
     },
     {

eng/code-quality-reports/src/main/resources/revapi/revapi.json

@@ -757,6 +757,36 @@
           "new": "method void com.azure.search.documents.indexes.models.SearchResourceEncryptionKey::<init>(java.lang.String, java.lang.String)",
           "justification": "Breaking change in Search 03-01-2025 preview."
         },
+        {
+          "ignore": true,
+          "code": "java.method.visibilityIncreased",
+          "old": "method <T> reactor.core.publisher.Mono<com.azure.core.http.rest.Response<T>> com.azure.search.documents.SearchAsyncClient::getDocumentWithResponse(java.lang.String, java.lang.Class<T>, java.util.List<java.lang.String>, com.azure.core.util.Context)",
+          "justification": "Non-breaking change in Search 05-01-2025 preview to package-private api." 
+        },
+        {
+          "ignore": true,
+          "code": "java.method.visibilityIncreased",
+          "old": "method reactor.core.publisher.Mono<com.azure.search.documents.util.SearchPagedResponse> com.azure.search.documents.SearchAsyncClient::search(com.azure.search.documents.implementation.models.SearchRequest, java.lang.String, com.azure.search.documents.implementation.models.SearchFirstPageResponseWrapper, com.azure.core.util.Context)",
+          "justification": "Non-breaking change in Search 05-01-2025 preview to package-private api."
+        },
+        {
+          "ignore": true,
+          "code": "java.method.visibilityIncreased",
+          "old": "method com.azure.search.documents.util.SearchPagedFlux com.azure.search.documents.SearchAsyncClient::search(java.lang.String, com.azure.search.documents.models.SearchOptions, com.azure.core.util.Context)",
+          "justification": "Non-breaking change in Search 05-01-2025 preview to package-private api."
+        },
+        {
+          "ignore": true,
+          "code": "java.method.visibilityIncreased",
+          "old": "method com.azure.search.documents.util.SearchPagedResponse com.azure.search.documents.SearchClient::search(com.azure.search.documents.implementation.models.SearchRequest, java.lang.String, com.azure.search.documents.implementation.models.SearchFirstPageResponseWrapper, com.azure.core.util.Context)",
+          "justification": "Non-breaking change in Search 05-01-2025 preview to package-private api."
+        },
+        {
+          "ignore": true,
+          "code": "java.method.visibilityIncreased",
+          "old": "method com.azure.search.documents.util.SearchPagedFlux com.azure.search.documents.SearchAsyncClient::search(com.azure.search.documents.implementation.models.SearchRequest, java.lang.String, com.azure.core.util.Context)",
+          "justification": "Non-breaking change in Search 05-01-2025 preview to package-private api."
+        },
         {
           "regex": true,
           "code": "java.field.enumConstantOrderChanged",

sdk/search/azure-search-documents/CHANGELOG.md

@@ -1,14 +1,19 @@
 # Release History
 
-## 11.8.0-beta.7 (Unreleased)
+## 11.8.0-beta.7 (2025-05-16)
 
 ### Features Added
 
-### Breaking Changes
-
-### Bugs Fixed
-
-### Other Changes
+- Added new `KnowledgeAgent` apis to index clients and introduced new `SearchKnowledgeAgentClient` for managing and querying Knowledge Agents,
+enabling multi-index grounding for agentic retrieval.
+- Added a method overloads for search client operations to include the `querySourceAuthentication` parameter, allowing users to specify the authentication method for the query source.
+- Added a `resync` method to indexer clients to resync selective options from the data source to be re-ingested by the indexer.
+- Added `permissionFilter` to Field Builder annotations, indication whether a field should be used as a permission filter.
+- Added `rerankerBoostedScore` to `SemanticSearchResult` and updated `SemanticConfiguration` with a new `rankingOrder` property.
+- Introduced new skill `ChatCompletionSkill` that integrates with Azure AI Foundry.
+- Enhanced `DocumentIntelligenceLayoutSkill` with new properties: `ChunkingProperties`, `ExtractionOptions`, and `OutputFormat`.
+- Added `IndexerPermissionOptions` to `SearchIndexerDataSourceConnection` to support ingestion of various types of permission data.
+- Introduced sub-field vector support (multi-vectors) via `VectorQuery.Fields`, and added new query option `VectorQuery.PerDocumentVectorLimit`.
 
 ## 11.8.0-beta.6 (2025-04-17)
 

sdk/search/azure-search-documents/README.md

@@ -75,7 +75,7 @@ add the direct dependency to your project as follows.
 <dependency>
     <groupId>com.azure</groupId>
     <artifactId>azure-search-documents</artifactId>
-    <version>11.8.0-beta.6</version>
+    <version>11.8.0-beta.7</version>
 </dependency>
 ```
 [//]: # ({x-version-update-end})

sdk/search/azure-search-documents/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/search/azure-search-documents",
-  "Tag": "java/search/azure-search-documents_8d90b12483"
+  "Tag": "java/search/azure-search-documents_ab303259b0"
 }

sdk/search/azure-search-documents/checkstyle-suppressions.xml

@@ -65,4 +65,6 @@
   <suppress files="com.azure.search.documents.models.VectorizableImageUrlQuery.java" checks="com.azure.tools.checkstyle.checks.EnforceFinalFieldsCheck" />
   <suppress files="com.azure.search.documents.models.VectorQuery.java" checks="com.azure.tools.checkstyle.checks.EnforceFinalFieldsCheck" />
   <suppress files="com.azure.search.documents.models.VectorThreshold.java" checks="com.azure.tools.checkstyle.checks.EnforceFinalFieldsCheck" />
+  <suppress files="com.azure.search.documents.indexes.implementation.KnowledgeAgentsImpl.java" checks="MissingJavadocMethodCheck" />
+  <suppress files="com.azure.search.documents.agents.implementation.KnowledgeRetrievalsImpl.java" checks="MissingJavadocMethodCheck" />
 </suppressions>

sdk/search/azure-search-documents/pom.xml

@@ -24,8 +24,8 @@
     <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
     <!-- Coverage used to be higher but between additional, unused generated client APIs and unused models' JSON serialization it has been lowered. -->
     <!-- In the future this will be cleaned up and coverage should be increased again. -->
-    <jacoco.min.linecoverage>0.52</jacoco.min.linecoverage>
-    <jacoco.min.branchcoverage>0.42</jacoco.min.branchcoverage>
+    <jacoco.min.linecoverage>0.46</jacoco.min.linecoverage>
+    <jacoco.min.branchcoverage>0.40</jacoco.min.branchcoverage>
     <!-- Configures the Java 9+ run to perform the required module exports, opens, and reads that are necessary for testing but shouldn't be part of the module-info. -->
     <javaModulesSurefireArgLine>
       --add-exports com.azure.core/com.azure.core.implementation.http=ALL-UNNAMED