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.

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.
Azure Cosmos DB
- En globalt distribuert database med flere modeller som er ideell for produksjonsagenter.
- Støtter partisjonert lagringsplass for skalerbarhet og ytelse.
Azure Blob Storage
- Optimalisert for lagring av ustrukturerte data, for eksempel tekst eller binære filer.
- Brukes vanligvis for agenttilstand og utskriftslagring.
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.

Registrer MemoryStorage i Program.cs:

builder.Services.AddSingleton<IStorage, MemoryStorage>();

import { MemoryStorage, AgentApplication, TurnState } from '@microsoft/agents-hosting'

const storage = new MemoryStorage()

const app = new AgentApplication<TurnState>({
  storage
})

from microsoft_agents.hosting.core import AgentApplication, TurnState, MemoryStorage

storage = MemoryStorage()

app = AgentApplication[TurnState](
    storage=storage,
    adapter=adapter,
    authorization=authorization,
)

Azure CosmosDb-lagring

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

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);
});

Mer informasjon i CosmosDbPartitionedStorageOptions.

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

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
})

Mer informasjon i CosmosDbPartitionedStorageOptions.

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

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,
)

Mer informasjon i CosmosDBStorageConfig.

Azure Blob Storage

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

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);
});

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

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
})

Legg til en pakkeavhengighet for microsoft-agents-storage-blob.

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,
)

Mer informasjon i BlobStorageConfig.

Tilbakemeldinger

Var denne siden nyttig?

Last updated on 2026-07-29

Bruk lagring i agenten

Viktige lagringsalternativer

Bruk av ulike lagringsleverandører

Minnelagring

Azure CosmosDb-lagring

Azure Blob Storage

Tilbakemeldinger

Flere ressurser