Aracılığıyla paylaş

Transkript dosyalarını kullanarak botunuzda hata ayıklama

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Bir botu başarılı bir şekilde test edip hata ayıklamanın anahtarlarından biri, botunuzu çalıştırırken oluşan koşullar kümesini kaydedip inceleyebilmektir. Bu makalede, test ve hata ayıklama için ayrıntılı bir kullanıcı etkileşimleri ve bot yanıtları kümesi sağlamak üzere bir bot transkript dosyasının oluşturulması ve kullanılması ele alınmaktadır.

Bot transkript dosyası

Bot transkript dosyası, kullanıcıyla botunuz arasındaki etkileşimleri koruyan özel bir JSON dosyasıdır. Transkript dosyası yalnızca iletinin içeriğini değil, kullanıcı kimliği, kanal kimliği, kanal türü, kanal özellikleri, etkileşimin zamanı gibi etkileşim ayrıntılarını da korur. Daha sonra bu bilgilerin tümü botunuzu test ederken veya hata ayıklarken sorunları bulmanıza ve çözmenize yardımcı olmak için kullanılabilir.

Bot transkript dosyası oluşturma/depolama

Bu makalede, Bot Framework Emulator kullanarak bot transkript dosyalarının nasıl oluşturulacağı gösterilmektedir. Transkript dosyaları da program aracılığıyla oluşturulabilir; Bu yaklaşımla ilgili daha fazla bilgi edinmek için bkz. Blob transkript depolama . Bu makalede, kullanıcının taşıma, ad ve yaş modunu isteyen Çok Dönüşlü İstem Botu için Bot Framework örnek kodunu kullanacağız, ancak Microsoft'un Bot Framework Emulator kullanılarak erişilebilen tüm kodlar transkript dosyası oluşturmak için kullanılabilir.

Bu işleme başlamak için test etmek istediğiniz bot kodunun geliştirme ortamınızda çalıştığından emin olun.

  1. Öykünücüyü başlatın.

  2. Hoş Geldiniz sekmesinde Botu Aç'ı seçin.

  3. Botunuzun dinlediği bağlantı noktasının adresini girin ve ardından /api/messagesörneğin adresini http://localhost:3978/api/messagesgirin.

    Botunuz bir Microsoft uygulama kimliği ve parolası ile yapılandırılmışsa, Bot aç iletişim kutusuna kimlik ve parolayı girin. Aksi takdirde Öykünücü botunuza bağlanamaz.

  4. Öykünücüyü botunuza bağlamak için Bağlan'ı seçin.

    Öykünücüden bota bağlanma iletişim kutusunun ekran görüntüsü.

Öykünücüde botunuzla etkileşim kurarak kodunuzu test edin. Korumak istediğiniz tüm kullanıcı etkileşimlerini girdikten sonra, bu konuşmayı içeren bir döküm dosyası oluşturmak ve kaydetmek için Bot Framework Emulator kullanın.

  1. Canlı Sohbet sekmesinde Dökümü kaydet'i seçin.

    Öykünücüdeki konuşmanın ve 'dökümü kaydet' düğmesinin ekran görüntüsü.

  2. Transkript dosyanız için bir konum ve ad seçin ve Kaydet'i seçin.

    'Konuşma dökümünü kaydet' iletişim kutusunun ekran görüntüsü.

Öykünücü ile kodunuzu test etmek için girdiğiniz tüm kullanıcı etkileşimleri ve bot yanıtları artık kullanıcınızla botunuz arasındaki etkileşimlerde hata ayıklamaya yardımcı olmak için yeniden yükleyebileceğiniz bir transkript dosyasına kaydedildi.

Bot transkript dosyasını alma

Bir transkript dosyasını açtığınızda Öykünücü kaydedilen konuşmayı yeni bir sekmeye yükler.

Bot transkript dosyasını almak için:

  1. Öykünücü'yü açın.
  2. Menüden Dosya'yı ve ardından Transkripti Aç'ı seçin.
  3. Almak istediğiniz transkript dosyasını seçmek ve açmak için Transkript dosyasını aç'ı kullanın.

'Transkript dosyasını aç' iletişim kutusunun ekran görüntüsü.

Transkript dosyasını kullanarak hata ayıklama

Transkript dosyanız yüklendiyse artık bir kullanıcıyla botunuz arasında yakaladığınız etkileşimlerde hata ayıklamaya hazırsınız demektir.

  1. Öykünücünün günlük bölmesinde kaydedilen herhangi bir kullanıcı veya bot iletisini veya etkinliği seçin.

  2. Öykünücü, etkinlik bilgilerini denetçi bölmesinde görüntüler. Etkinlik bilgileri, etkinlik için HTTP isteğinin yüküdür.

    İleti etkinliği şunları içerir:

    • Etkinlik türü
    • Etkinliğin kanaldan gönderildiği veya kanal tarafından alındığı saat
    • Kullanıcının kanalı hakkında bilgi
    • Etkinliğin göndereni ve alıcısı from hakkındaki bilgiler sırasıyla ve recipient alanlarında
    • Bir ileti etkinliğinin ileti metni gibi etkinlik türüne özgü bilgiler.

Bu ayrıntılı bilgi düzeyi, kullanıcının girişiyle botunuzun yanıtı arasındaki adım adım etkileşimleri izlemenize olanak tanır. Bu, botunuzun tahmin ettiğiniz şekilde yanıt vermediği veya kullanıcıya hiç yanıt vermediği durumlarda hata ayıklamak için kullanışlıdır. Hem bu değerlere hem de başarısız etkileşime giden adımların kaydına sahip olmak, kodunuzda adım adım ilerleyerek botunuzun beklenen şekilde yanıt veremediği konumu bulmanıza ve bu sorunları çözmenize olanak tanır.

Transkript dosyalarını Bot Framework Emulator ile birlikte kullanmak, botunuzun kodunu ve kullanıcı etkileşimlerini test edip hatalarını ayıklamanıza yardımcı olmak için kullanabileceğiniz birçok araçdan yalnızca biridir.

Ek bilgiler

Daha fazla test ve hata ayıklama bilgisi için bkz: