Menggunakan penyimpanan di agen

Penyimpanan adalah komponen penting dari Agen SDK Microsoft 365. Ini memungkinkan agen menyimpan secara berkelanjutan status percakapan, data pengguna, dan informasi lainnya di berbagai sesi. SDK mendukung berbagai opsi penyimpanan, termasuk:

• Penyimpanan dalam memori
• Azure Cosmos DB
• Azure Blob Storage
• Penyedia penyimpanan khusus

Opsi penyimpanan utama

Agen SDK menyediakan beberapa penyedia penyimpanan bawaan, masing-masing dengan kasus penggunaan dan manfaatnya sendiri. Anda dapat memilih salah satu yang paling sesuai dengan kebutuhan agen Anda. Anda juga dapat menerapkan penyedia penyimpanan kustom Anda sendiri.

1. Penyimpanan memori

   • Cocok untuk tujuan pengujian dan pengembangan.
   • Data dibersihkan ketika agen dimulai ulang, menjadikannya tidak cocok untuk produksi.
   • Data hanya tersedia pada instans aplikasi web, sehingga tidak cocok digunakan saat berjalan dalam kluster.

2. Azure Cosmos DB

   • Basis data multimodel yang terdistribusi secara global, sangat cocok untuk agen produksi.
   • Mendukung penyimpanan yang dipartisi untuk skalabilitas dan performa.

3. Azure Blob Storage

   • Dioptimalkan untuk menyimpan data tidak terstruktur seperti teks atau file biner.
   • Umumnya digunakan untuk menyimpan status agen dan transkrip.

4. Opsi penyimpanan kustom dengan mengimplementasikan IStorage

Menggunakan penyedia penyimpanan yang berbeda

Penyimpanan memori

Semua sampel menggunakan MemoryStorage. Penyimpanan ini bersifat volatil dan hanya cocok untuk pengembangan dan pengujian. Untuk skenario produksi, gunakan opsi penyimpanan yang lebih andal seperti Azure Cosmos DB atau Azure Blob Storage.

C#

Dalam Program.cs, daftarkan MemoryStorage:

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,
)

Penyimpanan Azure Cosmos DB

C#

1. Tambahkan dependensi paket untuk Microsoft.Agents.Storage.CosmosDb.

2. Dalam Program.cs, tambahkan pendaftaran (atau ganti yang ada) IStorage dengan:

   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. Pelajari lebih lanjut di CosmosDbPartitionedStorageOptions.

JavaScript

1. Tambahkan dependensi paket untuk @microsoft/agents-hosting-storage-cosmos.

2. Konfigurasikan dan buat penyimpanan, lalu teruskan ke AgentApplication:

   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. Pelajari lebih lanjut di CosmosDbPartitionedStorageOptions.

Python

1. Tambahkan dependensi paket untuk microsoft-agents-storage-cosmos.

2. Konfigurasikan dan buat penyimpanan, lalu teruskan ke AgentApplication:

   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. Pelajari lebih lanjut di CosmosDBStorageConfig.

Azure blob storage

C#

1. Tambahkan dependensi paket untuk Microsoft.Agents.Storage.Blobs.

2. Dalam Program.cs, tambahkan pendaftaran (atau ganti yang ada) IStorage dengan:

   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. Tambahkan dependensi paket untuk @microsoft/agents-hosting-storage-blob.

2. Konfigurasikan dan buat penyimpanan, lalu teruskan ke AgentApplication:

   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. Tambahkan dependensi paket untuk microsoft-agents-storage-blob.

2. Konfigurasikan dan buat penyimpanan, lalu teruskan ke AgentApplication:

   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. Pelajari lebih lanjut di BlobStorageConfig.