Özel Komutlar kavramları ve tanımları
Önemli
Özel Komutlar 30 Nisan 2026'da kullanımdan kaldırılacak ve 30 Ekim 2023'den itibaren Speech Studio'da yeni Özel Komutlar uygulamaları oluşturamayacaksınız. Bu değişiklikle ilgili olarak LUIS , 1 Ekim 2025'te kullanımdan kaldırılacak ve 1 Nisan 2023'den itibaren yeni LUIS kaynakları oluşturamayacaksınız.
Bu makale, Özel Komutlar uygulamalarına yönelik kavramlar ve tanımlar için bir başvuru görevi görür.
Komut yapılandırması
Komutlar, Özel Komutlar uygulamasının temel yapı taşlarıdır. Komut, bir kullanıcı tarafından tanımlanan belirli bir görevi tamamlamak için gereken yapılandırma kümesidir.
Örnek cümleler
Örnek konuşmalar, kullanıcının belirli bir komutu tetiklemek için söyleyebileceği küme örnekleridir. Kapsamlı bir liste değil, yalnızca bir konuşma örneği sağlamanız gerekir.
Parametreler
Parametreler, komutların bir görevi tamamlaması için gereken bilgilerdir. Karmaşık senaryolarda parametreler, özel eylemleri tetikleyen koşulları tanımlamak için de kullanılabilir.
Tamamlama kuralları
Tamamlama kuralları, komut yerine getirilmeye hazır olduktan sonra, örneğin kuralların tüm koşulları karşılandığında yürütülecek bir dizi kuraldır.
Etkileşim kuralları
Etkileşim kuralları, daha belirli veya karmaşık durumları işlemek için ek kurallardır. Ek doğrulamalar ekleyebilir veya onaylar veya tek adımlı düzeltme gibi gelişmiş özellikleri yapılandırabilirsiniz. Kendi özel etkileşim kurallarınızı da oluşturabilirsiniz.
Parametre yapılandırması
Parametreler, bir görevi tamamlamak için komutların gerektirdiği bilgilerdir. Karmaşık senaryolarda parametreler, özel eylemleri tetikleyen koşulları tanımlamak için de kullanılabilir.
Name
Bir parametre name özelliği tarafından tanımlanır. Bir parametreye her zaman açıklayıcı bir ad vermelisiniz. Bir parametre, koşullar, konuşma yanıtları veya başka eylemler oluşturduğunuzda, farklı bölümler arasında başvurulabilir.
Gerekli
Bu onay kutusu, bu parametre için bir değerin komut gerçekleştirme veya tamamlama için gerekli olup olmadığını gösterir. Bir parametre gerekli olarak işaretlenmişse kullanıcıdan bir değer sağlamasını isteyecek yanıtları yapılandırmanız gerekir.
Gerekli bir parametreyiVarsayılan değere sahip olacak şekilde yapılandırdıysanız sistemin yine de parametrenin değerini açıkça soracağını unutmayın.
Tür
Özel Komutlar aşağıdaki parametre türlerini destekler:
- Yaş
- Para Birimi
- DateTime
- Boyut
- E-posta
- Coğrafya
- Sayı
- Sıralı
- Yüzde
- PersonName
- PhoneNumber
- Dize
- Sıcaklık
- Url
Her yerel ayar "Dize" parametre türünü destekler, ancak diğer tüm türlerin kullanılabilirliği yerel ayara göre farklılık gösterir. Özel Komutlar LUIS'in önceden oluşturulmuş varlık çözümlemesini kullanır, bu nedenle yerel ayarda parametre türünün kullanılabilirliği LUIS'in bu yerel ayarda önceden oluşturulmuş varlık desteğine bağlıdır. LUIS'in yerel ayar başına önceden oluşturulmuş varlık desteği hakkında daha fazla ayrıntı bulabilirsiniz. Özel LUIS varlıkları (makine öğrenmesi varlıkları gibi) şu anda desteklenmemektedir.
Number, String ve DateTime gibi bazı parametre türleri, portaldan yapılandırabileceğiniz varsayılan değer yapılandırmasını destekler.
Yapılandırma
Yapılandırma yalnızca Dize türü için tanımlanan bir parametre özelliğidir. Aşağıdaki değerler desteklenir:
- Yok.
- Tam girişi kabul et: Etkinleştirildiğinde, bir parametre tüm giriş konuşmalarını kabul eder. Bu seçenek, kullanıcının tam konuşma içeren bir parametreye ihtiyacı olduğunda kullanışlıdır. Posta adresleri örnek olarak verilmiştir.
- Dış katalogdan önceden tanımlanmış giriş değerlerini kabul edin: Bu değer, çok çeşitli değerlerin kabul edilebilir bir parametresini yapılandırmak için kullanılır. Satış kataloğu örnek olarak verilmiştir. Bu durumda katalog bir dış web uç noktasında barındırılır ve bağımsız olarak yapılandırılabilir.
- İç katalogdan önceden tanımlanmış giriş değerlerini kabul et: Bu değer, birkaç değer varsayabilen bir parametreyi yapılandırmak için kullanılır. Bu durumda, değerlerin Speech Studio'da yapılandırılması gerekir.
Doğrulama
Doğrulamalar, bir parametrenin değeri üzerinde kısıtlamalar yapılandırmanıza olanak sağlayan belirli parametre türleri için geçerli olan yapılardır. Şu anda, Özel Komutlar aşağıdaki parametre türlerinde doğrulamaları destekler:
- DateTime
- Sayı
Kural yapılandırması
Özel Komutlar'daki bir kural, karşılandığında bir dizi eylem yürüten bir dizi koşul tarafından tanımlanır. Kurallar ayrıca yürütme sonrası durumu ve sonraki dönüş için beklentileri yapılandırmanıza olanak sağlar.
Türler
Özel Komutlar aşağıdaki kural kategorilerini destekler:
- Tamamlama kuralları: Bu kurallar, komut yerine getirilme üzerine yürütülmelidir. Koşulların doğru olduğu bu bölümde yapılandırılan tüm kurallar yürütülür.
- Etkileşim kuralları: Bu kurallar ek özel doğrulamalar, onaylar ve tek adımlı düzeltme yapılandırmak veya diğer özel iletişim kutusu mantığını gerçekleştirmek için kullanılabilir. Etkileşim kuralları, işlemenin her dönüşünde değerlendirilir ve tamamlanma kurallarını tetikleme amacıyla kullanılabilir.
Kuralın parçası olarak yapılandırılan farklı eylemler, yazma portalında göründükleri sırayla yürütülür.
Koşullar
Koşullar, kuralın yürütülmesi için karşılanması gereken gereksinimlerdir. Kural koşulları aşağıdaki türlerde olabilir:
- Parametre değeri eşittir: Yapılandırılan parametrenin değeri belirli bir değere eşittir.
- Parametre değeri yok: Yapılandırılan parametrelerin herhangi bir değeri olmamalıdır.
- Gerekli parametreler: Yapılandırılan parametrenin bir değeri vardır.
- Tüm gerekli parametreler: Gerekli olarak işaretlenmiş tüm parametrelerin bir değeri vardır.
- Güncelleştirilmiş parametreler: Geçerli girişin (konuşma veya etkinlik) işlenmesi sonucunda bir veya daha fazla parametre değeri güncelleştirildi.
- Onay başarılı oldu: Giriş ifadesi veya etkinlik başarılı bir onaydı (evet).
- Onay reddedildi: Giriş ifadesi veya etkinlik başarılı bir onay değildi (hayır).
- Önceki komutun güncelleştirilmesi gerekiyor: Bu koşul, bir güncelleştirmeyle birlikte olumsuz bir onay yakalamak istediğiniz durumlarda kullanılır. Arka planda bu koşul, iletişim kutusu altyapısının amacın önceki dönüşle aynı olduğu ve kullanıcının bir güncelleştirmeyle yanıt verdiği negatif bir onay algıladığı durum için yapılandırılır.
Eylemler
- Konuşma yanıtı gönderme: İstemciye bir konuşma yanıtı geri gönderin.
- Parametre değerini güncelleştir: Bir komut parametresinin değerini belirtilen değerle güncelleştirin.
- Parametre değerini temizle: Komut parametresi değerini temizleyin.
- Web uç noktasını çağırma: Bir web uç noktasına çağrı yapın.
- İstemciye etkinlik gönderme: İstemciye özel bir etkinlik gönderin.
Beklenti
Beklentiler, sonraki kullanıcı girişinin işlenmesine yönelik ipuçlarını yapılandırmak için kullanılır. Aşağıdaki türler desteklenir:
- Kullanıcıdan onay bekleniyor: Bu beklenti, uygulamanın bir sonraki kullanıcı girişi için onay (evet/hayır) beklediğini belirtir.
- Kullanıcıdan parametre girişi bekleniyor: Bu beklenti, uygulamanın kullanıcı girişinden beklediği bir veya daha fazla komut parametresini belirtir.
Yürütme sonrası durumu
Yürütme sonrası durumu, geçerli girişi (konuşma veya etkinlik) işledikten sonra iletişim durumudur. Aşağıdaki türlerdendir:
- Geçerli durumu koru: Yalnızca geçerli durumu koru.
- Komutu tamamlayın: Komutu tamamlayın ve komutun ek kuralları işlenmez.
- Tamamlama kurallarını yürütme: Tüm geçerli tamamlama kurallarını yürütür.
- Kullanıcının girişini bekleyin: Sonraki kullanıcı girişini bekleyin.