Search: add 2026-11-01-preview support by yangylu91 · Pull Request #50960 · Azure/azure-sdk-for-java

Yangyang Lu (yangylu91) · 2026-10-23T01:54:15Z

Description

Summary

Add Azure AI Search data-plane API 2026-11-01-preview support to
com.azure:azure-search-documents 12.3.0-beta.1 (Unreleased), generated from the finalized
Azure/azure-rest-api-specs#47300
commit b41ba04c0219f6622b7f5214fc020f90bad339ae, as pinned in tsp-location.yaml.

Key changes

Add sync/async graph queries with typed responses, diagnostics, statistics, planning and provenance.
Add Topic Graph retrieval modes, facet-backed filter hints, random scoring, agentic options, graph extraction,
cache configuration, updated knowledge sources/models, and native file-ingestion/replacement LROs.
Carry forward October GA SSE behavior, authorization overloads/options, document lookup options, listing
adapters, scoring compatibility and file-parameter ordering. Preserve supported GA service versions.
Publish validated recordings and pin assets.json to java/search/azure-search-documents_6950366571
(asset commit 6950366571d9f0a3e3c2841edb33f07030012ee0).
Remove the 14 supplemental live-test methods that had not been exercised against a real service.
Restore GA test authentication: LIVE and RECORD use the configured pipeline identity, otherwise Azure CLI.
Restore applicable GA behavioral and stream-sample regressions, and correct isolated-service/recording guidance.
This follow-up changes test code/documentation only, not the SDK's customer-facing code.
Rebase onto main commit 08745e8f7d9c1d62d76c139853aba0320176d263, resolving GA/preview conflicts
while preserving the validated preview production/customization sources and recording/spec pins.
Retain main's GA release history and additional samples, and align dependency versions with main.

Validation

Post-rebase local validation on November 10, with JDK 21/Maven and SEARCH_* variables removed:

foreach ($variable in @(Get-ChildItem Env: | Where-Object { $_.Name -like 'SEARCH_*' })) {
    [Environment]::SetEnvironmentVariable($variable.Name, $null, 'Process')
}
$env:AZURE_TEST_MODE = 'PLAYBACK'
mvn -B -ntp -f sdk\search\azure-search-documents\pom.xml `
  clean test jar:jar revapi:check checkstyle:check spotbugs:check spotless:check codesnippet:verify-codesnippet `
  '-Drevapi.oldArtifacts=local.azure-search-compatibility:october-ga:12.2.0-c0866c2b2364' `
  '-Drevapi.disallowedExtensions=revapi.versions' `
  '-Dspotbugs.skip=false' `
  '-DspotlessFiles=.*SearchAuthenticationTests[.]java,.*SearchGaTests[.]java,.*SearchGaSamplesTests[.]java,.*TestHelpers[.]java'

Passed: 1,311 tests total: 1,193 passed, 118 existing skips, zero failures/errors.
Strict Revapi against the exact October GA 12.2.0 artifact passed without semantic-version masking.
The local comparison artifact was built from GA commit c0866c2b2364a855cda5e78e30f4fed8af795415;
it is not a public Maven coordinate. Checkstyle reported zero violations; enabled SpotBugs reported zero
bugs/errors; scoped Spotless and snippet verification passed. Test/sample sources compiled for Java 8 and Java 21.

Main subsequently advanced with the Search release-version update in #51201. The final rebase preserves its
12.2.0 released dependency fallback and historical changelog ordering. Those are the only differences from
the tested integration snapshot; SDK/test/sample sources, POMs, customizations and recording/spec pins are unchanged.

An additional exact-GA comparison with both semantic-version masking and difference suppressions disabled:

mvn -B -ntp -f sdk\search\azure-search-documents\pom.xml revapi:check `
  '-Drevapi.oldArtifacts=local.azure-search-compatibility:october-ga:12.2.0-c0866c2b2364' `
  '-Drevapi.disallowedExtensions=revapi.versions,revapi.differences'

Passed: no DP10 GA API incompatibilities reported.

Dependent performance-module compilation also passed for Java 8 and Java 21:

mvn -B -ntp -f sdk\search\pom.xml -pl azure-search-documents,azure-search-perf -am test-compile `
  '-DspotlessFiles=.*SearchAuthenticationTests[.]java,.*SearchGaTests[.]java,.*SearchGaSamplesTests[.]java,.*TestHelpers[.]java'

