This release is a pre-release and may not be stable for production use.
Get Started with Microsoft Agent Framework Azure AI Search
Please install this package via pip:
pip install agent-framework-azure-ai-search --pre
Azure AI Search Integration
The Azure AI Search integration provides context providers for RAG (Retrieval Augmented Generation) capabilities with two modes:
- Semantic Mode: Fast hybrid search (vector + keyword) with semantic ranking
- Agentic Mode: Multi-hop reasoning using Knowledge Bases for complex queries
API versions: stable vs preview
The integration auto-detects which build of azure-search-documents is installed — there is
nothing to configure in code:
| Channel | Install | Data-plane api-version (chosen by the SDK) |
|---|---|---|
| Stable | pip install azure-search-documents (>=12.0.0) |
2026-04-01 |
| Preview | pip install --pre "azure-search-documents>=12.1.0b1" |
2026-05-01-preview |
The provider never pins an api-version; the installed build selects its own, so newer
releases work without code changes.
Agentic output modes (answer_synthesis) and extended reasoning effort (low/medium)
ship only in the preview build. When a stable build is installed, the provider uses extractive
output with minimal reasoning effort and raises an actionable error if a preview-only option is
explicitly requested. Switching channels is a single change — the install — with no code edits.
Query-time user identity
Agentic retrieval can forward a caller-specific Azure AI Search authorization token when the
index uses permission fields for document-level access control. Pass a sync or async Azure token
credential for the caller via query_source_credential; the provider requests the Azure AI Search
resource scope and forwards the token on each Knowledge Base retrieval request. This capability
requires azure-search-documents>=12.1.0b1, installed with
pip install --pre "azure-search-documents>=12.1.0b1".
context_provider = AzureAISearchContextProvider(
endpoint=search_endpoint,
credential=application_credential,
mode="agentic",
knowledge_base_name=knowledge_base_name,
query_source_credential=user_credential,
)
Basic Usage Example
See the Azure AI Search context provider examples which demonstrate:
- Semantic search with hybrid (vector + keyword) queries
- Agentic mode with Knowledge Bases for complex multi-hop reasoning
- Environment variable configuration with Settings class
- API key and managed identity authentication
4 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_framework_azure_ai_search-1.0.0b260813.tar.gz.
File metadata
- Download URL: agent_framework_azure_ai_search-1.0.0b260813.tar.gz
- Upload date:
- Size: 14.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b39a02106cb6b17ca1766f59a24d5c93ce59f59967101efb8d04392660a914f6
|
|
| MD5 |
864f9eef0552d6b3b5667a8942526a59
|
|
| BLAKE2b-256 |
e74fe2f41e0dece09d85fb033465ed7fc19a4800f9c29c44ea75b292d33180f5
|
File details
Details for the file agent_framework_azure_ai_search-1.0.0b260813-py3-none-any.whl.
File metadata
- Download URL: agent_framework_azure_ai_search-1.0.0b260813-py3-none-any.whl
- Upload date:
- Size: 14.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c76e9ba89581aafb0678e3048d30ef7a2cdc532d10dd90c9600bbe65a8ec7899
|
|
| MD5 |
931b1bafa2f8924e00456967d08e22eb
|
|
| BLAKE2b-256 |
3b1ac989af1a44c4c10e15e6010356d4d3e7a98fcc1950c79d118a3b8d26af26
|
