Doğrudan depolama alanına yazma

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Ara yazılım veya bağlam nesnesi kullanmadan doğrudan depolama nesnenizi okuyabilir ve yazabilirsiniz. Bu, botunuzun bir konuşmayı korumak için kullandığı veriler veya botunuzun konuşma akışının dışındaki bir kaynaktan gelen veriler için uygun olabilir. Bu veri depolama modelinde veriler, durum yöneticisi kullanmak yerine doğrudan depolama alanından okunur. Bu makaledeki kod örneklerinde bellek, Cosmos DB, Azure Blob ve Azure Blob transkript depolama kullanarak depolamaya veri okuma ve yazma işlemleri gösterilmektedir.

Not

Yapay zeka hizmetleri, düzenleme ve bilgi seçiminizle aracılar oluşturmak için Microsoft 365 Aracıları SDK'sını kullanmayı göz önünde bulundurun. Aracılar SDK'sı C#, JavaScript veya Python desteğine sahiptir. SDK hakkında daha fazla bilgiyi aka.ms/agents adresinde bulabilirsiniz. SaaS tabanlı bir aracı platformu arıyorsanız Microsoft Copilot Studio'yu göz önünde bulundurun. Bot Framework SDK'sı ile oluşturulmuş mevcut bir botunuz varsa botunuzu Aracılar SDK'sına güncelleştirebilirsiniz. Bot Framework SDK'sını Aracılar SDK'sına geçirme kılavuzunda temel değişiklikleri ve güncelleştirmeleri gözden geçirebilirsiniz. Bot Framework SDK'sı için destek biletleri artık 31 Aralık 2025 itibarıyla hizmet verilmeyecektir.

Önkoşullar

• Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
• Yerel olarak bot oluşturma hakkında bilgi.
• Visual Studio (C#), Node.js veya Yeoman için Bot Framework SDK v4 şablonları.

Not

Şablonları Visual Studio'dan yükleyebilirsiniz.

1. Menüde Uzantılar'ı ve ardından Uzantıları Yönet'i seçin.
2. Uzantıları Yönet iletişim kutusunda Visual Studio için Bot Framework v4 SDK şablonlarını arayın ve yükleyin.

.NET botlarını Azure'a dağıtma hakkında bilgi için bkz . Bot sağlama ve yayımlama.

Bu örnek hakkında

Bu makaledeki örnek kod, temel bir yankı botunun yapısıyla başlar, ardından ek kod ekleyerek (aşağıda sağlanır) bu botun işlevselliğini genişletir. Bu genişletilmiş kod, alınan kullanıcı girişlerini korumak için bir liste oluşturur. Her dönüşte belleğe kaydedilen kullanıcı girişlerinin tam listesi kullanıcıya geri yankılanır. Bu giriş listesini içeren veri yapısı daha sonra depolama alanına kaydedilecek şekilde değiştirilir. Bu örnek koda ek işlevler eklendikçe çeşitli depolama türleri incelenir.

Önemli

Bu makale, depolamaya iç bağlantı için yapılandırma dosyalarında bağlantı dizelerini kullanan eski kod örneklerini içerir. Microsoft, kullanılabilir en güvenli kimlik doğrulama akışını kullanmanızı önerir. Bir Azure kaynağına bağlanıyorsanız, Azure Kaynakları için Yönetilen Kimlikler önerilen kimlik doğrulama yöntemidir.

Bellek depolama

Bot Framework SDK'sı, bellek içi depolama kullanarak kullanıcı girişlerini depolamanıza olanak tanır. Bot her yeniden başlatıldığında bellek içi depolama alanı temizlendiğinden, test amacıyla en uygun seçenektir ve üretim kullanımına yönelik değildir. Veritabanı depolaması gibi kalıcı depolama türleri, üretim botları için en iyisidir.

Temel bot oluşturma

Bu konunun geri kalanı bir Echo botuyla derlenir. Echo bot örnek kodu, bot oluşturma hızlı başlangıç yönergelerini izleyerek yerel olarak oluşturulabilir.

C#

EchoBot.cs içindeki kodu aşağıdaki kodla değiştirin:

using System;
using System.Threading.Tasks;
using Microsoft.Bot.Builder;
using Microsoft.Bot.Schema;
using System.Collections.Generic;
using System.Linq;
using System.Threading;

// Represents a bot saves and echoes back user input.
public class EchoBot : ActivityHandler
{
   // Create local Memory Storage.
   private static readonly MemoryStorage _myStorage = new MemoryStorage();

   // Create cancellation token (used by Async Write operation).
   public CancellationToken cancellationToken { get; private set; }

   // Class for storing a log of utterances (text of messages) as a list.
   public class UtteranceLog : IStoreItem
   {
      // A list of things that users have said to the bot
      public List<string> UtteranceList { get; } = new List<string>();

      // The number of conversational turns that have occurred
      public int TurnNumber { get; set; } = 0;

      // Create concurrency control where this is used.
      public string ETag { get; set; } = "*";
   }

   // Echo back user input.
   protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
   {
      // preserve user input.
      var utterance = turnContext.Activity.Text;

      // Make empty local log-items list.
      UtteranceLog logItems = null;

      // See if there are previous messages saved in storage.
      try
      {
         string[] utteranceList = { "UtteranceLog" };
         logItems = _myStorage.ReadAsync<UtteranceLog>(utteranceList).Result?.FirstOrDefault().Value;
      }
      catch
      {
         // Inform the user an error occurred.
         await turnContext.SendActivityAsync("Sorry, something went wrong reading your stored messages!");
      }

      // If no stored messages were found, create and store a new entry.
      if (logItems is null)
      {
         // Add the current utterance to a new object.
         logItems = new UtteranceLog();
         logItems.UtteranceList.Add(utterance);

         // Set initial turn counter to 1.
         logItems.TurnNumber++;

         // Show user new user message.
         await turnContext.SendActivityAsync($"{logItems.TurnNumber}: The list is now: {string.Join(", ", logItems.UtteranceList)}");

         // Create dictionary object to hold received user messages.
         var changes = new Dictionary<string, object>();
         {
            changes.Add("UtteranceLog", logItems);
         }
         try
         {
            // Save the user message to your Storage.
            await _myStorage.WriteAsync(changes, cancellationToken);
         }
         catch
         {
            // Inform the user an error occurred.
            await turnContext.SendActivityAsync("Sorry, something went wrong storing your message!");
         }
      }
      // Else, our storage already contained saved user messages, add new one to the list.
      else
      {
         // add new message to list of messages to display.
         logItems.UtteranceList.Add(utterance);
         // increment turn counter.
         logItems.TurnNumber++;

         // show user new list of saved messages.
         await turnContext.SendActivityAsync($"{logItems.TurnNumber}: The list is now: {string.Join(", ", logItems.UtteranceList)}");

         // Create Dictionary object to hold new list of messages.
         var changes = new Dictionary<string, object>();
         {
            changes.Add("UtteranceLog", logItems);
         };

         try
         {
            // Save new list to your Storage.
            await _myStorage.WriteAsync(changes,cancellationToken);
         }
         catch
         {
            // Inform the user an error occurred.
            await turnContext.SendActivityAsync("Sorry, something went wrong storing your message!");
         }
      }
   }
}

JavaScript

.env yapılandırma dosyasını kullanmak için botunuzun ek bir pakete sahip olması gerekir. Henüz yüklü değilse npm'den .NET paketini alın:

npm install --save dotenv

ana iletişim kutusunu oluşturan index.js kodunu değiştirin. Ana iletişim kutusunu oluşturmak için mevcut kod satırı şudur: const myBot = new EchoBot();kullanıcının girişini botun iç belleğine depolayabileceğiniz bir depolama nesnesini EchoBot oluşturucuya geçirmeyi etkinleştirmek için güncelleştirilmesi gerekir:

İlk olarak içine bir başvuru MemoryStoragebotbuildereklemeniz gerekir:

const { MemoryStorage } = require('botbuilder');

Ardından bellek depolama nesnesini oluşturun ve oluşturucuya EchoBot geçirin:

const myStorage = new MemoryStorage();
const myBot = new EchoBot(myStorage);

Bu, bir MemoryStorage nesneyi oluşturucuya EchoBot geçirir. Bunu daha sonra Cosmos DB veya Blob Depolama nesnesi geçirmek için değiştireceksiniz.

Ardından, bot.js içindeki kodu aşağıdaki kodla değiştirin:

const { ActivityHandler, MemoryStorage } = require('botbuilder');
const restify = require('restify');

// Process incoming requests - adds storage for messages.
class EchoBot extends ActivityHandler {
    constructor(myStorage) {
        super();
        this.storage = myStorage;
        // See https://learn.microsoft.com/azure/bot-service/bot-builder-basics to learn more about the message and other activity types.
        this.onMessage(async turnContext => { console.log('this gets called (message)');
        await turnContext.sendActivity(`You said '${ turnContext.activity.text }'`);
        // Save updated utterance inputs.
        await logMessageText(this.storage, turnContext);
    });
        this.onConversationUpdate(async turnContext => { console.log('this gets called (conversation update)');
        await turnContext.sendActivity('Welcome, enter an item to save to your list.'); });
    }
}

// This function stores new user messages. Creates new utterance log if none exists.
async function logMessageText(storage, turnContext) {
    let utterance = turnContext.activity.text;
    // debugger;
    try {
        // Read from the storage.
        let storeItems = await storage.read(["UtteranceLogJS"])
        // Check the result.
        var UtteranceLogJS = storeItems["UtteranceLogJS"];
        if (typeof (UtteranceLogJS) != 'undefined') {
            // The log exists so we can write to it.
            storeItems["UtteranceLogJS"].turnNumber++;
            storeItems["UtteranceLogJS"].UtteranceList.push(utterance);
            // Gather info for user message.
            var storedString = storeItems.UtteranceLogJS.UtteranceList.toString();
            var numStored = storeItems.UtteranceLogJS.turnNumber;

            try {
                await storage.write(storeItems)
                await turnContext.sendActivity(`${numStored}: The list is now: ${storedString}`);
            } catch (err) {
                await turnContext.sendActivity(`Write failed of UtteranceLogJS: ${err}`);
            }
        }
        else{
            await turnContext.sendActivity(`Creating and saving new utterance log`);
            var turnNumber = 1;
            storeItems["UtteranceLogJS"] = { UtteranceList: [`${utterance}`], "eTag": "*", turnNumber }
            // Gather info for user message.
            var storedString = storeItems.UtteranceLogJS.UtteranceList.toString();
            var numStored = storeItems.UtteranceLogJS.turnNumber;

            try {
                await storage.write(storeItems)
                await turnContext.sendActivity(`${numStored}: The list is now: ${storedString}`);
            } catch (err) {
                await turnContext.sendActivity(`Write failed: ${err}`);
            }
        }
    }
    catch (err){
        await turnContext.sendActivity(`Read rejected. ${err}`);
    }
}

module.exports.EchoBot = EchoBot;

Piton

echo_bot.py içindeki kodu aşağıdaki kodla değiştirin:

from botbuilder.core import ActivityHandler, TurnContext, StoreItem, MemoryStorage


class UtteranceLog(StoreItem):
    """
    Class for storing a log of utterances (text of messages) as a list.
    """

    def __init__(self):
        super(UtteranceLog, self).__init__()
        self.utterance_list = []
        self.turn_number = 0
        self.e_tag = "*"


class EchoBot(ActivityHandler):
    """
    Represents a bot saves and echoes back user input.
    """

    def __init__(self):
        self.storage = MemoryStorage()

    async def on_message_activity(self, turn_context: TurnContext):
        utterance = turn_context.activity.text

        # read the state object
        store_items = await self.storage.read(["UtteranceLog"])

        if "UtteranceLog" not in store_items:
            # add the utterance to a new state object.
            utterance_log = UtteranceLog()
            utterance_log.utterance_list.append(utterance)
            utterance_log.turn_number = 1
        else:
            # add new message to list of messages existing state object.
            utterance_log: UtteranceLog = store_items["UtteranceLog"]
            utterance_log.utterance_list.append(utterance)
            utterance_log.turn_number = utterance_log.turn_number + 1

        # Show user list of utterances.
        await turn_context.send_activity(f"{utterance_log.turn_number}: "
                                         f"The list is now: {','.join(utterance_log.utterance_list)}")

        try:
            # Save the user message to your Storage.
            changes = {"UtteranceLog": utterance_log}
            await self.storage.write(changes)
        except Exception as exception:
            # Inform the user an error occurred.
            await turn_context.send_activity("Sorry, something went wrong storing your message!")

Botunuzu başlatma

Botunuzu yerel olarak çalıştırın.

Öykünücüyü başlatın ve botunuzu bağlayın

Bot Framework Emulator'ı yükleyin, Öykünücüyü başlatın ve ardından Öykünücü'de botunuza bağlanın:

1. Öykünücüye Hoş Geldiniz sekmesinde Yeni bot yapılandırması oluştur bağlantısını seçin.
2. Botunuzu başlattığınızda görüntülenen web sayfasındaki bilgiler göz önünde bulundurularak botunuza bağlanmak için alanları doldurun.

Botunuzla etkileşim kurma

Botunuza bir ileti gönderin. Bot aldığı iletileri listeler.

Bu makalenin geri kalanında botun iç belleği yerine kalıcı depolamaya nasıl kaydedileceği gösterilir.

Cosmos DB kullanma

Önemli

Cosmos DB depolama sınıfı kullanım dışı bırakıldı. Başlangıçta CosmosDbStorage ile oluşturulan kapsayıcıların bölüm anahtarı kümesi yoktu ve _/partitionKey varsayılan bölüm anahtarı verildi.

Cosmos DB depolama alanıyla oluşturulan kapsayıcılar Cosmos DB bölümlenmiş depolama alanı ile kullanılabilir. Daha fazla bilgi için Azure Cosmos DB'de Bölümleme bölümünü okuyun.

Ayrıca, eski Cosmos DB depolama alanının aksine, Cosmos DB bölümlenmiş depolamanın Cosmos DB hesabınızda otomatik olarak bir veritabanı oluşturmadığını unutmayın. El ile yeni bir veritabanı oluşturmanız gerekir, ancak CosmosDbPartitionedStorage kapsayıcıyı sizin için oluşturacağı için el ile kapsayıcı oluşturmayı atlayın.

Bellek depolamayı kullandığınıza göre kodu Azure Cosmos DB kullanacak şekilde güncelleştireceğiz. Cosmos DB, Microsoft'un genel olarak dağıtılmış, çok modelli veritabanıdır. Azure Cosmos DB, herhangi bir sayıda Azure coğrafi bölgesinde aktarım hızını ve depolamayı esnek ve bağımsız olarak ölçeklendirmenizi sağlar. Kapsamlı hizmet düzeyi sözleşmeleri (SLA) ile aktarım hızı, gecikme süresi, kullanılabilirlik ve tutarlılık garantileri sunar.

Cosmos DB kaynağı ayarlama

Botunuzda Cosmos DB kullanmak için koda girmeden önce bir veritabanı kaynağı oluşturmanız gerekir. Cosmos DB veritabanı ve uygulama oluşturma hakkında ayrıntılı bir açıklama için .NET, Node.js veya Python hızlı başlangıcına bakın.

Veritabanı hesabınızı oluşturma

1. Azure Cosmos DB hesabı oluşturmak için Azure portalına gidin. Azure Cosmos DB için arama yapın ve bunu seçin.

2. Azure Cosmos DB sayfasında Yeni'yi seçerek Azure Cosmos DB Hesabı Oluştur sayfasını açın.

   

3. Aşağıdaki alanlar için değerler sağlayın:

   1. Abonelik. Bu Azure Cosmos hesabı için kullanmak istediğiniz Azure aboneliğini seçin.
   2. Kaynak grubu. Mevcut bir kaynak grubunu seçin veya Yeni oluştur'u seçin ve yeni bir kaynak grubu için bir ad girin.
   3. Hesap adı. Azure Cosmos hesabınızı tanımlayan bir ad girin. URI’nizi oluşturmak için sağladığınız ada documents.azure.com ekleneceği için benzersiz bir ad kullanın. Aşağıdaki yönergelere dikkat edin:
      • Adın Azure genelinde benzersiz olması gerekir.
      • Ad 3 ile 31 karakter uzunluğunda olmalıdır.
      • Ad yalnızca küçük harf, sayı ve kısa çizgi (-) karakterini içerebilir.
   4. API. Çekirdek(SQL) öğesini seçin
   5. Konum. kullanıcılara verilere en hızlı erişimi vermek için kullanıcılarınıza en yakın konumu seçin.

4. Gözden geçir + Oluştur’u seçin.

5. Doğrulandıktan sonra Oluştur'u seçin.

Hesabın oluşturulması birkaç dakika sürer. Portalın Tebrikler! Azure Cosmos DB hesabınız oluşturuldu sayfası.

Veritabanı ekleyin

Not

Kapsayıcıyı kendiniz oluşturmayın. Botunuz, iç Cosmos DB istemcisini oluştururken bot durumunu depolamak için doğru yapılandırıldığından emin olarak bunu sizin için oluşturur.

1. Yeni oluşturduğunuz Cosmos DB hesabınızın Veri Gezgini sayfasına gidin, ardından Yeni Kapsayıcı açılan listesinden Yeni Veritabanı'nıseçin. Ardından pencerenin sağ tarafında yeni veritabanının ayrıntılarını girebileceğiniz bir panel açılır.

   

2. Yeni veritabanınız için bir kimlik girin ve isteğe bağlı olarak aktarım hızını ayarlayın (bunu daha sonra değiştirebilirsiniz) ve son olarak veritabanınızı oluşturmak için Tamam'ı seçin. Bu veritabanı kimliğini daha sonra botunuzu yapılandırırken kullanmak üzere not edin.

3. Artık bir Cosmos DB hesabı ve veritabanı oluşturduğunuza göre, yeni veritabanınızı botunuzla tümleştirmeye yönelik bazı değerlerin üzerine kopyalamanız gerekir. Bunları almak için Cosmos DB hesabınızın veritabanı ayarları bölümünde Anahtarlar sekmesine gidin. Bu sayfada URI'nize (Cosmos DB uç noktası) ve BİRİnCİl ANAHTAR (yetkilendirme anahtarı) gerekir.

Artık bir veritabanı ve bot ayarlarınızda kullanıma hazır aşağıdaki değerlere sahip bir Cosmos DB hesabınız olmalıdır.

• URI (Evrensel Kaynak Tanımlayıcısı)
• Birincil Anahtar
• Veritabanı Kimliği

Cosmos DB yapılandırma bilgilerini ekleme

Uç noktanızı, yetkilendirme anahtarınızı ve veritabanı kimliğinizi ayarlamak için bu makalenin önceki bölümünde not ettiğiniz ayrıntıları kullanın. Son olarak, bot durumunuzu depolamak için veritabanınızda oluşturulacak kapsayıcı için uygun bir ad seçmelisiniz. Aşağıdaki örnekte, oluşturulan Cosmos DB kapsayıcısı "bot-storage" olarak adlandırılacaktır.

C#

Yapılandırma dosyanıza aşağıdaki bilgileri ekleyin.

appsettings.json

"CosmosDbEndpoint": "<your-CosmosDb-URI>",
"CosmosDbAuthKey": "<your-primary-key>",
"CosmosDbDatabaseId": "<your-database-id>",
"CosmosDbContainerId": "bot-storage"

JavaScript

.env dosyanıza aşağıdaki bilgileri ekleyin.

.Env

CosmosDbEndpoint="<your-CosmosDb-URI>"
CosmosDbAuthKey="<your-primary-key>"
CosmosDbDatabaseId="<your-database-id>"
CosmosDbContainerId="bot-storage"

Piton

Yapılandırma dosyanıza aşağıdaki bilgileri ekleyin.

config.py

COSMOS_DB_URI="<your-CosmosDb-URI>"
COSMOS_DB_PRIMARY_KEY="your-primary-key"
COSMOS_DB_DATABASE_ID="<your-database-id>"
COSMOS_DB_CONTAINER_ID="bot-storage"

Cosmos DB paketlerini yükleme

Cosmos DB için gerekli paketleri kullandığınızdan emin olun.

C#

Microsoft.Bot.Builder.Azure NuGet paketini yükleyin. NuGet kullanma hakkında daha fazla bilgi için bkz. NuGet Paket Yöneticisi kullanarak Visual Studio'da paketleri yükleme ve yönetme.

JavaScript

npm kullanarak botbuilder-azure başvurusu ekleyin.

npm install --save botbuilder-azure

Henüz yüklü değilse, .env dosya ayarlarınıza erişmek için npm'den .NET paketini alın.

npm install --save dotenv

Piton

Projenizde pip aracılığıyla botbuilder-azure başvurusu ekleyebilirsiniz.

pip install botbuilder-azure

Cosmos DB uygulaması

Not

Sürüm 4.6 yeni bir Cosmos DB depolama sağlayıcısı, Cosmos DB bölümlenmiş depolama sınıfını kullanıma sunar ve özgün Cosmos DB depolama sınıfı kullanım dışıdır. Cosmos DB depolama alanıyla oluşturulan kapsayıcılar Cosmos DB bölümlenmiş depolama alanı ile kullanılabilir. Daha fazla bilgi için Azure Cosmos DB'de Bölümleme bölümünü okuyun.

Eski Cosmos DB depolama alanının aksine, Cosmos DB bölümlenmiş depolama alanı Cosmos DB hesabınızda otomatik olarak bir veritabanı oluşturmaz. El ile yeni bir veritabanı oluşturmanız gerekir, ancak CosmosDbPartitionedStorage kapsayıcıyı sizin için oluşturacağı için el ile kapsayıcı oluşturmayı atlayın.

C#

Aşağıdaki örnek kod, yukarıda belirtilen bellek depolama örneğiyle aynı bot kodu kullanılarak ve burada listelenen özel durumlar kullanılarak çalıştırılır. Aşağıdaki kod parçacıklarında yerel Bellek depolama alanının yerini alan 'myStorage' için Cosmos DB depolama uygulaması gösterilmektedir.

İlk olarak bot oluşturucusu Azure kitaplığına başvurmak için Startup.cs güncelleştirmeniz gerekir:

using Microsoft.Bot.Builder.Azure;

Ardından, ConfigureServices Startup.cs'daki yönteminde CosmosDbPartitionedStorage nesnesini oluşturun. Bu, bağımlılık ekleme yoluyla oluşturucuya EchoBot geçirilir.

// Use partitioned CosmosDB for storage, instead of in-memory storage.
services.AddSingleton<IStorage>(
    new CosmosDbPartitionedStorage(
        new CosmosDbPartitionedStorageOptions
        {
            CosmosDbEndpoint = Configuration.GetValue<string>("CosmosDbEndpoint"),
            AuthKey = Configuration.GetValue<string>("CosmosDbAuthKey"),
            DatabaseId = Configuration.GetValue<string>("CosmosDbDatabaseId"),
            ContainerId = Configuration.GetValue<string>("CosmosDbContainerId"),
            CompatibilityMode = false,
        }));

EchoBot.cs değişken bildirimini _myStorageprivate static readonly MemoryStorage _myStorage = new MemoryStorage(); aşağıdaki şekilde değiştirin:

// variable used to save user input to CosmosDb Storage.
private readonly IStorage _myStorage;

Ardından nesnesini oluşturucuya IStorage geçirinEchoBot:

public EchoBot(IStorage storage)
{
    if (storage is null) throw new ArgumentNullException();
    _myStorage = storage;
}

JavaScript

İlk olarak, daha önce girdiğiniz .env dosyanızdaki değerlere erişmenizi sağlamak için index.js dosyanıza kod ekleyin:

// initialized to access values in .env file.
const ENV_FILE = path.join(__dirname, '.env');
require('dotenv').config({ path: ENV_FILE });

Daha sonra Bot Frameworks iç depolama alanı yerine Cosmos DB bölümlenmiş depolamayı kullanmak için index.js değişiklikler yapmanız gerekir. Bu bölümdeki tüm kod değişiklikleri index.js yapılır.

İlk olarak, index.js botbuilder-azure'abir başvuru ekleyin. Bu, sınıfına erişmenizi sağlayacaktır CosmosDbPartitionedStorage .

const { CosmosDbPartitionedStorage } = require('botbuilder-azure');

Ardından yeni CosmosDbPartitionedStorage bir nesne oluşturun.

const myStorage = new CosmosDbPartitionedStorage({
    cosmosDbEndpoint: process.env.CosmosDbEndpoint,
    authKey: process.env.CosmosDbAuthKey,
    databaseId: process.env.CosmosDbDatabaseId,
    containerId: process.env.CosmosDbContainerId,
    compatibilityMode: false
});

Artık Bot Frameworks iç depolama alanına myStorage değil Cosmos DB'ye kullanıcı girişi kaydetmediğiniz için daha önce eklediğiniz const bildirimini açıklama satırı yapabilir veya kaldırabilirsiniz:

//const myStorage = new MemoryStorage();
const myBot = new EchoBot(myStorage);

Piton

Aşağıdaki örnek kod, yukarıda belirtilen bellek depolama örneğiyle aynı bot kodu kullanılarak ve burada listelenen özel durumlar kullanılarak çalıştırılır.

CosmosDbPartitionedStorage CosmosDBStorage nesnesini oluşturmak için hem hem de CosmosDbPartitionedConfig öğesi botbuilder-azure gereklidir.

echo_bot.py

from botbuilder.azure import CosmosDbPartitionedStorage, CosmosDbPartitionedConfig

config.py ayarlarına

from config import DefaultConfig
CONFIG = DefaultConfig()

içindeki Bellek Depolama'yı __init__ açıklama satırı yapıp yerine Cosmos DB'ye başvuru yazın. Yukarıda kullanılan URI (uç nokta), Birincil anahtar (yetkilendirme anahtarı), veritabanı kimliği ve kapsayıcı kimliğini kullanın.

Ardından içindeki Bellek Depolama kodunu __init__ kaldırın veya açıklama satırı oluşturun ve config.py Cosmos DB bilgilerinize bir başvuru ekleyin.

Aşağıdaki kod parçacığında yerel Bellek depolama alanının yerini alan 'Depolama' için Cosmos DB uygulaması gösterilmektedir.

echo_bot.py

def __init__(self):
    cosmos_config = CosmosDbPartitionedConfig(
        cosmos_db_endpoint=CONFIG.COSMOS_DB_URI,
        auth_key=CONFIG.COSMOS_DB_PRIMARY_KEY,
        database_id=CONFIG.COSMOS_DB_DATABASE_ID,
        container_id=CONFIG.COSMOS_DB_CONTAINER_ID,
        compatibility_mode = False
    )
    self.storage = CosmosDbPartitionedStorage(cosmos_config)

Cosmos DB botunuzu başlatma

Botunuzu yerel olarak çalıştırın.

Bot Framework Öykünücüsü ile Cosmos DB botunuzu test edin

Şimdi Bot Framework Emulator'ı başlatın ve botunuza bağlanın:

1. Öykünücüye Hoş Geldiniz sekmesinde yeni bot yapılandırması oluştur bağlantısını seçin.
2. Botunuzu başlattığınızda görüntülenen web sayfasındaki bilgiler göz önünde bulundurularak botunuza bağlanmak için alanları doldurun.

Cosmos DB botunuzla etkileşim kurma

Botunuza bir ileti gönderdiğinizde bot aldığı iletileri listeler.

Cosmos DB verilerinizi görüntüleme

Botunuzu çalıştırdıktan ve bilgilerinizi kaydettikten sonra Azure portalında depolanan verileri Veri Gezgini sekmesinin altında görüntüleyebilirsiniz.

Blob depolamayı kullanma

Azure Blob depolama, Microsoft’un buluta yönelik nesne depolama çözümüdür. Blob depolama, metin veya ikili veri gibi çok miktarda yapılandırılmamış veriyi depolamak için iyileştirilmiştir. Bu bölümde Azure blob depolama hesabı ve kapsayıcısı oluşturma ve ardından botunuzdan blob depolama kapsayıcınıza başvurma açıklanmaktadır.

Blob Depolama hakkında daha fazla bilgi için bkz. Azure Blob depolama nedir?

Blob depolama hesabınızı oluşturma

Botunuzda Blob depolamayı kullanmak için koda girmeden önce birkaç ayarlama yapmanız gerekir.

1. Azure portaldaTüm hizmetler’i seçin.

2. Tüm hizmetler sayfasının Öne Çıkanlar bölümünde Depolama hesapları'nı seçin.

3. Depolama hesapları sayfasında Yeni'yi seçin.

   

4. Abonelik alanında, depolama hesabının oluşturulacağı aboneliği seçin.

5. Kaynak grubu alanında var olan bir kaynak grubunu seçin veya Yeni oluştur'u seçin ve yeni kaynak grubu için bir ad girin.

6. Depolama hesabı adı alanına hesap için bir ad girin. Aşağıdaki yönergelere dikkat edin:

   • Adın Azure genelinde benzersiz olması gerekir.
   • Ad 3 ila 24 karakter uzunluğunda olmalıdır.
   • Ad yalnızca sayıları ve küçük harfleri içerebilir.

7. Konum alanında depolama hesabı için bir konum seçin veya varsayılan konumu kullanın.

8. Diğer ayarlar için aşağıdakileri yapılandırın:

   • Performans: Standart. Performans hakkında daha fazla bilgi edinin.
   • Hesap türü: BlobStorage. Depolama hesapları hakkında daha fazla bilgi edinin.
   • Çoğaltma: Varsayılan ayarı değiştirmeyin. Yedeklilik hakkında daha fazla bilgi edinin.

9. Depolama hesabı oluştur sayfasının Proje ayrıntıları bölümünde abonelik ve Kaynak grubu için istenen değerleri seçin.

10. Depolama hesabı oluştur sayfasının Örnek ayrıntıları bölümünde Depolama hesabı adını girin, ardından Konum, Hesap türü ve Çoğaltma değerlerini seçin.

11. Depolama hesabı ayarlarını gözden geçirmek için Gözden Geçir + oluştur'u seçin.

12. Doğrulandıktan sonra Oluştur'u seçin.

Blob depolama kapsayıcısı oluşturma

Blob depolama hesabınız oluşturulduktan sonra açın ve ardından:

1. Depolama Gezgini (Önizleme) öğesini seçin.

2. Ardından BLOB KAPSAYICILAR'a sağ tıklayın

3. Açılan listeden Blob kapsayıcısı oluştur'u seçin.

   

4. Yeni kapsayıcı formuna bir ad girin. Blob depolama hesabınıza erişim sağlamak için "blob kapsayıcınızın adı" değeri için bu adı kullanacaksınız. Aşağıdaki yönergelere dikkat edin:

   • Bu ad yalnızca küçük harf, sayı ve kısa çizgi içerebilir.
   • Bu ad bir harf veya sayı ile başlamalıdır.
   • Her kısa çizginin önüne ve ardından geçerli bir kısa çizgi olmayan karakter gelmelidir.
   • Ad 3 ile 63 karakter uzunluğunda olmalıdır.

Blob depolama yapılandırma bilgileri ekleme

Yukarıda gösterildiği gibi botunuz için Blob depolamayı yapılandırmak için ihtiyacınız olan Blob depolama anahtarlarını bulun:

1. Azure portalında Blob depolama hesabınızı açın ve Ayarlar bölümünde Erişim anahtarları'nıseçin.
2. Botunuzu Blob depolama hesabınıza erişecek şekilde yapılandırmak için blob bağlantı dizesi değeri olarak Bağlantı dizesini kullanın.

C#

Yapılandırma dosyanıza aşağıdaki bilgileri ekleyin.

appsettings.json

"BlobConnectionString": "<your-blob-connection-string>",
"BlobContainerName": "<your-blob-container-name>",

JavaScript

.env dosyanıza aşağıdaki bilgileri ekleyin.

.Env

BlobConnectionString="<your-blob-connection-string>"
BlobContainerName="<your-blob-container-name>"

Piton

Yapılandırma dosyanıza aşağıdaki bilgileri ekleyin. Blob depolama kapsayıcınızı oluştururken kullanılan aynı kapsayıcı adını ve bağlantı dizesi kullanın.

config.py

BLOB_CONNECTION_STRING="<your-blob-connection-string>"
BLOB_CONTAINER_NAME="<your-blob-container-name>"

Blob depolama paketlerini yükleme

Daha önce yüklenmemişse aşağıdaki paketleri yükleyin.

C#

Microsoft.Bot.Builder.Azure.Blobs NuGet paketini yükleyin. NuGet kullanma hakkında daha fazla bilgi için bkz. NuGet Paket Yöneticisi kullanarak Visual Studio'da paketleri yükleme ve yönetme.

JavaScript

npm aracılığıyla projenizde öğesine botbuilder-azure-blobs başvuru ekleyin.

Not

Bu npm paketi, geliştirme makinenizde mevcut olan bir Python yüklemesine dayanır. Python'ı daha önce yüklemediyseniz makinenizin yükleme kaynaklarını Python.org

npm install --save botbuilder-azure-blobs

Henüz yüklü değilse, .env dosya ayarlarınıza erişmek için npm'den .NET paketini alın.

npm install --save dotenv

Piton

projenizde pip aracılığıyla botbuilder-azure başvurusu ekleyebilirsiniz.

pip install botbuilder-azure

Blob depolama uygulaması

Blob depolama , bot durumunu depolamak için kullanılır.

C#

Not

Sürüm 4.10 itibariyle Microsoft.Bot.Builder.Azure.AzureBlobStorage kullanım dışıdır. Yeniyi Microsoft.Bot.Builder.Azure.Blobs.BlobsStorage yerine kullanın.

Aşağıdaki örnek kod, yukarıda belirtilen bellek depolama örneğiyle aynı bot kodu kullanılarak ve burada listelenen özel durumlar kullanılarak çalıştırılır.

Aşağıdaki kod parçacıklarında yerel Bellek depolamanın yerini alan 'myStorage' için Blob depolama uygulaması gösterilmektedir.

İlk olarak bot oluşturucusu Azure blobları kitaplığına başvurmak için Startup.cs güncelleştirmeniz gerekir:

Startup.cs

using Microsoft.Bot.Builder.Azure.Blobs;

Ardından, ConfigureServices Startup.cs'dakinesnesini oluşturun ve içindeki değerleri BlobsStoragegeçirin. Bu, bağımlılık ekleme yoluyla oluşturucuya EchoBot geçirilir.

//Use Azure Blob storage, instead of in-memory storage.
services.AddSingleton<IStorage>(
    new BlobsStorage(
        Configuration.GetValue<string>("BlobConnectionString"),
        Configuration.GetValue<string>("BlobContainerName")
        ));

Şimdi ilk olarak bot oluşturucusu Azure blob kitaplığına başvurmak için EchoBot.cs güncelleştirmeniz gerekir:

EchoBot.cs

using Microsoft.Bot.Builder.Azure.Blobs;

Ardından, 'private static readonly MemoryStorage _myStorage = new MemoryStorage();' MemoryStorage değişkenini oluşturan kod satırını kaldırın veya açıklama satırı oluşturun ve kullanıcı girişini Blob Depolama'ya kaydetmek için kullanılacak yeni bir değişken oluşturun.

EchoBot.cs

// variable used to save user input to CosmosDb Storage.
private readonly IStorage _myStorage;

Ardından nesnesini oluşturucuya IStorage geçirinEchoBot:

public EchoBot(IStorage storage)
{
    if (storage is null) throw new ArgumentNullException();
    _myStorage = storage;
}

Depolama alanınız Blob Depolama hesabınıza işaret edecek şekilde ayarlandıktan sonra bot kodunuz blob depolamadan veri depolayıp alır.

JavaScript

Bu bölümdeki tüm kod değişiklikleri index.js yapılır.

İlk olarak, daha önce girdiğiniz .env dosyanızdaki değerlere erişmenizi sağlayacak kod ekleyin:

// initialized to access values in .env file.
const ENV_FILE = path.join(__dirname, '.env');
require('dotenv').config({ path: ENV_FILE });

Ardından, Bot Frameworks iç depolama alanı yerine Blob depolamayı kullanarak değişiklikler yapmanız gerekir.

Ardından öğesine bir başvuru botbuilder-azure-blobsekleyin. Bu, Blob Depolama API'sine erişmenizi sağlar:

const { BlobsStorage } = require("botbuilder-azure-blobs");

Kodunuzu sınıfını BlobsStorage kullanacak şekilde değiştirmek için bildiriminizi myStorage aşağıdaki gibi değiştirin:

const myStorage = new BlobsStorage(
    process.env.BlobConnectionString,
    process.env.BlobContainerName
);

Depolama alanınız Blob Depolama hesabınıza işaret edecek şekilde ayarlandıktan sonra bot kodunuz blob depolamadan veri depolayıp alır.

Piton

Aşağıdaki örnek kod, yukarıda belirtilen bellek depolama örneğiyle aynı bot kodu kullanılarak ve burada listelenen özel durumlar kullanılarak çalıştırılır.

Bunun için BlobStorage ve BlobStorageSettings gerekir botbuilder-azure.

echo_bot.py

from botbuilder.azure import BlobStorage, BlobStorageSettings

config.py ayarlarına

from config import DefaultConfig
CONFIG = DefaultConfig()

Ardından içindeki Bellek Depolama kodunu __init__ kaldırın veya açıklama satırı oluşturun ve config.py blob depolama bilgilerinize bir başvuru ekleyin.

Aşağıdaki kod parçacığında yerel Bellek depolama alanının yerini alan bir Blob Depolama uygulaması gösterilmektedir.

echo_bot.py

def __init__(self):
    blob_settings = BlobStorageSettings(
        connection_string=CONFIG.BLOB_CONNECTION_STRING,
        container_name=CONFIG.BLOB_CONTAINER_NAME
    )
    self.storage = BlobStorage(blob_settings)

Depolama alanınız Blob Depolama hesabınıza işaret edecek şekilde ayarlandıktan sonra bot kodunuz blob depolamadan veri depolayıp alır.

Blob depolama botunuzu başlatma

Botunuzu yerel olarak çalıştırın.

Öykünücüyü başlatma ve Blob depolama botunuzu bağlama

Ardından Öykünücü'yü başlatın ve ardından Öykünücü'de botunuza bağlanın:

1. Öykünücü "Hoş Geldiniz" sekmesinde Yeni bot yapılandırması oluştur bağlantısını seçin.
2. Botunuzu başlattığınızda görüntülenen web sayfasındaki bilgiler göz önünde bulundurularak botunuza bağlanmak için alanları doldurun.

Blob depolama botunuzla etkileşim kurma

Botunuza bir ileti gönderdiğinizde bot aldığı iletileri listeler.

Blob depolama verilerinizi görüntüleme

Botunuzu çalıştırdıktan ve bilgilerinizi kaydettikten sonra Azure portalındaki Depolama Gezgini sekmesinin altında görüntüleyebilirsiniz.

Blob transkript depolama

Azure blob transkript depolama, kayıtlı transkript biçiminde kullanıcı konuşmalarını kolayca kaydetmenize ve almanıza olanak tanıyan özel bir depolama seçeneği sağlar. Azure blob transkript depolaması, botunuzun performansında hata ayıklarken incelenmesi gereken kullanıcı girişlerini otomatik olarak yakalamak için kullanışlıdır.

Not

Python şu anda Azure Blob transkript depolamayı desteklemez. JavaScript Blob transkript depolamayı desteklese de, aşağıdaki yönergeler yalnızca C# için geçerlidir.

Blob transkript depolama kapsayıcısı ayarlama

Azure blob transkript depolaması, yukarıdaki "Blob depolama hesabınızı oluşturma" ve "Yapılandırma bilgileri ekleme" bölümlerinde ayrıntılı olarak belirtilen adımları izleyerek oluşturulan blob depolama hesabını kullanabilir. Şimdi transkriptlerimizi tutmak için bir kapsayıcı ekliyoruz

1. Azure blob depolama hesabınızı açın.
2. Depolama Gezgini'ı seçin.
3. BLOB KAPSAYICILARI'ne sağ tıklayın ve Blob kapsayıcısı oluştur'u seçin.
4. Transkript kapsayıcınız için bir ad girin ve Tamam'ı seçin. (mybottranscripts'e girdik)

Blob transkript depolama uygulaması

Aşağıdaki kod, transkript depolama işaretçisini _myTranscripts yeni Azure blob transkript depolama hesabınıza bağlar. Bu bağlantıyı yeni bir kapsayıcı adı <olan your-blob-transcript-container-name> ile oluşturmak için Blob depolamada transkript dosyalarınızı tutacak yeni bir kapsayıcı oluşturur.

Blob transkript depolama , bot transkriptlerini depolamak için tasarlanmıştır.

Not

Sürüm 4.10 itibariyle Microsoft.Bot.Builder.Azure.AzureBlobTranscriptStore kullanım dışıdır. Yeniyi Microsoft.Bot.Builder.Azure.Blobs.BlobsTranscriptStore yerine kullanın.

echoBot.cs

using Microsoft.Bot.Builder.Azure.Blobs;

public class EchoBot : ActivityHandler
{
   ...

   private readonly BlobsTranscriptStore _myTranscripts = new BlobsTranscriptStore("<your-azure-storage-connection-string>", "<your-blob-transcript-container-name>");

   ...
}

Kullanıcı konuşmalarını Azure blob transkriptlerinde depolama

Dökümleri depolamak için bir blob kapsayıcısı kullanılabilir olduktan sonra, kullanıcılarınızın botunuzla konuşmalarını korumaya başlayabilirsiniz. Bu konuşmalar daha sonra kullanıcıların botunuzla nasıl etkileşime geçtiğini görmek için bir hata ayıklama aracı olarak kullanılabilir. Her Öykünücü Yeniden Başlatma konuşması , yeni bir transkript konuşma listesi oluşturmayı başlatır. Aşağıdaki kod, depolanan transkript dosyası içindeki kullanıcı konuşma girişlerini korur.

