Amaçlar ve varlıklarla konuşma metninden veri ayıklama

Ö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.

LUIS, bir kullanıcının doğal dil konuşmalarından bilgi alma olanağı sunar. Bilgiler bir program, uygulama veya sohbet botu tarafından eyleme geçmek için kullanılabilecek şekilde ayıklanır. Aşağıdaki bölümlerde JSON örnekleriyle amaçlardan ve varlıklardan hangi verilerin döndürülür öğrenebilirsiniz.

Ayıklanması en zor veri, tam metin eşleşmesi olmadığından makine öğrenmesi verileridir. Makine öğrenmesi varlıklarının veri ayıklaması, beklediğiniz verileri aldığınızdan emin olana kadar yazma döngüsünün parçası olmalıdır.

Veri konumu ve anahtar kullanımı

LUIS, kullanıcının yayımlanan uç noktadaki konuşmasından verileri ayıklar. HTTPS isteği (POST veya GET), konuşmanın yanı sıra hazırlama veya üretim ortamları gibi bazı isteğe bağlı yapılandırmaları içerir.

V2 tahmin uç noktası isteği

https://westus.api.cognitive.microsoft.com/luis/v2.0/apps/<appID>?subscription-key=<subscription-key>&verbose=true&timezoneOffset=0&q=book 2 tickets to paris

V3 tahmin uç noktası isteği

https://westus.api.cognitive.microsoft.com/luis/v3.0-preview/apps/<appID>/slots/<slot-type>/predict?subscription-key=<subscription-key>&verbose=true&timezoneOffset=0&query=book 2 tickets to paris

appID, LUIS uygulamanızı düzenlerken HEM LUIS uygulamanızın Ayarlar sayfasında hem de URL'nin (sonrasında/apps/) bir parçası olarak kullanılabilir. subscription-key, uygulamanızı sorgulamak için kullanılan uç nokta anahtarıdır. LUIS'i öğrenirken ücretsiz yazma/başlangıç anahtarınızı kullanabilirsiniz ancak uç nokta anahtarını beklenen LUIS kullanımınızı destekleyen bir anahtarla değiştirmek önemlidir. Ünite timezoneOffset dakika cinsindendir.

HTTPS yanıtı, LUIS'in hazırlama veya üretim uç noktasının geçerli yayımlanan modeline göre belirleyebileceği tüm amacı ve varlık bilgilerini içerir. Uç nokta URL'si LUIS web sitesinde, Yönet bölümünde, Anahtarlar ve uç noktalar sayfasında bulunur.

Amaçlardan alınan veriler

Birincil veriler en iyi puanlama amacı adıdır. Uç nokta yanıtı:

{
  "query": "when do you open next?",
  "topScoringIntent": {
    "intent": "GetStoreInfo",
    "score": 0.984749258
  },
  "entities": []
}
Veri Nesnesi Veri Türü Veri Konumu Değer
Amaç String topScoringIntent.intent "GetStoreInfo"

Sohbet botunuz veya LUIS arama uygulamanız birden fazla amaç puanını temel alan bir karar verirse, tüm amaçların puanlarını döndürür.

querystring parametresini verbose=trueayarlayın. Uç nokta yanıtı:

{
  "query": "when do you open next?",
  "topScoringIntent": {
    "intent": "GetStoreInfo",
    "score": 0.984749258
  },
  "intents": [
    {
      "intent": "GetStoreInfo",
      "score": 0.984749258
    },
    {
      "intent": "None",
      "score": 0.2040639
    }
  ],
  "entities": []
}

Amaçlar en yüksekten en düşük puana doğru sıralanır.

Veri Nesnesi Veri Türü Veri Konumu Değer Puan
Amaç String intents[0].intent "GetStoreInfo" 0.984749258
Amaç String intents[1].intent "Yok" 0.0168218873

Önceden oluşturulmuş etki alanları eklerseniz amaç adı, veya Communication gibi Utilties etki alanını ve amacı gösterir:

{
  "query": "Turn on the lights next monday at 9am",
  "topScoringIntent": {
    "intent": "Utilities.ShowNext",
    "score": 0.07842206
  },
  "intents": [
    {
      "intent": "Utilities.ShowNext",
      "score": 0.07842206
    },
    {
      "intent": "Communication.StartOver",
      "score": 0.0239675418
    },
    {
      "intent": "None",
      "score": 0.0168218873
    }],
  "entities": []
}
Domain Veri Nesnesi Veri Türü Veri Konumu Değer
Yardımcı Programlar Amaç String intents[0].intent "Yardımcı programlar. ShowNext"
İletişim Amaç String intents[1].intent İletişim. StartOver"
Amaç String intents[2].intent "Yok"

Varlıklardan alınan veriler

Sohbet botlarının ve uygulamaların çoğu amaç adından daha fazlasına ihtiyaç duyar. Bu ek isteğe bağlı veriler, konuşmada bulunan varlıklardan gelir. Her varlık türü eşleşme hakkında farklı bilgiler döndürür.

