Brug lager i din agent

Lagring er en kritisk komponent i SDK til Microsoft 365-agenter. Det gør det muligt for agenter at bevare samtalestatus, brugerdata og anden information på tværs af sessioner. SDK'et understøtter forskellige lagringsmuligheder, herunder:

• Lager i hukommelse
• Azure Cosmos DB
• Azure Blob Storage
• Brugerdefinerede lagringsudbydere

Nøglelagringsmuligheder

Agents SDK'en tilbyder flere indbyggede lagringsudbydere, hver med sine egne anvendelsesområder og fordele. Du kan vælge den, der passer bedst til din agents behov. Du kan også implementere din egen brugerdefinerede lagerudbyder.

1. Hukommelseslager

   • Egnet til test- og udviklingsformål.
   • Data ryddes, når agenten genstarter, så den er uegnet til produktion.
   • Data er kun tilgængelige på webappforekomsten, hvilket gør dem uegnede, når de kører i en klynge.

2. Azure Cosmos DB

   • En globalt distribueret database med flere modeller, der er ideel til produktionsagenter.
   • Understøtter opdelt lager for skalerbarhed og ydeevne.

3. Azure Blob Storage

   • Optimeret til lagring af ustrukturerede data, f.eks. tekst eller binære filer.
   • Bruges ofte til agenttilstand og transskriptionslager.

4. Brugerdefinerede lagringsmuligheder ved at implementere IStorage

Brug af forskellige lagerudbydere

Hukommelseslager

Alle eksempler bruges MemoryStorage. Denne lagring er flygtig og kun egnet til udvikling og test. Til produktionsscenarier bør du bruge en mere varig lagringsløsning som Azure Cosmos DB eller Azure Blob Storage.

C#

I Program.cs, registrer 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 Cosmos DB-lagring

C#

1. Tilføj en pakkeafhængighed for Microsoft.Agents.Storage.CosmosDb.

2. I Program.cs skal du tilføje (eller erstatte eksisterende) IStorage-registrering med:

   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. Få mere at vide i CosmosDbPartitionedStorageOptions.

JavaScript

1. Tilføj en pakkeafhængighed for @microsoft/agents-hosting-storage-cosmos.

2. Konfigurér og opret lagringen, og send den derefter til 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. Få mere at vide i CosmosDbPartitionedStorageOptions.

Python

1. Tilføj en pakkeafhængighed for microsoft-agents-storage-cosmos.

2. Konfigurér og opret lagringen, og send den derefter til 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. Få mere at vide i CosmosDBStorageConfig.

Azure Blob Storage

C#

1. Tilføj en pakkeafhængighed for Microsoft.Agents.Storage.Blobs.

2. I Program.cs skal du tilføje (eller erstatte eksisterende) IStorage-registrering med:

   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. Tilføj en pakkeafhængighed for @microsoft/agents-hosting-storage-blob.

2. Konfigurér og opret lagringen, og send den derefter til 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. Tilføj en pakkeafhængighed for microsoft-agents-storage-blob.

2. Konfigurér og opret lagringen, og send den derefter til 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. Få mere at vide i BlobStorageConfig.