• Geçerli transkript kullanılarak LogActivityAsynckaydedilir.
• Kaydedilen transkriptler kullanılarak ListTranscriptsAsyncalınır. Bu örnek kodda, depolanan her transkriptin kimliği "storedTranscripts" adlı bir listeye kaydedilir. Bu liste daha sonra sakladığımız depolanan blob transkriptlerinin sayısını yönetmek için kullanılır.

echoBot.cs

protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    await _myTranscripts.LogActivityAsync(turnContext.Activity);

    List<string> storedTranscripts = new List<string>();
    PagedResult<Microsoft.Bot.Builder.TranscriptInfo> pagedResult = null;
    var pageSize = 0;
    do
    {
       pagedResult = await _myTranscripts.ListTranscriptsAsync("emulator", pagedResult?.ContinuationToken);
       pageSize = pagedResult.Items.Count();

       // transcript item contains ChannelId, Created, Id.
       // save the channelIds found by "ListTranscriptsAsync" to a local list.
       foreach (var item in pagedResult.Items)
       {
          storedTranscripts.Add(item.Id);
       }
    } while (pagedResult.ContinuationToken != null);

    ...
}

Depolanan blob transkriptlerini yönetme

Depolanan transkriptler hata ayıklama aracı olarak kullanılabilse de, zaman içinde depolanan transkriptlerin sayısı korumayı önemsediğinizden daha fazla artabilir. Aşağıda yer alan ek kod, blob transkript deponuzdan alınan son üç transkript öğesi dışında tüm öğeleri kaldırmak için kullanılır DeleteTranscriptAsync .

