Używanie dostawców magazynu w agencie

Przechowywanie jest kluczowym elementem SDK Microsoft 365 Agents. Umożliwia agentom przechowywanie stanu rozmowy, danych użytkownika oraz innych informacji podczas różnych sesji. SDK obsługuje różne opcje przechowywania, w tym:

• Przechowywanie w pamięci operacyjnej
• Azure Cosmos DB
• Azure Blob Storage
• Niestandardowi dostawcy pamięci masowej

Kluczowe opcje przechowywania

Agents SDK oferuje kilka wbudowanych dostawców pamięci masowej, z których każdy ma własne zastosowania i korzyści. Możesz wybrać taki, który najlepiej odpowiada potrzebom Twojego agenta. Możesz też zaimplementować własnego niestandardowego dostawcę pamięci masowej.

1. Przechowywanie w pamięci operacyjnej

   • Nadaje się do celów testowych i rozwojowych.
   • Dane są usuwane po ponownym uruchomieniu agenta, więc nie nadaje się do produkcji.
   • Dane są dostępne tylko w instancji aplikacji internetowej, więc nie nadaje się do działania w klastrze.

2. Azure Cosmos DB

   • Globalnie dystrybuowana, wielomodelowa baza danych idealna dla agentów produkcyjnych.
   • Obsługuje partycjonowane przechowywanie dla skalowalności i wydajności.

3. Azure Blob Storage

   • Zoptymalizowany do przechowywania danych nieustrukturyzowanych, takich jak pliki tekstowe lub binarne.
   • Powszechnie używany do przechowywania stanu agenta oraz transkrypcji.

4. Opcje niestandardowego przechowywania poprzez implementację IStorage

Korzystanie z różnych dostawców pamięci masowej

Przechowywanie w pamięci operacyjnej

We wszystkich przykładach użyto MemoryStorage. To przechowywanie jest nietrwałe i nadaje się wyłącznie do celów deweloperskich i testowych. W scenariuszach produkcyjnych używaj bardziej trwałej opcji przechowywania, takiej jak Azure Cosmos DB lub Azure Blob Storage.

C#

W Program.cs należy zarejestrować 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 storage

C#

1. Dodaj zależność dla pakietu Microsoft.Agents.Storage.CosmosDb.

2. W Program.cs, dodaj (lub zastąp istniejącą) IStorage rejestrację przez:

   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. Więcej informacji pod adresem: CosmosDbPartitionedStorageOptions.

JavaScript

1. Dodaj zależność dla pakietu @microsoft/agents-hosting-storage-cosmos.

2. Skonfiguruj i utwórz magazyn, a następnie przekaż go do 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. Więcej informacji pod adresem: CosmosDbPartitionedStorageOptions.

Python

1. Dodaj zależność dla pakietu microsoft-agents-storage-cosmos.

2. Skonfiguruj i utwórz magazyn, a następnie przekaż go do 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. Więcej informacji pod adresem: CosmosDBStorageConfig.

Azure Blob Storage

C#

1. Dodaj zależność dla pakietu Microsoft.Agents.Storage.Blobs.

2. W Program.cs, dodaj (lub zastąp istniejącą) IStorage rejestrację przez:

   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. Dodaj zależność dla pakietu @microsoft/agents-hosting-storage-blob.

2. Skonfiguruj i utwórz magazyn, a następnie przekaż go do 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. Dodaj zależność dla pakietu microsoft-agents-storage-blob.

2. Skonfiguruj i utwórz magazyn, a następnie przekaż go do 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. Więcej informacji pod adresem: BlobStorageConfig.