mirror of https://github.com/microsoft/agent-framework.git synced 2026-06-16 21:04:09 +08:00

Files

T

Eduard van Valkenburg b065a4ce51 Python: [BREAKING] update context provider APIs, middleware, and per-service-call history persistence (#4992 )

* Rename provider base APIs

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

* Allow provider-added chat and function middleware

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

* Simulate service-stored history per model call

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

* Fix typing regressions in CI

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

* Fix response ID suppression review feedback

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

* Rename per-service-call history persistence APIs

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

* Address context persistence review feedback

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

* Stabilize markdown sample docs

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

* Persist service continuation state per call

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

---------

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

b065a4ce51 · 2026-04-01 16:13:11 +00:00

History

agent_framework_azure_cosmos

Python: [BREAKING] update context provider APIs, middleware, and per-service-call history persistence (#4992 )

2026-04-01 16:13:11 +00:00

samples

Python: [BREAKING] Remove deprecated Python OpenAI/Azure AI surfaces (#4990 )

2026-03-31 20:36:21 +00:00

tests

Python: Fix Python pyright package scoping and typing remediation (#4426 )

2026-03-05 15:32:24 +00:00

AGENTS.md

Python: Add Azure Cosmos history provider package (#4271 )

2026-03-03 12:29:32 +00:00

LICENSE

Python: Add Azure Cosmos history provider package (#4271 )

2026-03-03 12:29:32 +00:00

pyproject.toml

Python: Update Python Packages for rc6 (#4979 )

2026-03-30 21:12:37 +00:00

README.md

Python: Add Azure Cosmos history provider package (#4271 )

2026-03-03 12:29:32 +00:00

README.md

Get Started with Microsoft Agent Framework Azure Cosmos DB

Please install this package via pip:

pip install agent-framework-azure-cosmos --pre

Azure Cosmos DB History Provider

The Azure Cosmos DB integration provides CosmosHistoryProvider for persistent conversation history storage.

Basic Usage Example

from azure.identity.aio import DefaultAzureCredential
from agent_framework_azure_cosmos import CosmosHistoryProvider

provider = CosmosHistoryProvider(
    endpoint="https://<account>.documents.azure.com:443/",
    credential=DefaultAzureCredential(),
    database_name="agent-framework",
    container_name="chat-history",
)

Credentials follow the same pattern used by other Azure connectors in the repository:

Pass a credential object (for example DefaultAzureCredential)
Or pass a key string directly
Or set AZURE_COSMOS_KEY in the environment

Container naming behavior:

Container name is configured on the provider (container_name or AZURE_COSMOS_CONTAINER_NAME)
session_id is used as the Cosmos partition key for reads/writes

See samples/cosmos_history_provider.py for a runnable package-local example.