Share via


Hızlı Başlangıç: UYGULAMANıZı LUIS portalında oluşturma

Önemli

LUIS 1 Ekim 2025'te kullanımdan kaldırılacak ve 1 Nisan 2023'den itibaren yeni LUIS kaynakları oluşturamayacaksınız. Devam eden ürün desteği ve çok dilli özelliklerden yararlanmak için LUIS uygulamalarınızıkonuşma dili anlayışına geçirmenizi öneririz.

Bu hızlı başlangıçta, ışıkları ve gereçleri açıp kapatmak için önceden oluşturulmuş ev otomasyonu etki alanını kullanarak bir LUIS uygulaması oluşturun. Önceden oluşturulmuş olan bu etki alanı amaçlara, varlıklara ve örnek konuşmalara sahiptir. Ardından, daha fazla amaç ve varlık ekleyerek uygulamanızı özelleştirmeyi deneyin. İşlemi tamamladığınızda bulut üzerinde çalışan bir LUIS uç noktasına sahip olacaksınız.

LUIS portalında oturum açma

LUIS'e yeni bir kullanıcının şu yordamı izlemesi gerekir:

  1. LUIS portalında oturum açın, ülkenizi/bölgenizi seçin ve kullanım koşullarını kabul edin. Bunun yerine Uygulamalarım görürseniz, bir LUIS kaynağı zaten var ve uygulama oluşturmak için atlamalısınız. Aksi takdirde, bir Azure kaynağı kullanarak başlayın; bu, LUIS hesabınızı yeni veya mevcut bir Azure Yazma kaynağıyla bağlamanıza olanak tanır.
  1. Görüntülenen Yazma seçin penceresinde Azure aboneliğinizi ve LUIS yazma kaynağını bulun. Kaynağınız yoksa yeni bir kaynak oluşturabilirsiniz.

    Choose a type of Language Understanding authoring resource.

    Yeni bir yazma kaynağı oluşturduğunuzda aşağıdaki bilgileri sağlayın:

    • Kiracı adı - Azure aboneliğinizin ilişkili olduğu kiracı.
    • Azure abonelik adı - Kaynak için faturalandırılacak abonelik.
    • Azure kaynak grubu adı - seçtiğiniz veya oluşturduğunuz özel bir kaynak grubu adı. Kaynak grupları, erişim ve yönetim için Azure kaynaklarını gruplandırmanıza olanak sağlar.
    • Azure kaynak adı : Yazma ve tahmin uç noktası sorgularınızın URL'sinin bir parçası olarak kullanılan, seçtiğiniz özel bir addır.
    • Fiyatlandırma katmanı - fiyatlandırma katmanı, saniye ve ay başına maksimum işlemi belirler.

Abonelik ve yazma kaynağı seçme

Belirli bir aboneliği ve yazma kaynağını seçtiğinizde, onunla ilişkilendirilmiş uygulamaların listesini görürsünüz.

Select authoring subscription and authoring resource

Yeni uygulama oluşturma

Uygulamalarım sayfasından uygulama oluşturabilir ve yönetebilirsiniz.

Uygulama oluşturma

Uygulama oluşturmak için + Yeni uygulama'ya tıklayın.

Görüntülenen pencereye aşağıdaki bilgileri girin:

Veri Akışı Adı Açıklama
Ad Uygulamanızın adı. Örneğin, "ev otomasyonu".
Kültür Uygulamanızın anladığı ve konuştuğu dil.
Açıklama Uygulamanız için bir açıklama.
Tahmin kaynağı Sorgu alacak tahmin kaynağı.

Bitti'yi seçin.

Not

Uygulama oluşturduktan sonra kültür değiştirilemez.

Önceden oluşturulmuş etki alanını ekleme

LUIS, uygulamanızı kullanmaya başlamanıza yardımcı olabilecek bir dizi önceden oluşturulmuş etki alanı sunar. Önceden oluşturulmuş bir etki alanı uygulaması zaten amaçlar, varlıklar ve konuşmalarla doldurulmuş.

  1. Sol gezinti bölmesinde Önceden oluşturulmuş etki alanları'nı seçin.

  2. HomeAutomation için arama.

  3. HomeAutomation kartında Etki alanı ekle'yi seçin.

    Select 'Prebuilt domains' then search for 'HomeAutomation'. Select 'Add domain' on the HomeAutomation card.

    Etki alanı başarıyla eklendiğinde önceden oluşturulmuş etki alanı kutusunda Etki alanını kaldır düğmesi görüntülenir.

