İletişim kutuları kitaplığı

Makale
10/27/2023

ŞUNLAR IÇIN GEÇERLIDIR: SDK v4

İletişim kutuları , kullanıcıyla uzun süre çalışan bir konuşmayı yönetmenin yollarını sağlayan SDK'daki bir cMicrosoft Entral kavramıdır. İletişim kutusu, konuşma yazışmasının bir bölümünü veya tamamını temsil eden bir görev gerçekleştirir. Yalnızca bir veya daha fazla dönüşe yayılabilir ve kısa veya uzun bir süreye yayılabilir.

Bu makalede, iletişim kutusu kitaplığının temel sınıfları ve özellikleri açıklanmaktadır.

Botların nasıl çalıştığını (dönüş de dahil) ve durumu yönetmeyi biliyor olmalısınız.
Her iletişim kutusu, tamamlanmak ve toplanan bilgileri döndürmek için çalışabilen bir konuşma görevini temsil eder.
Her iletişim kutusu temel bir denetim akışı birimini temsil eder: başlayabilir, devam edebilir ve sona erebilir; duraklatma ve sürdürme; veya iptal edilebilir.
İletişim kutuları, programlama dilindeki bir yönteme veya işleve benzer. bir iletişim kutusu başlattığınızda bağımsız değişkenleri veya parametreleri geçirebilirsiniz ve iletişim kutusu daha sonra sona erdiğinde bir dönüş değeri üretebilir.

Bahşiş

Bot Framework ile bot geliştirmeye veya yeni bir konuşma deneyimi oluşturmaya yeni başladıysanız Bot Framework Composer ile başlayın. Composer'da oluşturulmayan mevcut SDK öncelikli botlar için botunuzu bir beceri olarak kullanıma seçip gelecekteki bot geliştirmeleri için Composer'ı kullanmayı göz önünde bulundurun.

İletişim kutusu durumu

İletişim kutuları çok aşamalı bir konuşma uygulayabilir ve bu nedenle sırayla kalıcı duruma dayanır. İletişim kutularındaki durum bilgisi olmadan botunuz konuşmanın neresinde olduğunu veya daha önce topladığı bilgileri bilemez.

İletişim kutusunun konuşmadaki yerini korumak için iletişim kutusunun durumu her dönüşten alınıp belleğe kaydedilmelidir. Bu, botunun konuşma durumunda tanımlanan bir iletişim durumu özellik erişimcisi aracılığıyla işlenir. Bu iletişim kutusu durumu, tüm etkin iletişim kutuları ve etkin iletişim kutularının alt öğeleriyle ilgili bilgileri yönetir. Bu, bota en son kaldığı yerden devam etmesini ve çeşitli konuşma modellerini işlemesini sağlar.

Çalışma zamanında, iletişim kutusu durumu özelliği, iletişim kutusu örneği nesnesi biçiminde dahili olarak toplanan bilgiler de dahil olmak üzere iletişim kutusunun mantıksal işleminde nerede olduğuna ilişkin bilgileri içerir. Bunun bota okunması ve her dönüşte belleğe kaydedilmesi gerekir.

İletişim kutusu altyapısı

Çeşitli iletişim kutusu türlerinin yanı sıra, aşağıdaki sınıflar konuşmaların tasarımına ve denetimine dahil edilir. Genellikle bu sınıflarla doğrudan etkileşim kurmanız gerekmez ancak bot için iletişim kutuları tasarlarken bunların farkında olmanız ve bunların amacı yararlı olur.

Sınıf	Tanım
İletişim kutusu kümesi	Birbirine başvurabilen ve birlikte çalışabilen bir iletişim kutusu koleksiyonu tanımlar.
İletişim kutusu bağlamı	Tüm etkin iletişim kutuları hakkında bilgi içerir.
İletişim kutusu örneği	Etkin bir iletişim kutusu hakkında bilgi içerir.
İletişim kutusu sonuç döndürme	Etkin veya son etkin iletişim kutusundan durum bilgilerini içerir. Etkin iletişim kutusu sona erdiyse, bu, dönüş değerini içerir.

İletişim kutusu türleri

İletişim kutuları kitaplığı, botunuzun konuşmalarını yönetmeyi kolaylaştırmak için birkaç tür iletişim kutusu sağlar. Bu türlerden bazıları, bu makalenin devamında daha ayrıntılı olarak açıklanmıştır.

