Azure AI Search'te Kullanım Dışı Bilişsel Beceriler

Makale
09/01/2024

Bu belgede kullanım dışı (kullanımdan kaldırıldı) olarak kabul edilen bilişsel beceriler açıklanmaktadır. İçerikler için aşağıdaki kılavuzu kullanın:

Beceri Adı: Kullanım dışı bırakılacak becerinin adı; özniteliğine eşler @odata.type .
Son kullanılabilir api sürümü: Azure AI Search genel API'sinin ilgili kullanım dışı beceriyi içeren beceri kümelerinin oluşturulabileceği/güncelleştirilebileceği son sürümü. Bu becerilere sahip ekli beceri kümelerine sahip dizin oluşturucular, "Destek sonu" tarihine kadar gelecekteki API sürümlerinde bile çalışmaya devam eder ve bu noktada başarısız olurlar.
Destek sonu: İlgili becerinin desteklenmeyen olarak kabul edildiği ve çalışmayı durdurdığı gün. Daha önce oluşturulan beceri kümelerinin çalışmaya devam etmesi gerekir, ancak kullanıcıların kullanım dışı bırakılmış bir beceriden uzaklaşması önerilir.
Öneriler: Desteklenen bir beceriyi kullanmak için ileriye doğru geçiş yolu. Kullanıcıların destek almaya devam etmek için önerileri izlemeleri tavsiye edilir.

Microsoft.Skills.Text.EntityRecognitionSkill (Varlık Tanıma bilişsel becerisi (v2)) kullanıyorsanız, bu makale genel kullanıma sunulan ve yeni özellikler sunan Microsoft.Skills.Text.V3.EntityRecognitionSkill'i kullanmak için beceri kümenizi yükseltmenize yardımcı olur.

Microsoft.Skills.Text.SentimentSkill (Yaklaşım bilişsel becerisi (v2)) kullanıyorsanız, bu makale beceri kümenizi genel kullanıma sunulan ve yeni özellikler sunan Microsoft.Skills.Text.V3.SentimentSkill'i kullanacak şekilde yükseltmenize yardımcı olur.

Microsoft.Skills.Text.NamedEntityRecognitionSkill (Adlandırılmış Varlık Tanıma bilişsel becerisi (v2)) kullanıyorsanız, bu makale beceri kümenizi genel kullanıma sunulan ve yeni özellikler sunan Microsoft.Skills.Text.V3.EntityRecognitionSkill'i kullanacak şekilde yükseltmenize yardımcı olur.

Microsoft.Skills.Text.EntityRecognitionSkill

Son kullanılabilir API sürümü

2021-04-30-Önizleme

Destek sonu

31 Ağustos 2024 Cumartesi

Öneriler

Bunun yerine Microsoft.Skills.Text.V3.EntityRecognitionSkill kullanın. EntityRecognitionSkill işlevinin çoğunu daha yüksek kalitede sağlar. Ayrıca karmaşık çıkış alanlarında daha zengin bilgilere sahiptir.

Microsoft.Skills.Text.V3.EntityRecognitionSkill'e geçiş yapmak için beceri tanımınızda aşağıdaki değişikliklerden birini veya daha fazlasını yapın. Beceri tanımını Güncelleştirme Beceri Kümesi API'sini kullanarak güncelleştirebilirsiniz.

(Gerekli) öğesini olarak @odata.type "#Microsoft.Skills.Text.EntityRecognitionSkill" "#Microsoft.Skills.Text.V3.EntityRecognitionSkill"değiştirin.
(İsteğe bağlı) includeTypelessEntities Yeni beceri yalnızca bilinen türlerdeki varlıkları döndürdüğünden parametresi artık desteklenmemektedir, bu nedenle önceki beceri tanımınız başvuruda bulunduysa, artık kaldırılmalıdır.

(İsteğe bağlı) Çıktıyı namedEntities kullanıyorsanız, özellik adlarına birkaç küçük değişiklik yapılır.

value olarak yeniden adlandırıldı text
confidence olarak yeniden adlandırıldı confidenceScore

Tam olarak aynı özellik adlarını oluşturmanız gerekiyorsa, çıkışı gerekli adlarla yeniden şekillendirmek için bir ShaperSkill ekleyin. Örneğin, bu ShaperSkill özellikleri eski değerleriyle yeniden adlandırır.

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntitiesV3/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntitiesV3/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntitiesV3/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntitiesV3/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntitiesV3/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "namedEntities"
        }
    ]
}

(İsteğe bağlı) Varlıkları iyi bilinen varlıklara bağlamak için çıkışı kullanıyorsanız entities , bu özellik artık yeni bir beceri olan Microsoft.Skills.Text.V3.EntityLinkingSkill özelliğidir. Bağlı varlıkları oluşturmak için beceri kümesine varlık bağlama becerisini ekleyin. ve yeni EntityLinkingSkillarasında EntityRecognitionSkill çıkışın entities özellik adlarına birkaç küçük değişiklik de yapılır.

