Aracınızda depolamayı kullanın

Depolama, Microsoft 365 Aracılar SDK'sı'nın kritik bir bileşenidir. Aracıların konuşma durumunu, kullanıcı verilerini ve diğer bilgileri oturumlar arasında kalıcı hale getirmesine olanak tanır. SDK, aşağıdakiler dahil olmak üzere çeşitli depolama seçeneklerini destekler:

• Bellek içi depolama
• Azure Cosmos DB
• Azure Blob Depolama
• Özel depolama sağlayıcıları

Ana depolama seçenekleri

Aracılar SDK'sı, her birinin kendi kullanım durumları ve avantajları olan birkaç yerleşik depolama sağlayıcısı sunar. Aracınızın gereksinimlerine en uygun olanı seçebilirsiniz. Ayrıca kendi özel depolama sağlayıcınızı uygulayabilirsiniz.

1. Bellek depolaması

   • Sınama ve geliştirme amacına uygundur.
   • Aracı yeniden başlatıldığında veriler silinir, bu nedenle üretim için uygun değildir.
   • Veriler yalnızca web uygulaması örneğinde kullanılabilir, bu nedenle bir kümede çalışırken uygun değildir.

2. Azure Cosmos DB

   • Üretim aracıları için ideal olan küresel olarak dağıtılmış, çok modelli bir veritabanı.
   • Ölçeklenebilirlik ve performans için bölümlenmiş depolamayı destekler.

3. Azure Blob Depolama

   • Metin veya ikili dosyalar gibi yapılandırılmamış verileri depolamak için optimize edilmiştir.
   • Aracı durumu ve transkripsiyonu depolaması için yaygın olarak kullanılır.

4. IStorage uygulanarak özel depolama seçenekleri

Farklı depolama sağlayıcılarını kullanma

Bellek depolaması

Tüm örnekler MemoryStorage kullanır. Bu depolama geçicidir ve yalnızca geliştirme ve sınama için uygundur. Üretim senaryoları için Azure Cosmos DB veya Azure Blob Depolama gibi daha dayanıklı bir depolama seçeneği kullanın.

C#

Program.cs içinde MemoryStorage kaydettirin:

builder.Services.AddSingleton<IStorage, MemoryStorage>();

JavaScript

import { MemoryStorage, AgentApplication, TurnState } from '@microsoft/agents-hosting'

const storage = new MemoryStorage()

const app = new AgentApplication<TurnState>({
  storage
})

Python

from microsoft_agents.hosting.core import AgentApplication, TurnState, MemoryStorage

storage = MemoryStorage()

app = AgentApplication[TurnState](
    storage=storage,
    adapter=adapter,
    authorization=authorization,
)

Azure Cosmos DB depolaması

C#

1. Microsoft.Agents.Storage.CosmosDb için bir paket bağımlılığı ekleyin.

2. Program.cs içinde IStorage kaydını ekleyin (veya mevcut olanını değiştirin):

   builder.Services.AddSingleton<IStorage>(sp =>
   {
         var options = new CosmosDbPartitionedStorageOptions()
         {
            CosmosDbEndpoint = "your-cosmosdb-endpoint",
            DatabaseId = "your-database-id",
            ContainerId = "your-container-id",
   
            // Get a TokenCredential from your defined Connections
            TokenCredential = sp.GetService<IConnections>().GetConnection("ServiceConnection").GetTokenCredential()
         };
   
         return new CosmosDbPartitionedStorage(options);
   });
   

3. Daha fazla için bkz: CosmosDbPartitionedStorageOptions.

JavaScript

1. @microsoft/agents-hosting-storage-cosmos için bir paket bağımlılığı ekleyin.

2. Depolamayı yapılandırın ve oluşturun, ardından AgentApplication öğesine geçirin:

   import { AgentApplication, TurnState } from '@microsoft/agents-hosting'
   import { CosmosDbPartitionedStorage } from '@microsoft/agents-hosting-storage-cosmos'
   
   const storage = new CosmosDbPartitionedStorage({
     databaseId: process.env.COSMOS_DATABASE_ID,
     containerId: process.env.COSMOS_CONTAINER_ID,
     cosmosClientOptions: {
       endpoint: process.env.COSMOS_ENDPOINT,
       key: process.env.COSMOS_KEY,
     }
   })
   
   const app = new AgentApplication<TurnState>({
     storage
   })
   

3. Daha fazla için bkz: CosmosDbPartitionedStorageOptions.

Python

1. microsoft-agents-storage-cosmos için bir paket bağımlılığı ekleyin.

2. Depolamayı yapılandırın ve oluşturun, ardından AgentApplication öğesine geçirin:

   from microsoft_agents.hosting.core import AgentApplication, TurnState
   from microsoft_agents.storage.cosmos import CosmosDBStorage, CosmosDBStorageConfig
   
   config = CosmosDBStorageConfig(
       cosmos_db_endpoint="your-cosmosdb-endpoint",
       database_id="your-database-id",
       container_id="your-container-id",
       credential=your_token_credential,
   )
   
   storage = CosmosDBStorage(config)
   
   app = AgentApplication[TurnState](
       storage=storage,
       adapter=adapter,
       authorization=authorization,
   )
   

3. Daha fazla için bkz: CosmosDBStorageConfig.

Azure blob depolama

C#

1. Microsoft.Agents.Storage.Blobs için bir paket bağımlılığı ekleyin.

2. Program.cs içinde IStorage kaydını ekleyin (veya mevcut olanını değiştirin):

   builder.Services.AddSingleton<IStorage>(sp =>
   {
      // Get a TokenCredential from your defined Connections
      var tokenCredential = sp.GetService<IConnections>().GetConnection("ServiceConnection").GetTokenCredential();
   
      return new BlobsStorage(
         new Uri("{{your-blobs-storage-endpoint}}/agent-state"),
         tokenCredential);
   });
   

JavaScript

1. @microsoft/agents-hosting-storage-blob için bir paket bağımlılığı ekleyin.

2. Depolamayı yapılandırın ve oluşturun, ardından AgentApplication öğesine geçirin:

   import { AgentApplication, TurnState } from '@microsoft/agents-hosting'
   import { BlobsStorage } from '@microsoft/agents-hosting-storage-blob'
   
   const storage = new BlobsStorage(
     process.env.BLOB_CONTAINER_ID,
     process.env.BLOB_STORAGE_CONNECTION_STRING
   )
   
   const app = new AgentApplication<TurnState>({
     storage
   })
   

Python

1. microsoft-agents-storage-blob için bir paket bağımlılığı ekleyin.

2. Depolamayı yapılandırın ve oluşturun, ardından AgentApplication öğesine geçirin:

   from microsoft_agents.hosting.core import AgentApplication, TurnState
   from microsoft_agents.storage.blob import BlobStorage, BlobStorageConfig
   
   # Using a connection string
   config = BlobStorageConfig(
       container_name="agent-state",
       connection_string="your-connection-string",
   )
   
   # Or using a TokenCredential
   config = BlobStorageConfig(
       container_name="agent-state",
       url="https://your-storage-account.blob.core.windows.net",
       credential=your_token_credential,
   )
   
   storage = BlobStorage(config)
   
   app = AgentApplication[TurnState](
       storage=storage,
       adapter=adapter,
       authorization=authorization,
   )
   

3. Daha fazla için bkz: BlobStorageConfig.