Amaçları ve varlıkları kullanıma alma

  1. HomeAutomation etki alanı amaçlarını görmek için sol gezinti menüsünde Amaçlar'ı seçin. ve HomeAutomation.SetDevicegibi HomeAutomation.QueryState örnek konuşmaları vardır.

    Not

    Hiçbiri, tüm LUIS uygulamaları tarafından sağlanan bir amaçtır. Uygulamanızın sağladığı işlevleri karşılamayan konuşmaların işlenmesi için bunu seçersiniz.

  2. HomeAutomation.TurnOff amacını seçin. Amaç, varlıklarla etiketlenmiş örnek konuşmaların listesini içerir.

    Screenshot of HomeAutomation.TurnOff intent

  3. Uygulamanın varlıklarını görüntülemek istiyorsanız Varlıklar'ı seçin. HomeAutomation.DeviceName gibi varlıklardan birini seçerseniz onunla ilişkilendirilmiş değerlerin listesini görürsünüz.

    Image alt text

LUIS uygulamasını eğitme

Uygulamanız amaçlar, varlıklar ve ifadelerle doldurulduktan sonra, yaptığınız değişikliklerin yansıtılabilmesi için uygulamayı eğitmeniz gerekir.

  1. LUIS web sitesinin sağ üst kısmında Eğit düğmesini seçin.

    Train button

  2. Eğit düğmesi devre dışı bırakıldığında eğitim tamamlanır.

Uygulamanızı test etme

Uygulamanızı eğittikten sonra test edebilirsiniz.

  1. Sağ üst gezinti bölmesinden Test'i seçin.

  2. Etkileşimli test bölmesine bir test konuşması yazın ve Enter tuşuna basın. Örneğin, işıkları kapatın.

    Bu örnekte Işıkları kapat, HomeAutomation.TurnOff dosyasının en iyi puanlama amacı olarak doğru şekilde tanımlanmıştır.

    Screenshot of test panel with utterance highlighted

  3. Tahmin hakkında daha fazla bilgi görüntülemek için İncele'yi seçin.

    Screenshot of test panel with inspection information

  4. Test bölmesini kapatın.

Uygulamanızı özelleştirme

Luis, önceden oluşturulmuş etki alanlarının yanı sıra kendi özel uygulamalarınızı oluşturmanıza veya önceden oluşturulmuş uygulamaların üzerine özelleştirmenize olanak tanır.

Amaç Oluşturma

Uygulamanıza daha fazla amaç eklemek için

  1. Sol gezinti menüsünden Amaçlar'ı seçin.
  2. Oluştur'u seçin
  3. Amaç adını HomeAutomation.AddDeviceAliasgirin ve Bitti'yi seçin.

Varlık Oluşturma

Uygulamanıza daha fazla varlık eklemek için

  1. Sol gezinti menüsünde Varlıklar'ı seçin.
  2. Oluştur'u seçin
  3. Varlık adını girin, HomeAutomation.DeviceAliastüründen öğrenilen makine'yi seçin ve ardından Oluştur'u seçin.

Örnek konuşmalar ekleme

Örnek konuşmalar, kullanıcının sohbet botunda veya diğer istemci uygulamalarında girdiği metinlerdir. Kullanıcının metninin amacını bir LUIS amacına eşler.

için HomeAutomation.AddDeviceAliasAmaçlar sayfasında, Örnek Konuşma'nın altına aşağıdaki örnek konuşmaları ekleyin.

# Örnek konuşmalar
1 Add alias to my fan to be wind machine
2 Alias lights to illumination
3 nickname living room speakers to our speakers a new fan
4 rename living room tv to main tv

En iyi sonuçlar için örnek konuşmaların aşağıdaki şekillerde farklılık gösterdiğinden emin olun:

  • Konuşma uzunluğu
  • Noktalama
  • Word seçimi
  • Fiil süresi (yani, oldu, olacak)
  • Sözcük sırası

Etiket örneği konuşmaları

Ml varlığı eklediğiniz için konuşmalarınızı etiketlemek gerekir. Etiketleme, oluşturduğunuz ML varlıklarını ayıklamayı öğrenmek için uygulamanız tarafından kullanılır.

Konuşmalarınızı etiketlemek için iki seçeneğiniz vardır: Varlık paleti etiketleme ve satır içi etiketleme.

Varlık paleti etiketleme

Sağ üstteki simgeyi @ seçtiğinizde, varlık paleti sayfanın sağ tarafında açılır.

  1. Etiketlemeye başlamak istediğiniz varlığı seçin.

    labelling an entity using the entity palette

  2. Bu varlıkla etiketlemek istediğiniz metni vurgulayın.

    label an entity using the entity palette

Satır içi etiketleme

  1. Etiketlemek istediğiniz metni vurgulayın.

  2. Açılan menüden metni etiketlemek istediğiniz varlığı seçin.

    menu for label the text

Tahmin kaynağı oluşturma

Bu noktada uygulamanızı yazmayı tamamladınız. Tahmin uç noktası aracılığıyla bir sohbet botunda veya diğer istemci uygulamalarında tahminler almak için uygulamanızı yayımlamak için bir tahmin kaynağı oluşturmanız gerekir

LUIS portalından tahmin kaynağı oluşturmak için

  1. Uygulamanızda Yönet sekmesine gidin.

  2. Sol gezinti bölmesinde Azure Kaynakları'nı seçin.

  3. Tahmin kaynağı ekle düğmesini seçin.

    Add Prediction resource from portal

    Zaten bir tahmin kaynağınız varsa ekleyin. Aksi takdirde Yeni tahmin kaynağı oluştur'u seçin.

    Add Prediction resource from portal-2