Türü	Tanım
Iletişim	Tüm iletişim kutuları için temel sınıf.
kapsayıcı iletişim kutusu	Bileşen ve uyarlamalı iletişim kutuları gibi tüm kapsayıcı iletişim kutularının temel sınıfı. bir iç iletişim kutusu kümesi tutar ve bir iletişim kutusu koleksiyonunu bir birim olarak ele almanızı sağlar.
bileşen iletişim kutusu	Bir iletişim kutusu kümesini kapsülleyen ve kümenin bir bütün olarak yeniden kullanılmasına olanak sağlayan genel amaçlı bir kapsayıcı iletişim kutusu türüdür. Bileşen iletişim kutusu başlatıldığında, koleksiyonunda belirlenmiş bir iletişim kutusuyla başlar. İç işlem tamamlandığında bileşen iletişim kutusu sona erer.
şelale iletişim kutusu	Botunuzun bir kullanıcıya doğrusal bir işlemde yol göstermesine olanak sağlayan bir adım dizisi tanımlar. Bunlar genellikle bir bileşen iletişim kutusu bağlamında çalışacak şekilde tasarlanmıştır.
istem iletişim kutuları	Kullanıcıdan giriş isteyin ve sonucu döndürin. Bir istem geçerli giriş alınana veya iptal edilene kadar yinelenir. Şelale iletişim kutularıyla çalışacak şekilde tasarlanmıştır.
uyarlamalı iletişim kutusu	Oluşturucu tarafından daha doğal konuşma akışları sağlamak için kullanılan kapsayıcı iletişim kutusu türü. Doğrudan SDK öncelikli bir botta kullanılmak üzere tasarlanmamıştır .
eylem iletişim kutuları	Oluşturucu'da eylemlerin uygulanmasını destekleyen bir iletişim kutusu türü. Doğrudan SDK öncelikli bir botta kullanılmak üzere tasarlanmamıştır .
giriş iletişim kutuları	Oluşturucu'da giriş eylemlerinin uygulanmasını destekleyen bir iletişim kutusu türü. Doğrudan SDK öncelikli bir botta kullanılmak üzere tasarlanmamıştır .
beceri iletişim kutusu	Bir beceri tüketicisinden bir veya daha fazla beceri botunun yönetimini otomatikleştirir. Besteci doğrudan eylem olarak becerileri destekler.
Soru-Cevap Oluşturma iletişim kutusu	Soru-Cevap Oluşturma bilgi bankası erişimi otomatikleştirir. Bu iletişim kutusu, Oluşturucu içinde eylem olarak da çalışacak şekilde tasarlanmıştır.

Önemli

Uyarlamalı iletişim kutuları ilk olarak C# SDK'sının 4.9 sürümüne eklendi. Uyarlamalı iletişim kutuları Bot Framework Composer'ı destekler ve doğrudan SDK öncelikli bir botta kullanılmak üzere tasarlanmamıştır.

İletişim kutusu desenleri

Bir bottan iletişim kutusu başlatmak ve yönetmek için iki ana desen vardır.

Daha doğal, serbest akışlı konuşma özelliklerinden yararlanmak için konuşma iletişim kutuları yazmak için Bot Framework Composer'ı kullanmanızı öneririz. Daha fazla bilgi için bkz . Bot Framework Composer'a Giriş. Bu tür botlar gerektiğinde kodla genişletilebilir.
SDK dillerinden birinde botunuzu geliştirin ve kök iletişim kutunuzun çalıştırma uzantısı yöntemini kullanın. Bir bileşen iletişim kutusuyla çalıştırma yöntemini kullanma hakkında bilgi için bkz . bileşen ve şelale iletişim kutuları ve sıralı konuşma akışını uygulama.

İletişim kutusu yığını

İletişim kutusu bağlamı tüm etkin iletişim kutuları hakkında bilgi içerir ve tüm etkin iletişim kutuları için çağrı yığını işlevi gören bir iletişim kutusu yığını içerir. Her kapsayıcı iletişim kutusunun denetlediği bir iç iletişim kutusu kümesi vardır ve bu nedenle her etkin kapsayıcı iletişim kutusu, durumunun bir parçası olarak bir iç iletişim kutusu bağlamı ve iletişim kutusu yığınını tanıtır.

Yığına doğrudan erişmeseniz de, var olduğunu ve işlevini anlamanız, iletişim kutusu kitaplığının çeşitli yönlerinin nasıl çalıştığını anlamanıza yardımcı olur.

