Bruk lagring i agenten

Lagring er en kritisk komponent i SDK for Microsoft 365-agenter. Den lar agenter bevare samtaletilstand, brukerdata og annen informasjon på tvers av økter. SDK-en støtter ulike lagringsalternativer, inkludert:

• Lagring i minnet
• Azure Cosmos DB
• Azure Blob Storage
• Egendefinerte lagringsleverandører

Viktige lagringsalternativer

SDK for agenter tilbyr flere innebygde lagringsleverandører, hver med sine egne bruksområder og fordeler. Du kan velge den som passer best til agentens behov. Du kan også implementere din egen tilpassede lagringsleverandør.

1. Minnelagring

   • Egnet for test- og utviklingsformål.
   • Data fjernes når agenten starter på nytt og er dermed uegnet for produksjon.
   • Data er bare tilgjengelig i nettappforekomsten og er dermed uegnet når du kjører i en klynge.

2. Azure Cosmos DB

   • En globalt distribuert database med flere modeller som er ideell for produksjonsagenter.
   • Støtter partisjonert lagringsplass for skalerbarhet og ytelse.

3. Azure Blob Storage

   • Optimalisert for lagring av ustrukturerte data, for eksempel tekst eller binære filer.
   • Brukes vanligvis for agenttilstand og utskriftslagring.

4. Tilpassede lagringsalternativer ved å implementere IStorage

Bruk av ulike lagringsleverandører

Minnelagring

Alle eksempler bruker MemoryStorage. Denne lagringen er flyktig og bare egnet til utvikling og testing. For produksjonsscenarioer velger du et mer pålitelig lagringsalternativ som Azure Cosmos DB eller Azure Blob Storage.

C#

Registrer MemoryStorage i Program.cs:

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-lagring

C#

1. Legg til en pakkeavhengighet for Microsoft.Agents.Storage.CosmosDb.

2. Legg til (eller erstatt eksisterende) IStorage-registrering i Program.cs 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. Mer informasjon i CosmosDbPartitionedStorageOptions.

JavaScript

1. Legg til en pakkeavhengighet for @microsoft/agents-hosting-storage-cosmos.

2. Konfigurer og opprett lagringen, og send den deretter 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. Mer informasjon i CosmosDbPartitionedStorageOptions.

Python

1. Legg til en pakkeavhengighet for microsoft-agents-storage-cosmos.

2. Konfigurer og opprett lagringen, og send den deretter 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. Mer informasjon i CosmosDBStorageConfig.

Azure Blob Storage

C#

1. Legg til en pakkeavhengighet for Microsoft.Agents.Storage.Blobs.

2. Legg til (eller erstatt eksisterende) IStorage-registrering i Program.cs 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. Legg til en pakkeavhengighet for @microsoft/agents-hosting-storage-blob.

2. Konfigurer og opprett lagringen, og send den deretter 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. Legg til en pakkeavhengighet for microsoft-agents-storage-blob.

2. Konfigurer og opprett lagringen, og send den deretter 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. Mer informasjon i BlobStorageConfig.