echoBot.cs

protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
{
    await _myTranscripts.LogActivityAsync(turnContext.Activity);

    List<string> storedTranscripts = new List<string>();
    PagedResult<Microsoft.Bot.Builder.TranscriptInfo> pagedResult = null;
    var pageSize = 0;
    do
    {
       pagedResult = await _myTranscripts.ListTranscriptsAsync("emulator", pagedResult?.ContinuationToken);
       pageSize = pagedResult.Items.Count();

       // transcript item contains ChannelId, Created, Id.
       // save the channelIds found by "ListTranscriptsAsync" to a local list.
       foreach (var item in pagedResult.Items)
       {
          storedTranscripts.Add(item.Id);
       }
    } while (pagedResult.ContinuationToken != null);

    // Manage the size of your transcript storage.
    for (int i = 0; i < pageSize; i++)
    {
       // Remove older stored transcripts, save just the last three.
       if (i < pageSize - 3)
       {
          string thisTranscriptId = storedTranscripts[i];
          try
          {
             await _myTranscripts.DeleteTranscriptAsync("emulator", thisTranscriptId);
           }
           catch (System.Exception ex)
           {
              await turnContext.SendActivityAsync("Debug Out: DeleteTranscriptAsync had a problem!");
              await turnContext.SendActivityAsync("exception: " + ex.Message);
           }
       }
    }
    ...
}