Kapsayıcı iletişim kutuları

Kapsayıcı iletişim kutusu daha büyük bir iletişim kutusu kümesinin parçası olabilir. Her kapsayıcının da yönetilen bir iç iletişim kutusu kümesi vardır.

Her iletişim kutusu kümesi, iletişim kutusu kimliklerini çözümlemek için bir kapsam oluşturur.
SDK şu anda iki tür kapsayıcı iletişim kutusu uygular: bileşen iletişim kutuları ve uyarlamalı iletişim kutuları.

İkisinin kavramsal yapısı oldukça farklıdır. Ancak Composer botu her ikisini de kullanabilir.

İletişim Kutusu Kimlikleri

İletişim kutusu kümesine bir iletişim kutusu eklediğinizde, bu küme içinde benzersiz bir kimlik atarsınız. Bir küme içindeki iletişim kutuları, kimliklerine göre birbirine başvurur.

Bir iletişim kutusu çalışma zamanında başka bir iletişim kutusuna başvurduğunda, bunu iletişim kutusunun kimliğine göre yapar. İletişim kutusu bağlamı, kimliği anında iletişim kutusu kümesindeki diğer iletişim kutularına göre çözümlemeye çalışır. Eşleşme yoksa, içeren veya dış iletişim kutusunda eşleşme arar ve bu şekilde devam eder. Eşleşme bulunmazsa bir özel durum veya hata oluşturulur.

Bileşen iletişim kutuları

Bileşen iletişim kutuları konuşmalar için bir sıra modeli kullanır ve kapsayıcıdaki her iletişim kutusu kapsayıcıdaki diğer iletişim kutularını çağırmaktan sorumludur. Bileşen iletişim kutusunun iç iletişim kutusu yığını boş olduğunda bileşen sona erer.

Botunuzun daha dinamik konuşma akışı gerektirmeyen nispeten basit bir denetim akışı varsa bileşen ve şelale iletişim kutularını kullanmayı göz önünde bulundurun.

Bileşen ve şelale iletişim kutuları hakkında bileşeni, şelaleyi ve istem iletişim kutularını daha ayrıntılı olarak açıklar.

Diğer iletişim kutuları

Soru-Cevap Oluşturma ve beceri iletişim kutuları, tek başına iletişim kutuları olarak veya kapsayıcıdaki bir iletişim kutusu koleksiyonunun parçası olarak kullanılabilir.

Soru-Cevap Oluşturma iletişim kutusu

Dekont

Azure Yapay Zeka Soru-Cevap Oluşturma 31 Mart 2025 tarihinde kullanımdan kaldırılacaktır. 1 Ekim 2022 tarihinden itibaren yeni QnA Maker kaynakları veya bilgi bankası makaleleri oluşturamazsınız. Soru ve yanıtlama özelliğinin daha yeni bir sürümü artık Azure AI Dili'nin bir parçası olarak kullanılabilir.

Azure AI Dili'nin bir özelliği olan özel soru yanıtlama, Soru-Cevap Oluşturma hizmetinin güncelleştirilmiş sürümüdür. Bot Framework SDK'sında soru-cevap desteği hakkında daha fazla bilgi için bkz . Doğal dil anlama.

Soru-Cevap Oluşturma iletişim kutusu bir Soru-Cevap Oluşturma bilgi bankası erişir ve Soru-Cevap Oluşturma'nın izleme istemini ve etkin öğrenme özelliklerini destekler.

Çok aşamalı istemler olarak da bilinen izleme istemleri, bir bilgi bankası sorusunu yanıtlamadan önce kullanıcıdan daha fazla bilgi istemesine olanak tanır.
Etkin öğrenme önerileri, bilgi bankası zaman içinde geliştirmesine olanak sağlar. Soru-Cevap Oluşturma iletişim kutusu, etkin öğrenme özelliği için açık geri bildirimleri destekler.

Daha fazla bilgi için bkz.

Soru-Cevap Oluşturma nedir?.
SDK'da soruları yanıtlamak için Soru-Cevap Oluşturma'yı kullanma.
Composer'da botunuza Soru-Cevap Oluşturma bilgi bankası ekleme.

Beceri iletişim kutusu

Beceri iletişim kutusu bir veya daha fazla beceriye erişir ve yönetir. Beceri iletişim kutusu, üst bottan beceri botunun etkinliklerine gönderiler ve beceri yanıtlarını kullanıcıya döndürür.