Utiliser le stockage dans votre assistant

Le stockage est un composant critique du Microsoft 365 Agents SDK. Il permet aux assistants de conserver l’état de la conversation, les données utilisateur et d’autres informations entre les sessions. Le SDK prend en charge différentes options de stockage, notamment :

• Stockage mémoire
• Azure Cosmos DB
• Stockage Blob Azure
• Fournisseurs de stockage personnalisés

Options de stockage clés

Le SDK Agents propose plusieurs fournisseurs de stockage intégrés, chacun ayant ses propres cas d’utilisation et avantages. Vous pouvez sélectionner celui qui correspond le mieux aux besoins de votre assistant. Vous pouvez également implémenter votre propre fournisseur de stockage personnalisé.

1. Stockage mémoire

   • Adapté aux fins de test et de développement.
   • Les données sont effacées lorsque l’assistant redémarre, ce qui le rend inadapté à la production.
   • Les données ne sont disponibles que sur l’instance d’application web, ce qui le rend inadapté lors de l’exécution dans un cluster.

2. Azure Cosmos DB

   • Une base de données multimodèle distribuée mondialement idéale pour les assistants de production.
   • Prend en charge le stockage partitionné pour la scalabilité et les performances.

3. Stockage Blob Azure

   • Optimisé pour stocker des données non structurées telles que des fichiers texte ou binaires.
   • Couramment utilisé pour le stockage d’état et de transcription de l’assistant.

4. Options de stockage personnalisées en implémentant IStorage

Utilisation de différents fournisseurs de stockage

Stockage mémoire

Tous les exemples utilisent MemoryStorage. Ce stockage est volatil et adapté uniquement au développement et aux tests. Pour les scénarios de production, utilisez une option de stockage plus durable comme Azure Cosmos DB ou Stockage Blob Azure.

C#

Dans Program.cs, s’inscrire à 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,
)

Stockage Azure Cosmos DB

C#

1. Ajoutez une dépendance de package pour Microsoft.Agents.Storage.CosmosDb.

2. Dans Program.cs, ajoutez (ou remplacez l’inscription existante) IStorage par :

   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. En savoir plus sur CosmosDbPartitionedStorageOptions.

JavaScript

1. Ajoutez une dépendance de package pour @microsoft/agents-hosting-storage-cosmos.

2. Configurez et créez le stockage, puis passez-le à 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. En savoir plus sur CosmosDbPartitionedStorageOptions.

Python

1. Ajoutez une dépendance de package pour microsoft-agents-storage-cosmos.

2. Configurez et créez le stockage, puis passez-le à 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. En savoir plus sur CosmosDBStorageConfig.

Stockage Blob Azure

C#

1. Ajoutez une dépendance de package pour Microsoft.Agents.Storage.Blobs.

2. Dans Program.cs, ajoutez (ou remplacez l’inscription existante) IStorage par :

   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. Ajoutez une dépendance de package pour @microsoft/agents-hosting-storage-blob.

2. Configurez et créez le stockage, puis passez-le à 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. Ajoutez une dépendance de package pour microsoft-agents-storage-blob.

2. Configurez et créez le stockage, puis passez-le à 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. En savoir plus sur BlobStorageConfig.