wehub-resource-sync
db620d33df
dotnet-build-and-test / dotnet-test-functions (push) Has been cancelled
dotnet-build-and-test / paths-filter (push) Has been cancelled
dotnet-build-and-test / dotnet-build (Debug, windows-latest, net9.0) (push) Has been cancelled
dotnet-build-and-test / dotnet-build (Release, ubuntu-latest, net10.0) (push) Has been cancelled
dotnet-build-and-test / dotnet-build (Release, ubuntu-latest, net8.0) (push) Has been cancelled
dotnet-build-and-test / dotnet-build (Release, windows-latest, net472) (push) Has been cancelled
dotnet-build-and-test / dotnet-test (Release, integration, true, ubuntu-latest, net10.0) (push) Has been cancelled
dotnet-build-and-test / dotnet-test (Release, integration, true, windows-latest, net472) (push) Has been cancelled
dotnet-build-and-test / dotnet-foundry-hosted-it (push) Has been cancelled
dotnet-build-and-test / dotnet-build-and-test-check (push) Has been cancelled
dotnet-build-and-test / Integration Test Report (push) Has been cancelled
CodeQL / Analyze (csharp) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
49 lines
1.9 KiB
Markdown
49 lines
1.9 KiB
Markdown
# Azure AI Search Package (agent-framework-azure-ai-search)
|
|
|
|
Integration with Azure AI Search for RAG (Retrieval-Augmented Generation).
|
|
|
|
## Main Classes
|
|
|
|
- **`AzureAISearchContextProvider`** - Context provider that retrieves relevant documents from Azure AI Search
|
|
- **`AzureAISearchSettings`** - Pydantic settings for Azure AI Search configuration
|
|
|
|
## API versions: stable vs preview
|
|
|
|
The package depends on `azure-search-documents>=12.0.0,<13`, which spans both channels, and
|
|
auto-detects which build is installed — there is no `api_version` parameter:
|
|
|
|
| Channel | Install | SDK | Data-plane `api-version` (chosen by the SDK) |
|
|
| --- | --- | --- | --- |
|
|
| **Stable / GA** | `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 picks its own default, so newer
|
|
releases work without code changes (single source of truth = the install).
|
|
|
|
Capability gating keys off `_preview_agentic_features_available` — whether the preview build's
|
|
agentic symbols (`KnowledgeRetrieval{Low,Medium}ReasoningEffort`, `KnowledgeRetrievalOutputMode`)
|
|
can be imported. Agentic **output mode** (`answer_synthesis`) and **extended reasoning effort**
|
|
(`low`/`medium`) ship only in the preview build; on a stable build the provider omits them
|
|
(extractive + minimal) and raises an actionable `ValueError` (citing the installed version) if
|
|
they are explicitly requested. Semantic mode is unaffected.
|
|
|
|
## Usage
|
|
|
|
```python
|
|
from agent_framework.azure import AzureAISearchContextProvider
|
|
|
|
provider = AzureAISearchContextProvider(
|
|
endpoint="https://your-search.search.windows.net",
|
|
index_name="your-index",
|
|
)
|
|
agent = Agent(..., context_provider=provider)
|
|
```
|
|
|
|
## Import Path
|
|
|
|
```python
|
|
from agent_framework.azure import AzureAISearchContextProvider
|
|
# or directly:
|
|
from agent_framework_azure_ai_search import AzureAISearchContextProvider
|
|
```
|