Bir konuşmadaki tek bir sözcük veya tümcecik birden fazla varlıkla eşleşebilir. Bu durumda, eşleşen her varlık kendi puanıyla döndürülür.

Tüm varlıklar, uç noktadan yanıtın varlıklar dizisinde döndürülür

Belirteçli varlık döndürüldü

LUIS'de belirteç desteğini gözden geçirin.

Önceden oluşturulmuş varlık verileri

Önceden oluşturulmuş varlıklar, açık kaynak Recognizers-Text projesi kullanılarak normal ifade eşleşmesi temelinde bulunur. Önceden oluşturulmuş varlıklar varlıklar dizisinde döndürülür ve ön ekli builtin::tür adını kullanır.

Varlık verilerini listeleme

Liste varlıkları , eş anlamlılarıyla birlikte sabit, kapalı bir ilişkili sözcük kümesini temsil eder. LUIS, liste varlıkları için ek değerler bulmaz. Geçerli listeye göre yeni sözcüklerle ilgili önerileri görmek için Öner özelliğini kullanın. Aynı değere sahip birden fazla liste varlığı varsa, her varlık uç nokta sorgusunda döndürülür.

Normal ifade varlık verileri

Normal ifade varlığı , sağladığınız normal ifadeyi temel alan bir varlığı ayıklar.

Adları ayıklama

Bir ifadeden ad almak zordur çünkü bir ad harf ve sözcüklerin hemen hemen her birleşimi olabilir. Ayıkladığınız ad türüne bağlı olarak, çeşitli seçenekleriniz vardır. Aşağıdaki öneriler kural değil, daha fazla yönergedir.

Önceden oluşturulmuş PersonName ve GeographyV2 varlıkları ekleme

PersonName ve GeographyV2 varlıkları bazı dil kültürlerinde kullanılabilir.

Kişi adları

Kişiler adı, dile ve kültüre bağlı olarak biraz biçime sahip olabilir. Önceden oluşturulmuş bir personName varlığı veya ad ve soyadı rollerine sahip basit bir varlık kullanın.

Basit varlığı kullanıyorsanız, ifadenin farklı bölümlerinde, farklı uzunluklardaki konuşmalarda ve Hiçbiri amacı dahil olmak üzere tüm amaçlarda konuşmalarda ad ve soyadını kullanan örnekler verdiğinizden emin olun. Doğru tahmin edilmeyen adları etiketlemek için uç nokta ifadelerini düzenli aralıklarla gözden geçirin .

Yer adları

Konum adları şehirler, ilçeler, eyaletler, iller ve ülkeler/bölgeler gibi ayarlanır ve bilinir. Konum bilgilerini ayıklamak için önceden oluşturulmuş geographyV2 varlığını kullanın.

Yeni ve gelişmekte olan adlar

Bazı uygulamaların ürünler veya şirketler gibi yeni ve gelişmekte olan adları bulabilmesi gerekir. Bu tür adlar en zor veri ayıklama türüdür. Basit bir varlıkla başlayın ve bir tümcecik listesi ekleyin. Doğru tahmin edilmeyen adları etiketlemek için uç nokta ifadelerini düzenli aralıklarla gözden geçirin .

Pattern.any varlık verileri

Pattern.any , varlığın başladığı ve bittiği yeri işaretlemek için yalnızca desenin şablon konuşmasında kullanılan değişken uzunlukta bir yer tutucudur. Desenin uygulanabilmesi için desende kullanılan varlığın bulunması gerekir.

Duygu analizi

Yayımlama sırasında yaklaşım analizi yapılandırılırsa LUIS json yanıtı yaklaşım analizini içerir. Dil hizmeti belgelerinde yaklaşım analizi hakkında daha fazla bilgi edinin.

Anahtar ifade ayıklama varlık verileri

Anahtar tümcecik ayıklama varlığı, Dil hizmeti tarafından sağlanan konuşmadaki anahtar ifadeleri döndürür.

Birden çok varlıkla eşleşen veri

LUIS, konuşmada bulunan tüm varlıkları döndürür. Sonuç olarak, sohbet botunuzun sonuçlara göre bir karar vermesi gerekebilir.

Birden çok liste varlığıyla eşleşen veriler

Bir sözcük veya tümcecik birden fazla liste varlığıyla eşleşiyorsa uç nokta sorgusu her Liste varlığını döndürür.

sorgusu when is the best time to go to red rock?için ve uygulamanın sözcüğü red birden çok listede yer alır, LUIS tüm varlıkları tanır ve JSON uç nokta yanıtının bir parçası olarak bir varlık dizisi döndürür.

Sonraki adımlar

LUIS uygulamanıza varlık ekleme hakkında daha fazla bilgi edinmek için bkz. Varlık ekleme.