Sınıfı hakkında daha fazla bilgi için bkz . Azure Blob Transkript Depolama.

Ek Bilgi

eTag'leri kullanarak eşzamanlılığı yönetme

Bot kodu örneğimizde her eTag birinin özelliğini olarak IStoreItemayarlayacağız*. eTag Depo nesnenizin (varlık etiketi) üyesi, eşzamanlılığı yönetmek için Cosmos DB içinde kullanılır. , eTag botunuzun başka bir örneği botunuzun yazdığı depolama alanındaki nesneyi değiştirdiyse veritabanınıza ne yapacağını bildirir.

Son yazma kazançları - üzerine yazmalara izin ver

Yıldız eTag işareti (*) özellik değeri, son yazarın kazandığını gösterir. Yeni bir veri deposu oluştururken, daha önce yazdığınız verileri kaydetmemiş olduğunuzu veya son yazarın daha önce kaydedilmiş herhangi bir özelliğin üzerine yazmasını istediğinizi belirtmek için bir özellik eTag ayarlayabilirsiniz*. Eşzamanlılık botunuz için sorun değilse, yazmakta eTag olduğunuz tüm veriler için özelliğini * olarak ayarlamak üzerine yazmayı etkinleştirir.

Eşzamanlılığı koruma ve üzerine yazmaları önleme

