Varlık Bağlama bilişsel becerisi (v3)

  • Makale

Varlık Bağlama becerisi (v3), iyi bilinen bir bilgi bankası (Wikipedia) içindeki makalelere bağlantılar içeren tanınan varlıkların listesini döndürür.

Dekont

Bu beceri, Azure AI Dili'ndekiVarlık Bağlama makine öğrenmesi modellerine bağlıdır ve dizin oluşturucu başına günde 20 belgeyi aşan işlemler için faturalanabilir bir kaynak gerektirir. Yerleşik becerilerin yürütülmesi, mevcut Azure AI hizmetlerinin kullandıkça öde fiyatından ücretlendirilir.

@odata.type

Microsoft.Skills.Text.V3.EntityLinkingSkill

Veri sınırları

Kaydın boyut üst sınırı, tarafından String.Lengthölçülen 50.000 karakter olmalıdır. Verilerinizi EntityLinking becerisine göndermeden önce bölmeniz gerekiyorsa Metin Bölme becerisini kullanmayı göz önünde bulundurun. Metin bölme becerisi kullanıyorsanız en iyi performans için sayfa uzunluğunu 5000 olarak ayarlayın.

Beceri parametreleri

Parametre adları büyük/küçük harfe duyarlıdır ve tümü isteğe bağlıdır.

Parametre adı Tanım
defaultLanguageCode Giriş metninin dil kodu. Varsayılan dil kodu belirtilmezse, varsayılan dil kodu olarak İngilizce (en) kullanılır.
Desteklenen dillerin tam listesini görün.
minimumPrecision 0 ile 1 arasında bir değer. Güvenilirlik puanı (çıktıda entities ) bu değerden düşükse varlık döndürülmedi. Varsayılan değer 0’dır.
modelVersion (İsteğe bağlı) Varlık bağlamayı çağırırken kullanılacak modelin sürümünü belirtir. Belirtilmediğinde varsayılan olarak en son kullanılabilir duruma gelecek. Gerekli olmadığı sürece bu değeri belirtmemenizi öneririz.

Beceri girişleri

Giriş adı Tanım
languageCode Kayıtların dilini gösteren dize. Bu parametre belirtilmezse, kayıtları çözümlemek için varsayılan dil kodu kullanılır.
Desteklenen dillerin tam listesini görün.
text Analiz için metin.

Beceri çıkışları

Çıkış adı Tanım
entities Aşağıdaki alanları içeren karmaşık tür dizisi:
  • "name" (Metinde göründüğü gibi gerçek varlık adı)
  • "id"
  • "language" (Beceri tarafından belirlenen metnin dili)
  • "url" (Bu varlığa bağlı URL)
  • "bingId" (Bu bağlantılı varlığın bingId değeri)
  • "dataSource" (URL ile ilişkili veri kaynağı)
  • "matches"(Şu karmaşık türlerden oluşan bir dizi: text, offsetlength ve confidenceScore)

Örnek tanım

  {
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
    "context": "/document",
    "defaultLanguageCode": "en", 
    "minimumPrecision": 0.5, 
    "inputs": [
        {
            "name": "text", 
            "source": "/document/content"
        },
        {
            "name": "languageCode", 
            "source": "/document/language"
        }
    ],
    "outputs": [
        {
            "name": "entities", 
            "targetName": "entities" 
        }
    ]
}

Örnek girdi

{
    "values": [
      {
        "recordId": "1",
        "data":
           {
             "text": "Microsoft is liked by many.",
             "languageCode": "en"
           }
      }
    ]
}

Örnek çıktı

{
  "values": [
    {
      "recordId": "1",
      "data" : 
      {
        "entities": [
          {
            "name": "Microsoft", 
            "id": "Microsoft",
            "language": "en", 
            "url": "https://en.wikipedia.org/wiki/Microsoft", 
            "bingId": "a093e9b9-90f5-a3d5-c4b8-5855e1b01f85", 
            "dataSource": "Wikipedia", 
            "matches": [
                {
                    "text": "Microsoft", 
                    "offset": 0, 
                    "length": 9, 
                    "confidenceScore": 0.13 
                }
            ]
          }
        ],
      }
    }
  ]
}

Bu becerinin çıkışındaki varlıklar için döndürülen uzaklıklar, Dil Hizmeti API'lerinden doğrudan döndürülür; yani bunları özgün dizeye dizin oluşturmak için kullanıyorsanız, doğru içeriği ayıklamak için .NET'te StringInfo sınıfını kullanmanız gerekir. Daha fazla bilgi için bkz . Dil hizmeti özelliklerinde çok dilli ve emoji desteği.

Uyarı durumları

Belgenin dil kodu desteklenmiyorsa, bir uyarı döndürülür ve hiçbir varlık ayıklanmazsa.

Ayrıca bkz.