Files
Eduard van Valkenburg c37f74f898 Python: Add Azure Cosmos history provider package (#4271)
* Created cosmos history provider

* add marker

* Python: address Cosmos PR feedback

- address provider/test/sample review feedback and cleanup typing
- add cosmos integration test coverage and skip gating
- add dedicated cosmos emulator jobs to python merge/integration workflows
- switch cosmos workflow execution to package poe integration-tests task

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

* Python: handle empty Cosmos session id

- replace default partition fallback for empty session_id
- log warning and generate GUID when session_id is empty
- update unit tests to validate GUID fallback behavior

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

* fix sample

* fix cross partition query

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-03 12:29:32 +00:00

29 lines
724 B
Markdown

# Azure Cosmos DB Package (agent-framework-azure-cosmos)
Azure Cosmos DB history provider integration for Agent Framework.
## Main Classes
- **`CosmosHistoryProvider`** - Persistent conversation history storage backed by Azure Cosmos DB
## Usage
```python
from agent_framework_azure_cosmos import CosmosHistoryProvider
provider = CosmosHistoryProvider(
endpoint="https://<account>.documents.azure.com:443/",
credential="<key-or-token-credential>",
database_name="agent-framework",
container_name="chat-history",
)
```
Container name is configured on the provider. `session_id` is used as the partition key.
## Import Path
```python
from agent_framework_azure_cosmos import CosmosHistoryProvider
```