Aracılığıyla paylaş

ngrok kullanarak herhangi bir kanaldan botta hata ayıklama

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

Botunuz geliştirme aşamasındayken botunuzla yerel olarak sohbet etmek ve botunuzun gönderip aldığı iletileri incelemek için bir IDE ve Bot Framework Öykünücüsü kullanabilirsiniz. Botunuz üretimdeyse, ngrok kullanarak botunuzun hatalarını herhangi bir kanaldan ayıklayabilirsiniz. Botunuzun birden çok kanala sorunsuz bağlantısı, Bot Framework'te kullanılabilen önemli bir özelliktir.

Bu makalede, botunuza bağlı bir kanalda ngrok ve C# EchoBot kullanarak botunuzda yerel olarak hata ayıklama açıklanmaktadır. Bu makalede örnek kanal olarak Microsoft Teams kullanılır.

Dekont

Bot Framework Öykünücüsü ve ngrok, kullanıcı tarafından atanan yönetilen kimliği veya tek kiracılı botları desteklemez.

Ön koşullar

ngrok çalıştırma

ngrok , İnternet isteklerinin yerel makinenize ulaşması için tünel oluşturma veya iletme URL'si oluşturabilen platformlar arası bir uygulamadır. Azure portalında yapılandırılan standart mesajlaşma uç noktasının aksine, hata ayıklamaya izin vermek için ngrok kullanarak web'deki dış kanallardan gelen iletileri doğrudan yerel makinenize iletin.

  1. Bir terminal açın ve ngrok yürütülebilir dosyasını içeren klasöre gidin.

  2. Yeni bir tünel oluşturmak için ngrok'u aşağıdaki komutla çalıştırın.

    ngrok http 3978 --host-header rewrite

    Dekont

    Belirtilen bağlantı noktası, botunuzun üzerinde çalıştığı bağlantı noktasıdır. İstediğiniz herhangi bir localhost bağlantı noktasını kullanabilirsiniz.

  3. ngrok başladığında, daha sonra genel iletme URL'sini kopyalayın ve kaydedin.

    ngrok forwarding URL

Azure portalında yapılandırma

ngrok çalışırken Azure portalınızda oturum açın ve bazı yapılandırmalar yapmak için bot ayarlarınızı görüntüleyin.

  1. Yerel botunuza bağlı bot kaynağınızı seçin.

  2. Aşağı kaydırarak Yapılandırma'ya gidin. Ngrok iletme URL'sini kopyalayıp Mesajlaşma uç noktası alanına yapıştırın. URL'nin sonunda "/api/messages" kullandığınızdan emin olun.

    Messaging endpoint

  3. Yukarı kaydırın ve Kaydet'i seçin.

Test etme

Bu noktada, dış kanallardan botunuza gelen iletiler artık yerel botunuza gönderilir. Bunu göstermek için kullanacağımız örnek bot, Microsoft Teams için zaten canlı olarak yapılandırılmıştır. Yerel botu Microsoft Teams kanalına bağlama hakkında microsoft teams'e bot Bağlan makalesini okuyun.

Teams channel

Yerel olarak, Visual Studio'da kesme noktaları ayarlayabilirsiniz. Gelen etkinlik nesnesinden metin özelliğini genişleterek, hata ayıklamanız için ekiplerden botu gönderdiğiniz iletinin yerel olarak kesildiğini görürsünüz.

Set breakpoints

Buradan normal şekilde hata ayıklayabilir ve kodunuzu adım adım çalıştırabilirsiniz. Botunuzda herhangi bir kanalda hata ayıklamak için bunu kullanın.

Ek bilgiler