ใช้ที่เก็บข้อมูลในเอเจนต์ของคุณ

ที่เก็บข้อมูลเป็นองค์ประกอบที่สำคัญของ SDK เอเจนต์สำหรับ Microsoft 365 เอเจนต์สามารถจัดเก็บสถานะการสนทนา ข้อมูลผู้ใช้ และข้อมูลอื่น ๆ ในเซสชันต่าง ๆ ได้ SDK รองรับตัวเลือกการจัดเก็บข้อมูลต่างๆ รวมถึง:

• การจัดเก็บข้อมูลในหน่วยความจำ
• Azure Cosmos DB
• Azure Blob Storage
• ผู้ให้บริการพื้นที่จัดเก็บข้อมูลแบบกำหนดเอง

ตัวเลือกการจัดเก็บที่สำคัญ

SDK เอเจนต์มีผู้ให้บริการพื้นที่จัดเก็บข้อมูลในตัวหลายประเภท ซึ่งแต่ละประเภทมีกรณีการใช้งานและประโยชน์เฉพาะตัว คุณสามารถเลือกผู้ให้บริการพื้นที่จัดเก็บข้อมูลที่เหมาะกับความต้องการของเอเจนต์ของคุณมากที่สุด คุณยังสามารถพัฒนาผู้ให้บริการพื้นที่เก็บข้อมูลแบบกำหนดเองของคุณเองได้อีกด้วย

1. ที่เก็บข้อมูลหน่วยความจำ

   • เหมาะสำหรับการทดสอบและการพัฒนา
   • ข้อมูลจะถูกล้างเมื่อเอเจนต์รีสตาร์ท ดังนั้นจึงไม่เหมาะสำหรับสภาพแวดล้อมการใช้งานจริง
   • ข้อมูลจะพร้อมใช้งานบนอินสแตนซ์เว็บแอปเท่านั้น ดังนั้นจึงไม่เหมาะสมเมื่อทำงานในคลัสเตอร์

2. Azure Cosmos DB

   • ฐานข้อมูลหลายโมเดลที่กระจายอยู่ทั่วโลก เหมาะสำหรับเอเจนต์ในสภาพแวดล้อมการใช้งานจริง
   • รองรับการจัดเก็บข้อมูลแบบแบ่งพาร์ติชันเพื่อการปรับขนาดและประสิทธิภาพ

3. Azure Blob Storage

   • ปรับให้เหมาะสมสำหรับการจัดเก็บข้อมูลที่ไม่มีโครงสร้าง เช่น ไฟล์ข้อความหรือไฟล์ไบนารี
   • นิยมใช้สำหรับสถานะเอเจนต์และการจัดเก็บการถอดความ

4. ตัวเลือกการจัดเก็บแบบกำหนดเองโดยการใช้งาน IStorage

การใช้ผู้ให้บริการพื้นที่เก็บข้อมูลที่แตกต่างกัน

ที่เก็บข้อมูลหน่วยความจำ

ตัวอย่างทั้งหมดใช้ MemoryStorage ที่เก็บข้อมูลนี้ไม่คงทนและเหมาะสำหรับการพัฒนาและทดสอบเท่านั้น สำหรับสถานการณ์การใช้งานจริง ให้ใช้ตัวเลือกที่เก็บข้อมูลแบบถาวร เช่น Azure Cosmos DB หรือ Azure Blob Storage

C#

ใน Program.cs ลงทะเบียน 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

C#

1. เพิ่มการพึ่งพาแพคเกจสำหรับ Microsoft.Agents.Storage.CosmosDb

2. ใน Program.cs เพิ่ม (หรือแทนที่ที่มีอยู่) การลงทะเบียน IStorage ด้วย:

   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. เรียนรู้เพิ่มเติมใน CosmosDbPartitionedStorageOptions

JavaScript

1. เพิ่มการพึ่งพาแพคเกจสำหรับ @microsoft/agents-hosting-storage-cosmos

2. กำหนดค่าและสร้างที่เก็บข้อมูล จากนั้นส่งต่อไปยัง 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. เรียนรู้เพิ่มเติมใน CosmosDbPartitionedStorageOptions

Python

1. เพิ่มการพึ่งพาแพคเกจสำหรับ microsoft-agents-storage-cosmos

2. กำหนดค่าและสร้างที่เก็บข้อมูล จากนั้นส่งต่อไปยัง 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. เรียนรู้เพิ่มเติมใน CosmosDBStorageConfig

Azure Blob Storage

C#

1. เพิ่มการพึ่งพาแพคเกจสำหรับ Microsoft.Agents.Storage.Blobs

2. ใน Program.cs เพิ่ม (หรือแทนที่ที่มีอยู่) การลงทะเบียน IStorage ด้วย:

   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. เพิ่มการพึ่งพาแพคเกจสำหรับ @microsoft/agents-hosting-storage-blob

2. กำหนดค่าและสร้างที่เก็บข้อมูล จากนั้นส่งต่อไปยัง 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. เพิ่มการพึ่งพาแพคเกจสำหรับ microsoft-agents-storage-blob

2. กำหนดค่าและสร้างที่เก็บข้อมูล จากนั้นส่งต่อไปยัง 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. เรียนรู้เพิ่มเติมใน BlobStorageConfig