Verwenden von Speicher in Ihrem Agent

Speicher ist eine wichtige Komponente von Microsoft 365 Agents SDK. Damit können Agenten den Konversationsstatus, Benutzerdaten und andere Informationen sitzungsübergreifend beibehalten. Das SDK unterstützt verschiedene Speicheroptionen, darunter:

• In-Memory-Speicher
• Azure Cosmos DB (ein Microsoft-Datenbankdienst)
• Azure Blob Storage (Speicherdienst von Azure für unstrukturierte Daten)
• Benutzerdefinierte Speicheranbieter

Schlüsselspeicheroptionen

Das Agents SDK bietet mehrere integrierte Speicheranbieter mit jeweils eigenen Anwendungsfällen und Vorteilen. Sie können die Option auswählen, die den Anforderungen Ihres Agenten am besten entspricht. Sie können auch Ihren eigenen benutzerdefinierten Speicheranbieter implementieren.

1. Speicherspeicher

   • Geeignet für Test- und Entwicklungszwecke.
   • Daten werden gelöscht, wenn der Agent neu gestartet wird, sodass sie für die Produktion nicht geeignet ist.
   • Daten sind nur in der Web-App-Instanz verfügbar, daher ist sie nicht geeignet, wenn sie in einem Cluster ausgeführt wird.

2. Azure Cosmos DB (ein Microsoft-Datenbankdienst)

   • Eine global verteilte, multimodellige Datenbank ideal für Produktionsmitarbeiter.
   • Unterstützt partitionierten Speicher für Skalierbarkeit und Leistung.

3. Azure Blob Storage (Speicherdienst von Azure für unstrukturierte Daten)

   • Optimiert zum Speichern unstrukturierter Daten wie Text oder Binärdateien.
   • Wird häufig für Agentstatus- und Transkriptspeicher verwendet.

4. Benutzerdefinierte Speicheroptionen durch Implementierung von IStorage

Verwenden verschiedener Speicheranbieter

Speicherspeicher

Alle Beispiele verwenden MemoryStorage. Dieser Speicher ist veränderlich und eignet sich nur für Entwicklung und Tests. Verwenden Sie für Produktionsszenarien eine langlebigere Speicheroption wie Azure Cosmos DB oder Azure Blob Storage.

C#

In Program.cs registrieren Sie 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-Speicher

C#

1. Fügen Sie eine Paketabhängigkeit für Microsoft.Agents.Storage.CosmosDb.

2. Fügen Sie in Program.cs die IStorage-Registrierung hinzu (oder ersetzen Sie die vorhandene) durch:

   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. Weitere Informationen finden Sie unter CosmosDbPartitionedStorageOptions.

JavaScript

1. Fügen Sie eine Paketabhängigkeit für @microsoft/agents-hosting-storage-cosmos.

2. Konfigurieren und erstellen Sie den Speicher, und übergeben Sie ihn an 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. Weitere Informationen finden Sie unter CosmosDbPartitionedStorageOptions.

Python

1. Fügen Sie eine Paketabhängigkeit für microsoft-agents-storage-cosmos.

2. Konfigurieren und erstellen Sie den Speicher, und übergeben Sie ihn an 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. Weitere Informationen finden Sie unter CosmosDBStorageConfig.

Azure Blob-Speicher

C#

1. Fügen Sie eine Paketabhängigkeit für Microsoft.Agents.Storage.Blobs.

2. Fügen Sie in Program.cs die IStorage-Registrierung hinzu (oder ersetzen Sie die vorhandene durch):

   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. Fügen Sie eine Paketabhängigkeit für @microsoft/agents-hosting-storage-blob.

2. Konfigurieren und erstellen Sie den Speicher, und übergeben Sie ihn an 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. Fügen Sie eine Paketabhängigkeit für microsoft-agents-storage-blob.

2. Konfigurieren und erstellen Sie den Speicher, und übergeben Sie ihn an 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. Weitere Informationen finden Sie unter BlobStorageConfig.