wikipediaId olarak yeniden adlandırıldı id
wikipediaLanguage olarak yeniden adlandırıldı language
wikipediaUrl olarak yeniden adlandırıldı url
type ve subtype özellikleri artık döndürülmüyor.

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "LinkedEntitiesShaper",
    "description": "LinkedEntitiesShaper",
    "context": "/document/linkedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/linkedEntitiesV3/*",
            "inputs": [
                {
                    "name": "name",
                    "source": "/document/linkedEntitiesV3/*/name"
                },
                {
                    "name": "wikipediaId",
                    "source": "/document/linkedEntitiesV3/*/id"
                },
                {
                    "name": "wikipediaLanguage",
                    "source": "/document/linkedEntitiesV3/*/language"
                },
                {
                    "name": "wikipediaUrl",
                    "source": "/document/linkedEntitiesV3/*/url"
                },
                {
                    "name": "bingId",
                    "source": "/document/linkedEntitiesV3/*/bingId"
                },
                {
                    "name": "matches",
                    "source": "/document/linkedEntitiesV3/*/matches"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

(İsteğe bağlı) açıkça belirtmezseniz categories, EntityRecognitionSkill V3 tarafından EntityRecognitionSkilldesteklenen kategorilerin yanı sıra farklı türde kategoriler döndürebilir. Bu davranış istenmeyen bir davranışsa parametresini açıkça olarak ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"]olarak ayarladığınızdan categories emin olun.

Örnek Geçiş Tanımları

Basit geçiş

(Önce) EntityRecognition beceri tanımı

{   
    "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

(Sonra) EntityRecognition beceri V3 tanımı

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

Karmaşık geçiş

(Önce) EntityRecognition beceri tanımı

{
    "@odata.type": "#Microsoft.Skills.Text.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "includeTypelessEntities": true,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities",
            "targetName": "namedEntities"
        },
        {
            "name": "entities",
            "targetName": "entities"
        }
    ]
}

(Sonra) EntityRecognition beceri V3 tanımı

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities",
            "targetName": "namedEntitiesV3"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntitiesV3/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntitiesV3/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntitiesV3/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntitiesV3/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntitiesV3/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "namedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityLinkingSkill",
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "entities",
            "targetName": "linkedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "LinkedEntitiesShaper",
    "description": "LinkedEntitiesShaper",
    "context": "/document/linkedEntitiesV3",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/linkedEntitiesV3/*",
            "inputs": [
                {
                    "name": "name",
                    "source": "/document/linkedEntitiesV3/*/name"
                },
                {
                    "name": "wikipediaId",
                    "source": "/document/linkedEntitiesV3/*/id"
                },
                {
                    "name": "wikipediaLanguage",
                    "source": "/document/linkedEntitiesV3/*/language"
                },
                {
                    "name": "wikipediaUrl",
                    "source": "/document/linkedEntitiesV3/*/url"
                },
                {
                    "name": "bingId",
                    "source": "/document/linkedEntitiesV3/*/bingId"
                },
                {
                    "name": "matches",
                    "source": "/document/linkedEntitiesV3/*/matches"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

Microsoft.Skills.Text.SentimentSkill

Son kullanılabilir API sürümü

2021-04-30-Önizleme

Destek sonu

31 Ağustos 2024 Cumartesi

Öneriler

Bunun yerine Microsoft.Skills.Text.V3.SentimentSkill kullanın. Geliştirilmiş bir model sağlar ve fikir madenciliği veya en boy tabanlı yaklaşım ekleme seçeneğini içerir. Beceri önemli ölçüde daha karmaşık olduğundan çıkışlar da çok farklıdır.

Microsoft.Skills.Text.V3.SentimentSkill'e geçiş yapmak için beceri tanımınızda aşağıdaki değişikliklerden birini veya daha fazlasını yapın. Beceri tanımını Güncelleştirme Beceri Kümesi API'sini kullanarak güncelleştirebilirsiniz.

Not

Yaklaşım Becerisi V3'e yönelik beceri çıkışları SentimentSkill'i temel alan dizin tanımıyla uyumlu değildir. Yaklaşım becerisini yeni sürümle değiştirmek için dizin tanımında, beceri kümesinde (sonraki beceri girişleri ve/veya bilgi deposu projeksiyonları) ve dizin oluşturucu çıktı alanı eşlemelerinde değişiklik yapmanız gerekir.

(Gerekli) öğesini olarak @odata.type "#Microsoft.Skills.Text.SentimentSkill" "#Microsoft.Skills.Text.V3.SentimentSkill"değiştirin.
(Gerekli) Yaklaşım Becerisi V3, genel metin için bir positive, neutralve negative puanı ve genel metindeki her tümce için aynı puanları sağlarken, önceki SentimentSkill yalnızca genel metin için 0,0 (negatif) ile 1,0 (pozitif) arasında değişen tek bir çift değer sağlar. Dizin tanımınızı tek bir puan yerine üç çift değeri kabul edecek şekilde güncelleştirmeniz ve tüm aşağı akış beceri girişlerinizin, bilgi deposu projeksiyonlarınızın ve çıkış alanı eşlemelerinizin adlandırma değişiklikleriyle tutarlı olduğundan emin olmanız gerekir.

Eski SentimentSkill değerini Tamamen SentimentSkill V3 ile değiştirmeniz, aşağı akış beceri girişlerinizi, bilgi deposu projeksiyonlarınızı, dizin oluşturucu çıkış alanı eşlemelerinizi ve dizin tanımınızı yeni çıkış biçimiyle eşleşecek şekilde güncelleştirmeniz ve tüm belgelerinizin tutarlı yaklaşım sonuçlarına sahip olması için dizin oluşturucunuzu sıfırlamanız önerilir.

Not

Yaklaşım becerisinin en son sürümünü kullanmak için zenginleştirme işlem hattınızı güncelleştirmek için ek yardıma ihtiyacınız varsa veya dizin oluşturucunuzu sıfırlamak sizin için bir seçenek değilse, lütfen sizinle doğrudan çalışabileceğiniz yeni bir destek isteği açın.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Son kullanılabilir API sürümü

2017-11-11-Önizleme

Destek sonu

31 Ağustos 2024 Cumartesi

Öneriler

Bunun yerine Microsoft.Skills.Text.V3.EntityRecognitionSkill kullanın. NamedEntityRecognitionSkill işlevinin çoğunu daha yüksek kalitede sağlar. Ayrıca karmaşık çıkış alanlarında daha zengin bilgilere sahiptir.

(Gerekli) öğesini olarak @odata.type "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" "#Microsoft.Skills.Text.V3.EntityRecognitionSkill"değiştirin.

(İsteğe bağlı) Çıktıyı entities kullanıyorsanız, bunun yerine'den karmaşık koleksiyon çıkışını EntityRecognitionSkill V3 kullanınnamedEntities. Yeni namedEntities karmaşık çıkışın özellik adlarına birkaç küçük değişiklik yapılır:

value olarak yeniden adlandırıldı text
confidence olarak yeniden adlandırıldı confidenceScore

{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntities",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntities/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntities/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntities/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntities/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntities/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

(İsteğe bağlı) açıkça belirtmezseniz categories, EntityRecognitionSkill V3 tarafından NamedEntityRecognitionSkilldesteklenen kategorilerin yanı sıra farklı türde kategoriler döndürebilir. Bu davranış istenmeyen bir davranışsa parametresini açıkça olarak ["Person", "Location", "Organization"]olarak ayarladığınızdan categories emin olun.

Örnek Geçiş Tanımları

Basit geçiş

(Önce) NamedEntityRecognition beceri tanımı

{
    "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

(Sonra) EntityRecognition beceri V3 tanımı

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person" ],
    "defaultLanguageCode": "en",
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        }
    ]
}

