Tallennuksen käyttö agentissa

Tallennus on kriittinen osa Microsoft 365 -agenttien SDK:ta. Se antaa agenteille mahdollisuuden säilyttää keskustelutilan, käyttäjätiedot ja muut tiedot istuntojen välillä. SDK tukee erilaisia tallennusvaihtoehtoja, kuten:

Muistissa oleva tallennus
Azure Cosmos DB
Azure Blob -säilö
Mukautetut tallennuspalveluntarjoajat

Avainsäilytysvaihtoehdot

Agents SDK tarjoaa useita sisäänrakennettuja tallennuspalveluntarjoajia, joilla on omat käyttötapauksensa ja etunsa. Voit valita tallennuspalveluntarjoajan, joka parhaiten sopii agenttisi tarpeisiin. Voit myös toteuttaa oman mukautetun tallennuspalveluntarjoajan.

Muistivarasto
- Soveltuu testaus- ja kehitystarkoituksiin.
- Tiedot tyhjennetään, kun agentti uudelleenkäynnistyy, joten se ei sovellu tuotantokäyttöön.
- Tiedot ovat saatavilla vain verkkosovelluksen instanssissa, joten se ei sovellu klusterikäyttöön.
Azure Cosmos DB
- Maailmanlaajuisesti hajautettu, monimallitietokanta, joka sopii erinomaisesti tuotantoagenttien käyttöön.
- Tukee osioitua tallennustilaa skaalautuvuuden ja suorituskyvyn parantamiseksi.
Azure Blob -säilö
- Optimoitu rakenteettoman datan, kuten tekstin tai binaaritiedostojen, tallentamiseen.
- Yleisesti käytetty agentin tilan ja transkription tallennukseen.
Mukautetut tallennusvaihtoehdot toteuttamalla IStorage

Eri tallennuspalveluntarjoajien käyttö

Muistivarasto

Kaikki esimerkit käyttävät kohdetta MemoryStorage. Tämä tallennus on epäpysyvä ja soveltuu vain kehitykseen ja testaukseen. Tuotantoympäristössä käytä pysyvämpää tallennusvaihtoehtoa, kuten Azure Cosmos DB:tä tai Azure Blob -säilöä.

Kohdassa Program.cs, rekisteröi MemoryStorage:

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

Lisää riippuvuus pakettiin Microsoft.Agents.Storage.CosmosDb.

Lisää Program.cs:ssä (tai korvaa aiempi) IStorage rekisteröinti seuraavasti:

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

Lue lisätietoja kohdasta CosmosDbPartitionedStorageOptions.

Lisää riippuvuus pakettiin @microsoft/agents-hosting-storage-cosmos.

Konfiguroi ja luo tallennus, ja välitä se sitten AgentApplication:lle:

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

Lue lisätietoja kohdasta CosmosDbPartitionedStorageOptions.

Lisää riippuvuus pakettiin microsoft-agents-storage-cosmos.

Konfiguroi ja luo tallennus, ja välitä se sitten AgentApplication:lle:

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

Lue lisätietoja kohdasta CosmosDBStorageConfig.

Azure Blob -säilö

Lisää riippuvuus pakettiin Microsoft.Agents.Storage.Blobs.

Lisää Program.cs:ssä (tai korvaa aiempi) IStorage rekisteröinti seuraavasti:

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

Lisää riippuvuus pakettiin @microsoft/agents-hosting-storage-blob.

Konfiguroi ja luo tallennus, ja välitä se sitten AgentApplication:lle:

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

Lisää riippuvuus pakettiin microsoft-agents-storage-blob.

Konfiguroi ja luo tallennus, ja välitä se sitten AgentApplication:lle:

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

Lue lisätietoja kohdasta BlobStorageConfig.

Palaute

Onko tästä sivusta apua?

Last updated on 2026-07-30

Tallennuksen käyttö agentissa

Avainsäilytysvaihtoehdot

Eri tallennuspalveluntarjoajien käyttö

Muistivarasto

Azure CosmosDb-tallennus

Azure Blob -säilö

Palaute

Lisäresursseja