Azure.Search.Documents_12.0.0

Azure OpenAI .NET Releases / 5/2/2026

📰 NewsDeveloper Stack & InfrastructureSignals & Early TrendsTools & Practical UsageModels & Research

Key Points

  • Azure.Search.Documents 12.0.0 (2026-05-01) adds support for the 2026-04-01 Azure Search service version.
  • The release introduces new agentic knowledge base retrieval capabilities via KnowledgeBaseRetrievalClient, along with comprehensive knowledge base and knowledge source management and retrieval models.
  • It adds multiple knowledge source types (e.g., Azure Blob, Search Index, OneLake, and Web) and associated ingestion/status models for tracking synchronization and ingestion progress.
  • The SDK expands AI-related skill and vectorization support, including new skill types (ChatCompletionSkill, ContentUnderstandingSkill, DocumentIntelligenceLayoutSkill) and Azure Machine Learning-based vectorizer components.
  • Additional search features include index alias management (SearchAlias), improved search debugging (DebugInfo), stricter vector post-filtering (VectorFilterMode.StrictPostFilter), and new query types for image-based vector search.

12.0.0 (2026-05-01)

Features Added

  • Added support for 2026-04-01 service version.
  • Added KnowledgeBaseRetrievalClient for agentic retrieval operations against knowledge bases.
  • Added knowledge base management types: KnowledgeBase, KnowledgeBaseModel, KnowledgeBaseAzureOpenAIModel, and KnowledgeSourceReference.
  • Added knowledge source types: AzureBlobKnowledgeSource, SearchIndexKnowledgeSource, IndexedOneLakeKnowledgeSource, and WebKnowledgeSource with associated parameters.
  • Added knowledge base retrieval models: KnowledgeBaseRetrievalRequest, KnowledgeBaseRetrievalResponse, KnowledgeBaseMessage, KnowledgeBaseMessageContent, and KnowledgeBaseReference with typed variants (KnowledgeBaseAzureBlobReference, KnowledgeBaseSearchIndexReference, KnowledgeBaseIndexedOneLakeReference, KnowledgeBaseWebReference).
  • Added knowledge base activity tracking: KnowledgeBaseActivityRecord, KnowledgeBaseAgenticReasoningActivityRecord, and KnowledgeBaseModelWebSummarizationActivityRecord.
  • Added KnowledgeBaseActivityRecordType.ModelWebSummarization value for LLM web summarization activity records.
  • Added knowledge source ingestion and status models: KnowledgeSourceIngestionParameters, KnowledgeSourceStatus, KnowledgeSourceStatistics, and SynchronizationState.
  • Added AI skill types: ChatCompletionSkill, ContentUnderstandingSkill, and DocumentIntelligenceLayoutSkill with associated configuration models.
  • Added AzureMachineLearningVectorizer and AzureMachineLearningParameters for AML-based vectorization.
  • Added SearchAlias for index alias management.
  • Added SearchIndexResponse model returned by index operations.
  • Added NativeBlobSoftDeleteDeletionDetectionPolicy for native blob soft delete detection.
  • Added VectorizableImageBinaryQuery and VectorizableImageUrlQuery for image-based vector search.
  • Added DebugInfo property to SearchResults<T> and SearchResultsPage<T> for enhanced search debugging.
  • Added VectorFilterMode.StrictPostFilter option for strict post-filtering in vector search.
  • Added SearchServiceCounters.AliasCounter for alias resource tracking.
  • Added SearchServiceLimits.MaxCumulativeIndexerRuntimeSeconds for runtime constraints.
  • Added IndexerChangeTrackingState for indexer change tracking status.
  • Added LookupDocument model for document lookup responses.
  • Added nullable implicit conversion operators for SemanticErrorMode, SemanticErrorReason, SemanticSearchResultsType, and VectorFilterMode.
  • Added AIServicesAccountIdentity and AIServicesAccountKey for AI services authentication.
  • Added SearchClientSettings to support creating a SearchClient from IConfiguration, including configuration-based credential resolution and dependency injection registration.
  • Added SearchIndexClientSettings to support creating a SearchIndexClient from IConfiguration, including configuration-based credential resolution and dependency injection registration.
  • Added SearchIndexerClientSettings to support creating a SearchIndexerClient from IConfiguration, including configuration-based credential resolution and dependency injection registration.
  • Added KnowledgeBaseRetrievalClientSettings to support creating a KnowledgeBaseRetrievalClient from IConfiguration, including configuration-based credential resolution and dependency injection registration.

Breaking Changes

  • Deprecated EntityRecognitionSkill.SkillVersion.V1 is now obsolete. Use V3 instead.
  • Deprecated EntityRecognitionSkill.IncludeTypelessEntities is now obsolete. Use V3 instead.
  • Deprecated SentimentSkill.SkillVersion.V1 is now obsolete. Use V3 instead.