Verilerinizi Cosmos DB'de depolarken, bir özelliğe eşzamanlı erişimi engellemek ve botun * başka bir örneğindeki değişikliklerin üzerine yazılmasını önlemek istiyorsanız dışında bir değer eTag kullanın. Bot, durum verilerini kaydetmeye çalıştığında iletiyle etag conflict key= birlikte bir hata yanıtı alır ve eTag değeri depolamadakiyle eTag aynı değildir.

Varsayılan olarak, Cosmos DB deposu bir bot bu öğeye her yazdığında bir depolama nesnesinin özelliğini eşitlik açısından denetler eTag ve her yazmadan sonra bunu yeni bir benzersiz değerle güncelleştirir. Yazma özelliğinin eTag depolama alanındakiyle eşleşmemesi eTag , başka bir bot veya iş parçacığının verileri değiştirdiği anlamına gelir.

Örneğin, botunuzun kaydedilmiş bir notu düzenlemesini istediğinizi ancak botunuzun başka bir bot örneğinin yaptığı değişikliklerin üzerine yazmasını istediğinizi varsayalım. Botun başka bir örneği düzenlemeler yaptıysa, kullanıcının sürümü en son güncelleştirmelerle düzenlemesini istersiniz.

C#

İlk olarak, uygulayan IStoreItembir sınıf oluşturun.

