Özel Komutlar kavramları ve tanımları
Önemli
Özel Komutlar 30 Nisan 2026'da kullanımdan kaldırılacaktır. 30 Ekim 2023 itibarıyla Speech Studio'da yeni Özel Komutlar uygulaması oluşturamazsınız. Bu değişiklikle ilgili olarak LUIS, 1 Ekim 2025'te kullanımdan kaldırılacaktır. 1 Nisan 2023 itibarıyla yeni LUIS kaynakları oluşturamazsı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, 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.
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. Daha fazla doğrulama ekleyebilir veya onaylar veya tek adımlı düzeltme gibi gelişmiş özellikleri yapılandırabilirsiniz. Ayrıca 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.
Veri Akışı Adı
Name özelliği tarafından bir parametre tanımlanır. Bir parametreye her zaman açıklayıcı bir ad vermelisiniz. Koşullar, konuşma yanıtları veya başka eylemler oluştururken parametreye farklı bölümler arasında başvurulabilir.
Zorunlu
Bu onay kutusu, bu parametre için bir değerin komut yerine getirme 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 parametreyi Varsayılan değere sahip olacak şekilde yapılandırdıysanız, sistem yine de parametrenin değerini ister.
Tür
Özel Komutlar aşağıdaki parametre türlerini destekler:
- Yaş
- Para birimi
- DateTime
- Boyut
- E-posta
- Coğrafi Bölge
- Sayı
- Sıralı
- Yüzde
- Kişi Adı
- PhoneNumber
- String
- 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 kullandığından, yerel ayarda parametre türünün kullanılabilirliği LUIS'in bu yerel ayardaki ö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.
Sayı, Dize 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, parametre herhangi bir giriş ifadesini kabul eder. Bu seçenek, kullanıcının tam ifadeye sahip bir parametreye ihtiyacı olduğunda kullanışlıdır. Posta adresleri örnek olarak verilmiştir.
- Dış katalogdan önceden tanımlanmış giriş değerlerini kabul etme: Bu değer, çok çeşitli değerler varsayabilen bir parametreyi 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 edin: 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ğerinde kısıtlamaları yapılandırmanıza olanak sağlayan belirli parametre türleri için geçerli olan yapılardır. Özel Komutlar şu anda 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 eylemi yürüten bir dizi koşul tarafından tanımlanır. Kurallar ayrıca yürütme sonrası durumunu ve sonraki dönüşle ilgili beklentileri yapılandırmanıza da 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 başka bir özel iletişim kutusu mantığı gerçekleştirmek için kullanılabilir. Etkileşim kuralları, işleme sırasında her turda değerlendirilir ve tamamlama kurallarını tetikleme amacıyla kullanılabilir.
Bir 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, bir 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 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 sonucu 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ş konuşması veya etkinliği başarılı bir onay değildi (hayır).
- Önceki komutun güncelleştirilmesi gerekiyor: Bu koşul, güncelleştirmeyle birlikte olumsuz bir onay yakalamak istediğiniz durumlarda kullanılır. Arka planda, iletişim kutusu altyapısı 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ığında için bu koşul yapılandırılır.
Eylemler
- Konuşma yanıtı gönderme: İstemciye bir konuşma yanıtı gönderme.
- Parametre değerini güncelleştir: Komut parametresinin değerini belirtilen bir değere güncelleştirin.
- Parametre değerini temizle: Komut parametresi değerini temizleyin.
- Web uç noktasını çağırma: Web uç noktasına çağrı yapın.
- İstemciye etkinlik gönderme: İstemciye özel 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 bir 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 başka kuralı 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.