Uç nokta URL'sini almak için uygulamayı yayımlama

Sohbet botunda veya diğer istemci uygulamalarında LUIS tahmini almak için uygulamayı tahmin uç noktasında yayımlamanız gerekir.

  1. Sağ üst gezinti bölmesinde Yayımla'yı seçin.

    A screenshot of the button for publishing to the endpoint.

  2. Üretim yuvasını ve ardından Bitti'yi seçin.

    A screenshot of LUIS publishing to the endpoint.

  3. Azure Kaynakları sayfasına gitmek için bildirimde Uç nokta URL'lerinize eriş'i seçin. URL'leri yalnızca uygulamayla ilişkilendirilmiş bir tahmin kaynağınız varsa görebilirsiniz. Yönet'e tıklayarak Azure Kaynakları sayfasını da bulabilirsiniz.

    A screenshot of a message showing the app has been published.

V3 API tahmin uç noktasını sorgulama

  1. LUIS portalında, Yönet bölümünde (sağ üst menü), Azure Kaynakları sayfasında (sol menü), Tahmin Kaynakları sekmesinde, sayfanın alt kısmındaki Örnek Sorgu'yu kopyalayın. URL'de uygulama kimliğiniz, anahtarınız ve yuva adınız bulunur. V3 tahmin uç noktası URL'si şu biçime sahiptir: https://YOUR-RESOURCE-NAME.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-PREDICTION-KEY&<optional-name-value-pairs>&query=YOUR_QUERY_HERE

    example query in the prediction resources section

    URL'yi yeni bir tarayıcı sekmesine yapıştırın. URL'yi görmüyorsanız bir tahmin kaynağınız yoktur ve bir tahmin kaynağı oluşturmanız gerekir.

  1. Tarayıcı adres çubuğundaki sorgu dizesi için URL'de aşağıdaki değerlerin olduğundan emin olun. Sorgu dizesinde yer almadıysa, bunları ekleyin:

    • verbose=true
    • show-all-intents=true
  2. Tarayıcı adres çubuğunda URL'nin sonuna gidin ve sorgu dizesi için oturma odası ışığını kapatın yazın ve Enter tuşuna basın.

    {
        "query": "turn off the living room light",
        "prediction": {
            "topIntent": "HomeAutomation.TurnOff",
            "intents": {
                "HomeAutomation.TurnOff": {
                    "score": 0.969448864
                },
                "HomeAutomation.QueryState": {
                    "score": 0.0122336326
                },
                "HomeAutomation.TurnUp": {
                    "score": 0.006547436
                },
                "HomeAutomation.TurnDown": {
                    "score": 0.0050634006
                },
                "HomeAutomation.SetDevice": {
                    "score": 0.004951761
                },
                "HomeAutomation.TurnOn": {
                    "score": 0.00312553928
                },
                "None": {
                    "score": 0.000552945654
                }
            },
            "entities": {
                "HomeAutomation.Location": [
                    "living room"
                ],
                "HomeAutomation.DeviceName": [
                    [
                        "living room light"
                    ]
                ],
                "HomeAutomation.DeviceType": [
                    [
                        "light"
                    ]
                ],
                "$instance": {
                    "HomeAutomation.Location": [
                        {
                            "type": "HomeAutomation.Location",
                            "text": "living room",
                            "startIndex": 13,
                            "length": 11,
                            "score": 0.902181149,
                            "modelTypeId": 1,
                            "modelType": "Entity Extractor",
                            "recognitionSources": [
                                "model"
                            ]
                        }
                    ],
                    "HomeAutomation.DeviceName": [
                        {
                            "type": "HomeAutomation.DeviceName",
                            "text": "living room light",
                            "startIndex": 13,
                            "length": 17,
                            "modelTypeId": 5,
                            "modelType": "List Entity Extractor",
                            "recognitionSources": [
                                "model"
                            ]
                        }
                    ],
                    "HomeAutomation.DeviceType": [
                        {
                            "type": "HomeAutomation.DeviceType",
                            "text": "light",
                            "startIndex": 25,
                            "length": 5,
                            "modelTypeId": 5,
                            "modelType": "List Entity Extractor",
                            "recognitionSources": [
                                "model"
                            ]
                        }
                    ]
                }
            }
        }
    }
    

Kaynakları temizleme

İhtiyacınız kalmadıysa LUIS uygulamasını silebilirsiniz. Bunun için sol üstteki menüden My apps (Uygulamalarım) öğesini seçin. Uygulama listesinde uygulama adının yanındaki üç noktayı (...) ve sonra da Delete (Sil) öğesini seçin. Açılan Delete app? (Uygulama silinsin mi?) iletişim kutusunda Ok (Tamam) öğesini seçin.

Sonraki adımlar