Opslag gebruiken in uw agent

Opslag is een cruciaal onderdeel van de SDK voor Microsoft 365-agenten. Het stelt agenten in staat om gespreksstatus, gebruikersgegevens en andere informatie over sessies heen te behouden. De SDK ondersteunt verschillende opslagopties, waaronder:

• Opslag in geheugen
• Azure Cosmos DB
• Azure Blob Storage
• Aangepaste opslagproviders

Belangrijke opslagopties

De Agents SDK biedt verschillende ingebouwde opslagproviders, elk met hun eigen gebruiksscenario's en voordelen. U kunt de opslagprovider kiezen die het beste past bij de behoeften van uw agent. U kunt ook uw eigen aangepaste opslagprovider implementeren.

1. Opslag in geheugen

   • Geschikt voor test- en ontwikkelingsdoeleinden.
   • Gegevens worden gewist wanneer de agent opnieuw opstart, dus het is ongeschikt voor productie.
   • Gegevens zijn alleen beschikbaar op het webtoepassingsexemplaar, waardoor het niet geschikt is voor gebruik in een cluster.

2. Azure Cosmos DB

   • Een wereldwijd gedistribueerde multimodeldatabase, ideaal voor productieagenten.
   • Ondersteunt gepartitioneerde opslag voor schaalbaarheid en prestaties.

3. Azure Blob Storage

   • Geoptimaliseerd voor het opslaan van ongestructureerde gegevens, zoals tekst of binaire bestanden.
   • Wordt vaak gebruikt voor het opslaan van agentstatus en transcripties.

4. Aangepaste opslagopties door IStorage te implementeren

Verschillende opslagproviders gebruiken

Opslag in geheugen

Alle voorbeelden gebruiken MemoryStorage. Deze opslag is vluchtig en alleen geschikt voor ontwikkeling en testen. Gebruik voor productiescenario's een duurzamere opslagoptie, zoals Azure Cosmos DB of Azure Blob Storage.

C#

In Program.cs registreert u 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-opslag

C#

1. Voeg een pakketafhankelijkheid toe voor Microsoft.Agents.Storage.CosmosDb.

2. Voeg in Program.csIStorage-registratie toe ( of vervang die) met:

   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. Meer informatie vindt u in CosmosDbPartitionedStorageOptions.

JavaScript

1. Voeg een pakketafhankelijkheid toe voor @microsoft/agents-hosting-storage-cosmos.

2. Configureer en maak de opslag, en geef deze dan door aan 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. Meer informatie vindt u in CosmosDbPartitionedStorageOptions.

Python

1. Voeg een pakketafhankelijkheid toe voor microsoft-agents-storage-cosmos.

2. Configureer en maak de opslag, en geef deze dan door aan 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. Meer informatie vindt u in CosmosDBStorageConfig.

Azure Blob Storage

C#

1. Voeg een pakketafhankelijkheid toe voor Microsoft.Agents.Storage.Blobs.

2. Voeg in Program.csIStorage-registratie toe ( of vervang die) met:

   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. Voeg een pakketafhankelijkheid toe voor @microsoft/agents-hosting-storage-blob.

2. Configureer en maak de opslag, en geef deze dan door aan 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. Voeg een pakketafhankelijkheid toe voor microsoft-agents-storage-blob.

2. Configureer en maak de opslag, en geef deze dan door aan 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. Meer informatie vindt u in BlobStorageConfig.