Passed: both Search SDK and performance modules compiled. No performance tests were run.
Initially blocked by uncached internal performance artifacts, this was resolved by building/installing the
repository dependency and parent locally, without changing feed credentials or configuration:

mvn -B -ntp -f common\perf-test-core\pom.xml package install:install '-DskipTests' `
  '-DspotlessFiles=.*SearchAuthenticationTests[.]java,.*SearchGaTests[.]java,.*SearchGaSamplesTests[.]java,.*TestHelpers[.]java'
mvn -B -ntp -f sdk\parents\azure-perf-test-parent\pom.xml install:install

Passed: both local dependency-setup commands; performance-core tests were not run.

Before the rebase, the focused restored-test command also passed:

$env:AZURE_TEST_MODE = 'PLAYBACK'
mvn -B -ntp -f sdk\search\azure-search-documents\pom.xml spotless:apply test checkstyle:check `
  '-Dtest=SearchAuthenticationTests,SearchGaTests,SearchGaSamplesTests,TestHelpersTests' `
  '-DspotlessFiles=.*SearchAuthenticationTests[.]java,.*SearchGaTests[.]java,.*SearchGaSamplesTests[.]java,.*TestHelpers[.]java'

Passed: 37 tests, zero skips/failures/errors.

Before the unrun live tests were removed, the full RECORD and clean-default PLAYBACK runs each produced
1,157 passes and 132 skips with zero failures/errors. The removed methods accounted for 14 of those historical
skips. Existing LIVE retrieval suites previously produced 99 passes and 14 existing skips after backend routing
was corrected. Asset restoration reproduced all 2,000 published recording JSON files byte-for-byte.
These historical real-service runs do not establish live validation of every new preview feature.

Compatibility and known limitations

No DP10 GA API incompatibility was detected by the strict comparison against exact GA 12.2.0.
Existing GA service-version constants remain available. The preview intentionally defaults to
2026-11-01-preview; callers that need the GA REST version can set SearchServiceVersion.V2026_10_01.
Breaking changes relative to the earlier August preview, rather than DP10 GA, are documented in CHANGELOG.
Offline feature-contract tests verify SDK wire behavior, not backend feature availability, ranking quality,
ACL enforcement or downstream provider routing. Remaining feature-specific live-validation gaps are summarized below and tracked in the release work item.
No live tests or Azure resource changes were performed for the GA-safety follow-up or merge resolution. Integration suites must
use an isolated service; their pre-existing cleanup can delete unrelated knowledge resources.
No release or package publishing is included.

Local review follow-up (not yet pushed)

November 13 review changes are applied and validated locally, but have not been committed or pushed:

Restored the explicit customization constructor and simplified stream model replacement to replaceFile, preserving generated headers and public behavior.
Restored the opt-in Content Understanding skillset example, paged index statistics, and service-indexer runtime output. Added three offline sample regression cases.
Moved the task-specific coverage ledger out of the package, removed its test README link, and retained the coverage limitations in this PR description.
Retained both upload formats, typed graph response customization, and continuation-property hiding based on the pinned contract and generator results. October GA is generated natively.

Full package clean verify, JPMS compilation, strict Revapi against the exact October GA artifact with semantic-version masking and difference suppressions disabled, Checkstyle, enabled SpotBugs, scoped Spotless, and snippet verification passed.
The package suite ran 1,332 cases: 1,214 passed, 118 existing skips, zero failures/errors. The untracked handwritten FileIngestionTests class was explicitly excluded and remains local-only.
The build compiled Java 21 module-path sources, Java 8 library/test sources, and the Java 11 module descriptor. The packaged JAR's module descriptor was verified.
Repeated pinned-emitter generation and formatting left all 641 production source/resource files unchanged after line-ending normalization. Production Java ASTs remain unchanged relative to the published PR.
The initial full-suite attempt was blocked by the test-proxy subprocess not finding Git; retrying with Git added only to the Maven process PATH resolved it. No live Azure calls or recording updates were made for this follow-up.

Remaining feature-specific live validation

Temporary text-only native SDK checks on the isolated WECUS service passed synchronous/asynchronous ingestion and replacement. Separate direct-adapter HTTP 404 checks preserved status and repeat-readable error bodies; they did not induce an error inside a running native poller. These checks are not committed live tests and do not establish model-backed ingestion, storage connectivity, or the scenarios below.

Feature	Retained SDK coverage	Remaining service validation
GraphRAG Zero L1 / Topic Graph	`PreviewApiTests` round trips discriminators; `FieldBuilderTests` covers `topicGraphProfile`; `PreviewFeatureContractTests` checks query modes, allowed fields and stored KS defaults	Controlled-corpus diversity/interleaving, index/KS configuration and rejection of invalid mode-specific fields
EKG KS ingestion, ontology, cache and status	`PreviewFeatureContractTests` checks graph extraction/cache requests and ontology/triple statistics in status responses	Real extraction, cache reuse/reprocessing, grounding, secret omission on GET, ontology lifecycle and failure recovery
EKG retrieval	`PreviewApiTests` checks graph headers/options, diagnostics and rejection bodies; `PreviewFeatureContractTests` checks graph overrides and mixed activity types	Graph execution, KB graph retrieval, provenance hydration, authorization and graph-language cases
Agentic Direct Search / KR models	`SearchUtilsTests` forwards agentic options; SSE tests deserialize reasoning; `PreviewFeatureContractTests` checks renamed usage fields and Microsoft Retriever requests	Real reasoning/retrieval, model routing, timeout/budget termination and shared accounting
File KS LRO	Existing legacy upload/update tests; `FileIngestionPollingTests` checks sync/async polling, errors, operation GET/list and continuation	Model-backed ingestion, retained-operation lookup, backend failure and expiry behavior
Durable Operations framework	Customer-facing file-operation polling coverage above	Internal serverless teardown, durability/restart and expiry belong to backend tests
OneLake indexed KS ACLs / OneLake security filtering	`FieldBuilderTests` maps `oneLakeParentFolders`; `PreviewFeatureContractTests` checks security metadata and data-source serialization	Two-identity visibility checks, inherited/moved-folder ACLs and revocation propagation
Random scoring	`PreviewApiTests` checks discriminator and classic-scoring compatibility; `PreviewFeatureContractTests` checks profile and seed forwarding	Same-seed repeatability, changed-seed ordering, seed rejection boundaries and statistical quality
KB tools	`PreviewFeatureContractTests` checks tool configuration and singular request-time selection	Source isolation, request/default precedence, invalid tool/source rejection and MCP discovery
OpenAI-compatible / APIM models	`PreviewFeatureContractTests` checks KB authentication, ingestion models, vectorizers and exact skill URI forwarding	Real Chat Completions/Responses retrieval, ingestion/vectorization and downstream APIM path/query/header behavior
GPT-6 via Responses	Model-name handling in compatible-model contract cases	Real deployed-model retrieval and backend Responses routing
Query hint filter auto-configuration	`PreviewApiTests` and `PreviewFeatureContractTests` check facet-backed configuration serialization	Facet bootstrap, filtering, TTL refresh, limits and rejection/permission boundaries

Release Plan Details

Release Plan: https://azsdk-releaseplan-dashboard-hveph5aqhhcfhtgu.westus-01.azurewebsites.net/?releaseplan=37175
Work Item Link: https://dev.azure.com/azure-sdk/fe81d705-3c06-41e5-bf7c-5ebea18efe89/_workitems/edit/37175
Spec Pull Request: Azure Search DP 2026-11-01-Preview Release azure-rest-api-specs#47300
Spec API version: 2026-11-01-preview

All SDK Contribution checklist:

The pull request does not introduce [breaking changes]
CHANGELOG is updated for new features, bug fixes or other significant changes.
I have read the contribution guidelines.

General Guidelines and Best Practices

Title of the pull request is clear and informative.
There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

Pull request includes test coverage for the included changes.

azure-pipelines · 2026-10-23T01:55:01Z

Azure Pipelines: Successfully started running 1 pipeline(s). 34 pipeline(s) were filtered out due to trigger conditions. There may be pipelines that require an authorized user to comment /azp run to run.

Alan Zimmer (alzimmermsft)

Need to update the field builder annotations with the newly added SearchField features.

Yangyang Lu (yangylu91) · 2026-10-27T21:59:58Z

Updated per the November spec in Azure/azure-rest-api-specs#47300:

Added the missing field annotations and mappings, including permissionFilter, with regression tests for explicit values and defaults.
Deprecated the ignored isSensitivityLabel() member without changing its signature, default, or behavior; documented the ID/name alternatives.

Focused tests, static checks, and GA 12.0.3 compatibility checks passed.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Preserve underlying test exception diagnostics and add focused regressions. Regenerate model documentation from spec b41ba04c0219f6622b7f5214fc020f90bad339ae without changing the SDK version or recordings. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Complete BasicField annotations and FieldBuilder mappings for sensitivity label IDs/names, source document IDs, SharePoint site URLs, and permission filters. Add serialization and default-value regression coverage. Remove the August preview service version through customization and regenerate at the unchanged spec pin b41ba04c0219f6622b7f5214fc020f90bad339ae, retaining supported GA versions and the November preview. Clarify the spec-defined Blob and Indexed SharePoint queryHints/queryHintOverrides removals and retained Search Index support in the changelog. Validation: package, Checkstyle, SpotBugs, Spotless, Revapi against GA 12.0.3, and local consumer checks passed. Focused tests: 41 passed, 2 existing skips. Full playback CI remains blocked by recording mismatches; no live tests run. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Deprecate BasicField.isSensitivityLabel() and document its existing no-op behavior and the distinct ID/name replacements. Preserve its signature, BooleanHelper.NULL default, and runtime behavior; add a changelog note. Correct the Search package skill and both references to retain supported GA versions and only the latest preview, removing obsolete previews through customization. Keep the existing latest-preview regression test unchanged. Validation: package/Javadoc, Checkstyle, SpotBugs, Spotless, Revapi against GA 12.0.3, and local GA binary/public API consumer checks passed. Focused tests: 41 passed, 2 existing skips. Skill documentation passed the repository-documented manual fallback checks because vally is unavailable. No live tests run. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Preserve GA streaming, lookup, listing, authorization, and file APIs through the preview customizations. Add regression and opt-in feature coverage, update release metadata, and pin the published recording assets. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Remove the 14 supplemental live methods that were never exercised against a real service. Retain the verified offline regression tests and published recordings, and update the coverage inventory to remove stale live-test setup instructions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Match DP10 GA credential selection in LIVE and RECORD, restore applicable offline GA regressions, and correct isolated-service and recording guidance. Customer-facing SDK code is unchanged. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Restore the validated preview implementation and fixtures after GA-main conflict resolution. Preserve main release history and additive GA samples, and align Search dependency baselines with main. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Copilot

🟡 Changes recommended

The samples use an invalid explain-stage selector and omit an asynchronous completion wait, risking a rejected request and termination before any indexers are listed.

2 open issues

What changed in this PR

Adds the November 2026 preview API to azure-search-documents, extending graph, vector, agentic search, and knowledge retrieval capabilities while retaining supported GA service versions.

Changes:

Adds preview models, response metadata, indexer configuration, and field-builder mappings.
Updates samples and tests for preview behavior, authorization forwarding, and GA compatibility.
Pins the specification and recording assets, documents release changes, and updates regeneration guidance.

Paths are relative to sdk/search/azure-search-documents/.

File	Description
`tsp-location.yaml`	Pins the finalized preview specification.
`src/test/java/com/azure/search/documents/TestHelpersTests.java`	Tests unexpected-exception diagnostics.
`src/test/java/com/azure/search/documents/TestHelpers.java`	Includes actual exceptions in assertion messages.
`src/test/java/com/azure/search/documents/SearchTestBase.java`	Updates configuration and removes playback normalization.
`src/test/java/com/azure/search/documents/knowledgebases/KnowledgeBaseRetrievalStreamTests.java`	Tests dual authorization headers and preview requests.
`src/test/java/com/azure/search/documents/indexes/SynonymMapManagementTests.java`	Uses typed listing parameters in pagination tests.
`src/test/java/com/azure/search/documents/indexes/SkillsetManagementTests.java`	Changes Content Understanding test account selection.
`src/test/java/com/azure/search/documents/indexes/SearchServiceTests.java`	Tests knowledge-resource usage counters.
`src/test/java/com/azure/search/documents/indexes/SearchListingTests.java`	Updates the preview continuation URL.
`src/test/java/com/azure/search/documents/GetDocumentOptionsTests.java`	Adds GA and preview lookup coverage.
`src/samples/java/com/azure/search/documents/SynonymMapsCreateExample.java`	Removes the additional listing demonstration.
`src/samples/java/com/azure/search/documents/SearchOptionsExample.java`	Removes the more-like-this demonstration.
`src/samples/java/com/azure/search/documents/PreviewSearchSamples.java`	Adds graph, vector, filter-hint, and scoring examples.
`src/samples/java/com/azure/search/documents/KnowledgeServiceStatsPreviewExample.java`	Demonstrates knowledge counters and vector limits.
`src/samples/java/com/azure/search/documents/KnowledgeBaseRetrievalStreamExample.java`	Removes separate citation URL printing.
`src/samples/java/com/azure/search/documents/indexes/ListIndexesExample.java`	Removes supplemental listing and alias demonstrations.
`src/samples/java/com/azure/search/documents/indexes/ListIndexersExample.java`	Simplifies asynchronous indexer listing.
`src/samples/java/com/azure/search/documents/indexes/CreateSkillsetExample.java`	Removes the Content Understanding demonstration.
`src/samples/java/com/azure/search/documents/IndexAndServiceStatisticsExample.java`	Removes supplemental runtime and summary output.
`src/main/java/module-info.java`	Reorders existing package-opening declarations.
`src/main/java/com/azure/search/documents/SearchServiceVersion.java`	Adds and defaults to the November preview.
`src/main/java/com/azure/search/documents/models/VectorThresholdKind.java`	Defines vector threshold kinds.
`src/main/java/com/azure/search/documents/models/VectorSearchTopicGraphKind.java`	Defines topic graph retrieval modes.
`src/main/java/com/azure/search/documents/models/VectorQueryKind.java`	Adds image query kinds.
`src/main/java/com/azure/search/documents/models/VectorFilterMode.java`	Adds strict post-filtering.
`src/main/java/com/azure/search/documents/models/SemanticQueryRewritesResultType.java`	Defines query rewrite result metadata.
`src/main/java/com/azure/search/documents/models/SemanticFieldState.java`	Defines semantic field usage states.
`src/main/java/com/azure/search/documents/models/SearchPagedResponse.java`	Exposes diagnostics and rewrite results.
`src/main/java/com/azure/search/documents/models/SearchDocumentsResult.java`	Deserializes diagnostics and rewrite results.
`src/main/java/com/azure/search/documents/models/QueryType.java`	Adds agentic query mode.
`src/main/java/com/azure/search/documents/models/QuerySpellerType.java`	Defines spelling correction modes.
`src/main/java/com/azure/search/documents/models/QueryRewritesType.java`	Defines query rewriting modes.
`src/main/java/com/azure/search/documents/models/QueryDebugMode.java`	Adds agentic diagnostics selection.
`src/main/java/com/azure/search/documents/models/OperationState.java`	Defines operation lifecycle states.
`src/main/java/com/azure/search/documents/models/NoneVectorQueryTopicGraph.java`	Models disabled topic graph retrieval.
`src/main/java/com/azure/search/documents/models/HybridCountAndFacetMode.java`	Defines hybrid count and facet scope.
`src/main/java/com/azure/search/documents/models/GraphQueryProvenanceKind.java`	Defines graph evidence retrieval modes.
`src/main/java/com/azure/search/documents/models/GraphQueryProvenanceDocument.java`	Models hydrated source-document fields.
`src/main/java/com/azure/search/documents/models/GraphQueryExplainStage.java`	Defines graph query explanation stages.
`src/main/java/com/azure/search/documents/models/GraphQueryExplain.java`	Models query-plan diagnostic payloads.
`src/main/java/com/azure/search/documents/models/GraphQueryExecutionMode.java`	Defines execution and planning-only modes.
`src/main/java/com/azure/search/documents/models/GraphQueryEvidenceCountRelation.java`	Describes evidence count completeness.
`src/main/java/com/azure/search/documents/models/GraphQueryDiagnosticSeverity.java`	Defines graph diagnostic severities.
`src/main/java/com/azure/search/documents/models/GraphQueryDiagnosticPhase.java`	Defines graph diagnostic phases.
`src/main/java/com/azure/search/documents/models/DocumentDebugInfo.java`	Adds semantic and inner-hit diagnostics.
`src/main/java/com/azure/search/documents/models/AgenticSearchTerminationReason.java`	Defines agentic processing termination reasons.
`src/main/java/com/azure/search/documents/knowledgebases/models/SynchronizationState.java`	Exposes graph extraction statistics.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeSourceVectorizer.java`	Recognizes OpenAI-compatible vectorizers.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeSourceGraphProvenanceKind.java`	Defines graph source-document hydration modes.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeRetrievalReasoningEffortKind.java`	Adds automatic reasoning effort.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeRetrievalReasoningEffort.java`	Deserializes automatic reasoning settings.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseWorkIQActivityArguments.java`	Models WorkIQ retrieval arguments.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseWebActivityRecord.java`	Adds image-serving statistics.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseSearchIndexReference.java`	Adds sensitivity-label metadata.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseSearchIndexActivityArguments.java`	Exposes the executed query type.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseRetrievalStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseRetrievalStartedStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseRetrievalResult.java`	Adds overall response sensitivity metadata.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseResponseCompletedStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseReferenceType.java`	Adds preview knowledge reference kinds.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseReferencesCompletedStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseReference.java`	Deserializes new reference subtypes.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseIndexedSqlActivityRecord.java`	Adds image-serving statistics.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseIndexedSharePointReference.java`	Adds sensitivity-label metadata.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseIndexedSharePointActivityRecord.java`	Adds image-serving statistics.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseIndexedOneLakeReference.java`	Adds sensitivity-label metadata.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseIndexedOneLakeActivityRecord.java`	Adds image-serving statistics.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseFileActivityRecord.java`	Adds image-serving statistics.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseFabricOntologyActivityArguments.java`	Models Fabric Ontology retrieval arguments.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseFabricDataAgentActivityArguments.java`	Models Fabric Data Agent retrieval arguments.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseErrorStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseAzureBlobReference.java`	Adds sensitivity-label metadata.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseAzureBlobActivityRecord.java`	Adds image-serving statistics.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseAnswerCompletedStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseActivityStartedStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseActivityRecordType.java`	Adds preview retrieval activity kinds.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseActivityRecord.java`	Deserializes new retrieval activity subtypes.
`src/main/java/com/azure/search/documents/knowledgebases/models/KnowledgeBaseActivityCompletedStreamEvent.java`	Adds a generated-code header comment.
`src/main/java/com/azure/search/documents/knowledgebases/models/CompletedSynchronizationState.java`	Exposes completed graph extraction statistics.
`src/main/java/com/azure/search/documents/indexes/models/WebKnowledgeSource.java`	Adds result-processing configuration.
`src/main/java/com/azure/search/documents/indexes/models/VectorSearchVectorizerKind.java`	Adds the OpenAI-compatible vectorizer kind.
`src/main/java/com/azure/search/documents/indexes/models/VectorSearchVectorizer.java`	Recognizes additional vectorizer subtypes.
`src/main/java/com/azure/search/documents/indexes/models/VectorSearch.java`	Adds topic graph profile configuration.
`src/main/java/com/azure/search/documents/indexes/models/SplitSkillUnit.java`	Defines character and token splitting units.
`src/main/java/com/azure/search/documents/indexes/models/SplitSkillEncoderModelName.java`	Defines splitting tokenizer models.
`src/main/java/com/azure/search/documents/indexes/models/SemanticConfiguration.java`	Adds model flighting opt-in.
`src/main/java/com/azure/search/documents/indexes/models/SearchServiceLimits.java`	Exposes the per-index vector-size limit.
`src/main/java/com/azure/search/documents/indexes/models/SearchIndexKnowledgeSourceBoostKind.java`	Defines knowledge-source boost hint kinds.
`src/main/java/com/azure/search/documents/indexes/models/SearchIndexKnowledgeSource.java`	Adds result-processing configuration.
`src/main/java/com/azure/search/documents/indexes/models/SearchIndexerStatus.java`	Exposes current execution state.
`src/main/java/com/azure/search/documents/indexes/models/SearchIndexerSkill.java`	Recognizes additional skill subtypes.
`src/main/java/com/azure/search/documents/indexes/models/SearchIndexerKnowledgeStore.java`	Adds knowledge-store parameters.
`src/main/java/com/azure/search/documents/indexes/models/SearchIndexerDataSourceConnection.java`	Exposes data-source subtype metadata.
`src/main/java/com/azure/search/documents/indexes/models/SearchIndexer.java`	Adds enrichment cache configuration.
`src/main/java/com/azure/search/documents/indexes/models/RandomScoringParameters.java`	Models the random-scoring seed parameter.
`src/main/java/com/azure/search/documents/indexes/models/PermissionFilter.java`	Adds OneLake permission filter kinds.
`src/main/java/com/azure/search/documents/indexes/models/McpServerOutputParsingKind.java`	Defines MCP output parsing modes.
`src/main/java/com/azure/search/documents/indexes/models/McpServerNoneOutputParsing.java`	Models unparsed MCP output.
`src/main/java/com/azure/search/documents/indexes/models/McpServerAutoOutputParsing.java`	Models automatic MCP output parsing.
`src/main/java/com/azure/search/documents/indexes/models/McpServerAuthenticationKind.java`	Defines MCP authentication kinds.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeSourceResultsProcessing.java`	Defines reranking and order-preserving modes.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeSourceKind.java`	Adds preview knowledge-source kinds.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeSourceIngestionPermissionOption.java`	Adds sensitivity-label and OneLake ingestion options.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeSourceGraphOntologySourceKind.java`	Defines inline graph ontology sources.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeSourceGraphGroundingSourceKind.java`	Defines search-index graph grounding sources.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeBaseModelKind.java`	Adds OpenAI-compatible and Retriever model kinds.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeBaseModel.java`	Deserializes additional model subtypes.
`src/main/java/com/azure/search/documents/indexes/models/KnowledgeBaseMicrosoftRetriever1Model.java`	Models Microsoft Retriever 1 configuration.
`src/main/java/com/azure/search/documents/indexes/models/IndexingMode.java`	Defines indexer execution modes.
`src/main/java/com/azure/search/documents/indexes/models/IndexerPermissionOption.java`	Adds OneLake permission ingestion options.
`src/main/java/com/azure/search/documents/indexes/models/IndexerExecutionStatusDetail.java`	Defines reset and resync status details.
`src/main/java/com/azure/search/documents/indexes/models/IndexerExecutionResult.java`	Exposes execution mode and status details.
`src/main/java/com/azure/search/documents/indexes/models/IndexedSqlKnowledgeSource.java`	Adds result-processing configuration.
`src/main/java/com/azure/search/documents/indexes/models/IndexedSharePointKnowledgeSource.java`	Adds result-processing configuration.
`src/main/java/com/azure/search/documents/indexes/models/IndexedOneLakeKnowledgeSource.java`	Adds result-processing configuration.
`src/main/java/com/azure/search/documents/indexes/models/GraphProfileKind.java`	Defines edge-list graph storage.
`src/main/java/com/azure/search/documents/indexes/models/FileKnowledgeSource.java`	Adds result-processing configuration.
`src/main/java/com/azure/search/documents/indexes/models/AzureOpenAIModelName.java`	Expands model-name constants.
`src/main/java/com/azure/search/documents/indexes/models/AzureBlobKnowledgeSource.java`	Adds result-processing configuration.
`src/main/java/com/azure/search/documents/implementation/FieldBuilder.java`	Forwards security and topic graph annotations.
`cspell.json`	Adds package-specific spelling configuration.
`CHANGELOG.md`	Documents preview features and compatibility changes.
`assets.json`	Pins updated test recordings.
`.github/skills/azure-search-documents/SKILL.md`	Updates service-version regeneration guidance.
`.github/skills/azure-search-documents/references/customizations.md`	Documents GA retention and obsolete-preview removal.
`.github/skills/azure-search-documents/references/architecture.md`	Clarifies supported service-version policy.

_{Review effort: Balanced}

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Correct update and delete calls, including cleanup. Exercise the actual sample against fake HTTP for successful execution and cleanup after an update failure. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Use an existing knowledge base configured by KNOWLEDGE_BASE_NAME instead of upserting and deleting a fixed-name resource. Add offline sample tests for successful and failed retrieval with no resource mutations, and document the required configuration. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Validate polling responses after the original client pipeline has applied its policies. Buffer failed response bodies before closing transport responses, preserving status, headers, and error details without replacing azure-core pollers. Wire only preview file ingestion through a regeneration-safe customization and regenerate locally. Add sync/async error, empty-body, response-cleanup, retry, authentication, and context regressions. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

efrainretana · 2026-11-13T18:54:26Z

-
+    // SearchResourceEncryptionKey has keyName and vaultUrl as required (final) fields, but when
+    // isServiceLevelKey is true, they are not needed. This adds a no-arg constructor and makes those fields non-final.
+    private static void addNoArgConstructorToEncryptionKey(ClassCustomization customization) {


I recall there were discussions to fix this in a future release but it seems to still not have gotten fixed.. Yangyang Lu (@yangylu91) do you know whether this customization is still needed?

Restore sample coverage and the explicit customization constructor, simplify stream model replacement without changing generated APIs, and move the task-specific coverage ledger out of the package. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Explicitly retain 2026-10-01 in the guarded missing-version fallback. Native generated output remains unchanged because the existing enum entry is detected. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Keep generated sync and async graph convenience methods, remove the extra typed HTTP-response wrappers and their unused helpers, and update API regression coverage and documentation. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

github-actions Bot added the Search label Oct 23, 2026

github-project-automation Bot added this to Azure SDK for Search Oct 23, 2026

github-project-automation Bot moved this to Untriaged in Azure SDK for Search Oct 23, 2026

Alan Zimmer (alzimmermsft) reviewed Oct 23, 2026

View reviewed changes

hillarykhuu force-pushed the yangylu/dp-2026-11-01-preview branch from 8d63221 to 75843ad Compare November 11, 2026 00:03

Yangyang Lu (yangylu91) and others added 9 commits November 10, 2026 16:04

Add Azure AI Search 2026-11-01-preview SDK support

6d31609

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Preserve Search release-history ordering from main

95776c7

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

hillarykhuu force-pushed the yangylu/dp-2026-11-01-preview branch from 75843ad to 95776c7 Compare November 11, 2026 00:06

Fix Search preview coverage documentation spelling

f1c7feb

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

hillarykhuu marked this pull request as ready for review November 11, 2026 00:25

hillarykhuu requested review from a team as code owners November 11, 2026 00:25

Copilot AI balanced review requested due to automatic review settings November 11, 2026 00:25

Copilot started reviewing on behalf of hillarykhuu November 11, 2026 00:26

View session

Copilot AI reviewed Nov 11, 2026

View reviewed changes

Comment thread ...azure-search-documents/src/samples/java/com/azure/search/documents/PreviewSearchSamples.java Resolved

Comment thread ...earch-documents/src/samples/java/com/azure/search/documents/indexes/ListIndexersExample.java Resolved

hillarykhuu and others added 6 commits November 10, 2026 16:54

Update explain stage to use LOGICAL_PLAN constant

3d5d1a1

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Change listIndexers to block until completion

413fde9

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Merge branch 'main' into yangylu/dp-2026-11-01-preview

56afc42

Expose Search listing metadata and typed graph errors

0fdf45a

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

Fix Search listing metadata paging contract test

5dc0cd2

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: dfb252ab-066b-422e-9bc7-164f2db3aa03

hillarykhuu and others added 2 commits November 11, 2026 14:49