Microsoft.Agents.Storage.CosmosDb

About

• An Agent is inherently stateless. Once your Agent is deployed, it may not run in the same process or on the same machine from one turn to the next. However, your Agent may need to track the context of a conversation so that it can manage its behavior and remember answers to previous questions. The state and storage features of the Agents SDK allow you to add state to your Agent.
• Microsoft.Agents.State use Storage to persist state to memory, Azure Blobs, or CosmosDb.

Changelog

Version	Date	Changelog
1.2.0	2025-08-19	Detailed Changelog
1.3.0	2025-10-22	Detailed Changelog

Main Types

• CosmosDbPartitionedStorage
• CosmosDbPartitionedStorageOptions

Registering CosmosDbPartitionedStorage

appsettings.json

{ "CosmosDbPartitionedStorageOptions": { "CosmosDbEndpoint": "{db_endpoint}", "DatabaseId": "{db_id}", "ContainerId": "{container_id}" } }

Program.cs

builder.Services.AddSingleton<IStorage>((sp) => new CosmosDbPartitionedStorage( builder.Configuration.GetSection(nameof(CosmosDbPartitionedStorageOptions)) .Get<CosmosDbPartitionedStorageOptions>()));

CosmosDbPartitionedStorageOptions.AuthKey or CosmosDbPartitionedStorageOptions.TokenCredential should be defined.