EchoBot.cs

public class Note : IStoreItem
{
    public string Name { get; set; }
    public string Contents { get; set; }
    public string ETag { get; set; }
}

Ardından, bir depolama nesnesi oluşturarak bir ilk not oluşturun ve nesneyi deponuza ekleyin.

EchoBot.cs

// create a note for the first time, with a non-null, non-* ETag.
var note = new Note { Name = "Shopping List", Contents = "eggs", ETag = "x" };

var changes = Dictionary<string, object>();
{
    changes.Add("Note", note);
};
await NoteStore.WriteAsync(changes, cancellationToken);

Ardından, nota daha sonra erişip güncelleştirerek eTag mağazadan okuduğunuz nota erişin.

EchoBot.cs

var note = NoteStore.ReadAsync<Note>("Note").Result?.FirstOrDefault().Value;

if (note != null)
{
    note.Contents += ", bread";
    var changes = new Dictionary<string, object>();
    {
         changes.Add("Note1", note);
    };
    await NoteStore.WriteAsync(changes, cancellationToken);
}

Değişikliklerinizi yazmadan önce not depoda güncelleştirildiyse çağrısı Write bir özel durum oluşturur.

JavaScript

Botunuzun sonuna bir veri deposuna örnek not yazacak bir yardımcı işlev ekleyin. İlk olarak nesne oluşturun myNoteData .

bot.js

// Helper function for writing a sample note to a data store
async function createSampleNote(storage, context) {
    var myNoteData = {
        name: "Shopping List",
        contents: "eggs",
        // If any Note file is already stored, the eTag field
        // must be set to "*" in order to allow writing without first reading the stored eTag
        // otherwise you'll likely get an exception indicating an eTag conflict.
        eTag: "*"
    }
}

Yardımcı işlevinde createSampleNote bir changes nesne başlatın ve notlarınızı ekleyin, ardından depolama alanına yazın.

bot.js

// Write the note data to the "Note" key
var changes = {};
changes["Note"] = myNoteData;
// Creates a file named Note, if it doesn't already exist.
// specifying eTag= "*" will overwrite any existing contents.
// The act of writing to the file automatically updates the eTag property
// The first time you write to Note, the eTag is changed from *, and file contents will become:
//    {"name":"Shopping List","contents":"eggs","eTag":"1"}
try {
     await storage.write(changes);
     var list = changes["Note"].contents;
     await context.sendActivity(`Successful created a note: ${list}`);
} catch (err) {
     await context.sendActivity(`Could not create note: ${err}`);
}

Yardımcı işlevine botunuzun mantığının içinden aşağıdaki çağrı eklenerek erişilir:

bot.js

// Save a note with etag.
await createSampleNote(storage, turnContext);

Oluşturulduktan sonra notu daha sonra almak ve güncelleştirmek için kullanıcı "güncelleştirme notunu" yazdığınızda erişilebilen başka bir yardımcı işlev oluştururuz.

bot.js

async function updateSampleNote(storage, context) {
    try {
        // Read in a note
        var note = await storage.read(["Note"]);
        console.log(`note.eTag=${note["Note"].eTag}\n note=${JSON.stringify(note)}`);
        // update the note that we just read
        note["Note"].contents += ", bread";
        console.log(`Updated note=${JSON.stringify(note)}`);

        try {
             await storage.write(note); // Write the changes back to storage
             var list = note["Note"].contents;
             await context.sendActivity(`Successfully updated note: ${list}`);
        } catch (err) {
             console.log(`Write failed: ${err}`);
        }
    }
    catch (err) {
        await context.sendActivity(`Unable to read the Note: ${err}`);
    }
}

Bu yardımcı işleve botunuzun mantığı içinden aşağıdaki çağrı eklenerek erişilir:

bot.js

// Update a note with etag.
await updateSampleNote(storage, turnContext);

Değişikliklerinizi geri yazmaya çalışmadan önce not başka bir kullanıcı tarafından depoda güncelleştirildiyse, eTag değer artık eşleşmez ve çağrısı write bir özel durum oluşturur.

Piton

İlk olarak, uygulayan StoreItembir sınıf oluşturun.

echo_bot.py

class Note(StoreItem):
    def __init__(self, name: str, contents: str, e_tag="*"):
        super(Note, self).__init__()
        self.name = name
        self.contents = contents
        self.e_tag = e_tag

Ardından, bir depolama nesnesi oluşturarak bir ilk not oluşturun ve nesneyi deponuza ekleyin.

echo_bot.py

# create a note for the first time, with a non-null, non-* ETag.
changes = {"Note": Note(name="Shopping List", contents="eggs", e_tag="x")}

await self.storage.write(changes)

Ardından, nota daha sonra erişip güncelleştirerek eTag mağazadan okuduğunuz nota erişin.

echo_bot.py

store_items = await self.storage.read(["Note"])
    note = store_items["Note"]
    note.contents = note.contents + ", bread"

    changes = {"Note": note}
    await self.storage.write(changes)

Değişikliklerinizi yazmadan önce not depoda güncelleştirildiyse çağrısı write bir özel durum oluşturur.

Eşzamanlılığı korumak için her zaman depolama alanından bir özelliği okuyun, ardından okuduğunuz özelliği değiştirin; böylece eTag bu özellik korunur. Kullanıcı verilerini depodan okursanız yanıt eTag özelliğini içerir. Verileri değiştirir ve güncelleştirilmiş verileri depoya yazarsanız, isteğiniz daha önce okuduğunuzla aynı değeri belirten eTag özelliğini içermelidir. Ancak, öğesinin ayarlanmış eTag olduğu * bir nesne yazmak, yazma işleminin diğer değişikliklerin üzerine yazılmasını sağlar.

Sonraki adımlar

Artık doğrudan depolama alanından okuma ve yazma hakkında bilgi edindiğinize göre, bunu sizin için yapmak için durum yöneticisini nasıl kullanabileceğinize göz atalım.

Konuşma ve kullanıcı özelliklerini kullanarak durumu kaydetme