Biraz karmaşık geçiş

(Önce) NamedEntityRecognition beceri tanımı

{
    "@odata.type": "#Microsoft.Skills.Text.NamedEntityRecognitionSkill",
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "entities"
        }
    ]
}

(Sonra) EntityRecognition beceri V3 tanımı

{
    "@odata.type": "#Microsoft.Skills.Text.V3.EntityRecognitionSkill",
    "categories": [ "Person", "Location", "Organization" ],
    "defaultLanguageCode": "en",
    "minimumPrecision": 0.1,
    "inputs": [
        {
            "name": "text",
            "source": "/document/content"
        }
    ],
    "outputs": [
        {
            "name": "persons",
            "targetName": "people"
        },
        {
            "name": "namedEntities"
        }
    ]
},
{
    "@odata.type": "#Microsoft.Skills.Util.ShaperSkill",
    "name": "NamedEntitiesShaper",
    "description": "NamedEntitiesShaper",
    "context": "/document/namedEntities",
    "inputs": [
        {
            "name": "old_format",
            "sourceContext": "/document/namedEntities/*",
            "inputs": [
                {
                    "name": "value",
                    "source": "/document/namedEntities/*/text"
                },
                {
                    "name": "offset",
                    "source": "/document/namedEntities/*/offset"
                },
                {
                    "name": "category",
                    "source": "/document/namedEntities/*/category"
                },
                {
                    "name": "confidence",
                    "source": "/document/namedEntities/*/confidenceScore"
                }
            ]
        }
    ],
    "outputs": [
        {
            "name": "output",
            "targetName": "entities"
        }
    ]
}

Aracılığıyla paylaş

Azure AI Search'te Kullanım Dışı Bilişsel Beceriler

Microsoft.Skills.Text.EntityRecognitionSkill

Son kullanılabilir API sürümü

Destek sonu

Öneriler

Microsoft.Skills.Text.SentimentSkill

Son kullanılabilir API sürümü

Destek sonu

Öneriler

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Son kullanılabilir API sürümü

Destek sonu

Öneriler

Ayrıca bkz.

Geri Bildirim

Ek kaynaklar