Χρήση χώρου αποθήκευσης στον παράγοντά σας

Η αποθήκευση αποτελεί κρίσιμο στοιχείο του SDK παραγόντων Microsoft 365. Επιτρέπει στους παράγοντες να αποθηκεύουν την κατάσταση της συνομιλίας, τα δεδομένα χρήστη και άλλες πληροφορίες μεταξύ συνεδριών. Το SDK υποστηρίζει διάφορες επιλογές αποθήκευσης, όπως:

• Αποθήκευση στη μνήμη
• Azure Cosmos DB
• Εικονίδιο χώρου αποθήκευσης αντικειμένου Blob Azure
• Προσαρμοσμένοι πάροχοι αποθήκευσης

Βασικές επιλογές αποθήκευσης

Το Agents SDK παρέχει πολλούς ενσωματωμένους παρόχους αποθήκευσης, ο καθένας με τις δικές του περιπτώσεις χρήσης και πλεονεκτήματα. Μπορείτε να επιλέξετε αυτό που ταιριάζει καλύτερα στις ανάγκες του παράγοντα σας. Μπορείτε επίσης να υλοποιήσετε τον δικό σας προσαρμοσμένο πάροχο αποθήκευσης.

1. Αποθήκευση στη μνήμη

   • Κατάλληλο για σκοπούς δοκιμών και ανάπτυξης.
   • Τα δεδομένα διαγράφονται κατά την επανεκκίνηση του παράγοντα, επομένως δεν είναι κατάλληλα για περιβάλλον παραγωγής.
   • Τα δεδομένα είναι διαθέσιμα μόνο στο instance της web εφαρμογής, επομένως δεν είναι κατάλληλα όταν εκτελείται σε σύμπλεγμα.

2. Azure Cosmos DB

   • Μια παγκόσμια κατανεμημένη βάση δεδομένων πολλαπλών μοντέλων, ιδανική για παραγωγικούς παράγοντες.
   • Υποστηρίζει κατατμημένη αποθήκευση για επεκτασιμότητα και απόδοση.

3. Εικονίδιο χώρου αποθήκευσης αντικειμένου Blob Azure

   • Βελτιστοποιημένο για την αποθήκευση μη δομημένων δεδομένων όπως κείμενο ή δυαδικά αρχεία.
   • Χρησιμοποιείται συνήθως για αποθήκευση κατάστασης παράγοντα και αποθήκευση κειμένου συνομιλίας.

4. Προσαρμοσμένες επιλογές αποθήκευσης μέσω υλοποίησης IStorage

Χρήση διαφορετικών παρόχων αποθήκευσης

Αποθήκευση στη μνήμη

Όλα τα παραδείγματα χρησιμοποιούν MemoryStorage. Αυτή η αποθήκευση είναι πτητική και κατάλληλη μόνο για ανάπτυξη και δοκιμές. Για σενάρια παραγωγής, χρησιμοποιήστε μια πιο βιώσιμη επιλογή αποθήκευσης, όπως το Azure Cosmos DB ή το Azure Blob Storage.

C#

Στο Program.cs, καταχωρήστε το 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,
)

Χώρος αποθήκευσης Azure CosmosDb

C#

1. Προσθέστε μια εξάρτηση πακέτου για Microsoft.Agents.Storage.CosmosDb.

2. Στο Program.cs, προσθέστε (ή αντικαταστήστε την υπάρχουσα) IStorage εγγραφή με:

   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. Μάθετε περισσότερα στο CosmosDbPartitionedStorageOptions:

JavaScript

1. Προσθέστε μια εξάρτηση πακέτου για @microsoft/agents-hosting-storage-cosmos.

2. Διαμορφώστε και δημιουργήστε τον χώρο αποθήκευσης και, στη συνέχεια, περάστε τον στο 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. Μάθετε περισσότερα στο CosmosDbPartitionedStorageOptions:

Python

1. Προσθέστε μια εξάρτηση πακέτου για microsoft-agents-storage-cosmos.

2. Διαμορφώστε και δημιουργήστε τον χώρο αποθήκευσης και, στη συνέχεια, περάστε τον στο 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. Μάθετε περισσότερα στο CosmosDBStorageConfig:

Χώρος αποθήκευσης αντικειμένου Blob Azure

C#

1. Προσθέστε μια εξάρτηση πακέτου για Microsoft.Agents.Storage.Blobs.

2. Στο Program.cs, προσθέστε (ή αντικαταστήστε την υπάρχουσα) IStorage εγγραφή με:

   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.

2. Διαμορφώστε και δημιουργήστε τον χώρο αποθήκευσης και, στη συνέχεια, περάστε τον στο 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. Προσθέστε μια εξάρτηση πακέτου για microsoft-agents-storage-blob.

2. Διαμορφώστε και δημιουργήστε τον χώρο αποθήκευσης και, στη συνέχεια, περάστε τον στο 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. Μάθετε περισσότερα στο BlobStorageConfig: