Sdílet prostřednictvím

Zastaralé kognitivní dovednosti ve službě Azure AI Search

  • Článek

Tento dokument popisuje kognitivní dovednosti, které jsou považovány za zastaralé (vyřazené). Pro obsah použijte následující příručku:

  • Název dovednosti: Název dovednosti, která bude zastaralá; mapuje se na @odata.type atribut.
  • Poslední dostupná verze rozhraní API: Poslední verze veřejného rozhraní API služby Azure AI Search, pomocí které se dají vytvořit nebo aktualizovat sady dovedností obsahující odpovídající zastaralé dovednosti. Indexery s připojenými sadami dovedností s těmito dovednostmi budou dál běžet i v budoucích verzích rozhraní API až do data ukončení podpory, kdy začnou selhávají.
  • Konec podpory: Den, po kterém je odpovídající dovednost považována za nepodporovanou a přestane fungovat. Dříve vytvořené sady dovedností by měly nadále fungovat, ale uživatelům se doporučuje migrovat z zastaralé dovednosti.
  • Doporučení: Postup migrace vpřed pro použití podporované dovednosti. Uživatelům doporučujeme postupovat podle doporučení, aby nadále dostávali podporu.

Pokud používáte Microsoft.Skills.Text.EntityRecognitionSkill (kognitivní dovednost rozpoznávání entit (v2)), pomůže vám tento článek upgradovat sadu dovedností tak, aby používala microsoft.Skills.Text.V3.EntityRecognitionSkill, která je obecně dostupná a zavádí nové funkce.

Pokud používáte Microsoft.Skills.Text.SentimentSkill (sentiment cognitive skill (v2)), pomůže vám tento článek upgradovat sadu dovedností tak, aby používala Microsoft.Skills.Text.V3.SentimentSkill, která je obecně dostupná a zavádí nové funkce.

Pokud používáte Microsoft.Skills.Text.NamedEntityRecognitionSkill (pojmenované kognitivní dovednosti rozpoznávání entit (v2)), pomůže vám tento článek upgradovat sadu dovedností tak, aby používala Microsoft.Skills.Text.V3.EntityRecognitionSkill, která je obecně dostupná a zavádí nové funkce.

Microsoft.Skills.Text.EntityRecognitionSkill

Poslední dostupná verze rozhraní API

2021-04-30-Preview

Ukončení podpory

sobota 31. srpna 2024

Doporučení

Místo toho použijte Microsoft.Skills.Text.V3.EntityRecognitionSkill. Poskytuje většinu funkcí entityRecognitionSkill ve vyšší kvalitě. Obsahuje také bohatší informace ve svých komplexních výstupních polích.

Pokud chcete migrovat na Microsoft.Skills.Text.V3.EntityRecognitionSkill, proveďte jednu nebo několik následujících změn definice dovednosti. Definici dovedností můžete aktualizovat pomocí rozhraní API pro aktualizaci sady dovedností.

  1. (Povinné)@odata.type Změňte z "#Microsoft.Skills.Text.EntityRecognitionSkill" na "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Volitelné) Parametr includeTypelessEntities se už nepodporuje, protože nová dovednost vrací pouze entity se známými typy, takže pokud na ni odkazuje předchozí definice dovednosti, měla by být nyní odebrána.

  3. (Volitelné) Pokud používáte namedEntities výstup, existuje několik menších změn názvů vlastností.

    1. value přejmenová se na text
    2. confidence přejmenová se na confidenceScore

    Pokud potřebujete vygenerovat přesně stejné názvy vlastností, přidejte ShaperSkill , aby se výstup přetvaroval požadovanými názvy. Například tento ShaperSkill přejmenuje vlastnosti na jejich staré hodnoty.

    {
    "@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"
        }
    ]
}

  4. (Volitelné) Pokud používáte entities výstup pro propojení entit s dobře známými entitami, tato funkce je teď novou dovedností Microsoft.Skills.Text.V3.EntityLinkingSkill. Přidejte dovednosti propojení entit se sadou dovedností a vygenerujte propojené entity. Existuje také několik drobných změn názvů entities vlastností výstupu mezi EntityRecognitionSkill a novým EntityLinkingSkill.

    1. wikipediaId přejmenová se na id
    2. wikipediaLanguage přejmenová se na language
    3. wikipediaUrl přejmenová se na url
    4. subtype Vlastnosti type se už nevrácejí.

    Pokud potřebujete vygenerovat přesně stejné názvy vlastností, přidejte ShaperSkill , aby se výstup přetvaroval požadovanými názvy. Například tento ShaperSkill přejmenuje vlastnosti na jejich staré hodnoty.

    {
    "@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"
        }
    ]
}

  5. (Volitelné) Pokud explicitně nezadáte categories, EntityRecognitionSkill V3 může vrátit jiný typ kategorií kromě těch, které byly podporovány .EntityRecognitionSkill Pokud je toto chování nežádoucí, nezapomeňte parametr explicitně nastavit categories na ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

    Ukázkové definice migrace

    • Jednoduchá migrace

      (Před) Definice dovednosti EntityRecognition

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

      (Za) Definice dovednosti EntityRecognition V3

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

    • Složitá migrace

      (Před) Definice dovednosti EntityRecognition

      {
    "@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"
        }
    ]
}

      (Za) Definice dovednosti EntityRecognition V3

      {
    "@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

Poslední dostupná verze rozhraní API

2021-04-30-Preview

Ukončení podpory

sobota 31. srpna 2024

Doporučení

Místo toho použijte Microsoft.Skills.Text.V3.SentimentSkill . Poskytuje vylepšený model a zahrnuje možnost přidat dolování názorů nebo mínění na základě aspektu. Vzhledem k tomu, že dovednost je výrazně složitější, výstupy jsou také velmi odlišné.

Pokud chcete migrovat na Microsoft.Skills.Text.V3.SentimentSkill, proveďte jednu nebo několik následujících změn definice dovednosti. Definici dovedností můžete aktualizovat pomocí rozhraní API pro aktualizaci sady dovedností.

Poznámka:

Výstupy dovedností pro dovednost mínění V3 nejsou kompatibilní s definicí indexu na základě sentimentSkill. Budete muset změnit definici indexu, sadu dovedností (pozdější vstupy dovedností nebo projekce úložiště znalostí) a mapování výstupních polí indexeru, které nahradí dovednosti mínění novou verzí.

  1. (Povinné)@odata.type Změňte z "#Microsoft.Skills.Text.SentimentSkill" na "#Microsoft.Skills.Text.V3.SentimentSkill".

  2. (Povinné) Dovednost mínění v3 poskytuje positive, neutrala negative skóre pro celkový text a stejné skóre pro každou větu v celkovém textu, zatímco předchozí SentimentSkill pouze poskytl jeden double, který se pohybuje od 0,0 (záporné) do 1,0 (kladné) pro celkový text. Budete muset aktualizovat definici indexu tak, aby přijímala tři dvojité hodnoty místo jednoho skóre, a ujistěte se, že všechny vstupy podřízených dovedností, projekce úložiště znalostí a mapování výstupních polí jsou konzistentní se změnami pojmenování.

Doporučujeme nahradit starý sentimentSkill zcela sentimentSkill V3, aktualizovat vstupy podřízených dovedností, projekce úložiště znalostí, mapování výstupních polí indexeru a definici indexu tak, aby odpovídaly novému výstupnímu formátu, a resetovat indexer tak, aby všechny dokumenty měly konzistentní výsledky mínění.

Poznámka:

Pokud potřebujete další pomoc s aktualizací kanálu rozšiřování tak, aby používal nejnovější verzi dovednosti mínění nebo pokud resetování indexeru není pro vás možnost, otevřete novou žádost o podporu, kde s vámi můžeme pracovat přímo.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Poslední dostupná verze rozhraní API

2017-11-11-Preview

Ukončení podpory

sobota 31. srpna 2024

Doporučení

Místo toho použijte Microsoft.Skills.Text.V3.EntityRecognitionSkill. Poskytuje většinu funkcí PojmenovanéEntityRecognitionSkill ve vyšší kvalitě. Obsahuje také bohatší informace ve svých komplexních výstupních polích.

Pokud chcete migrovat na Microsoft.Skills.Text.V3.EntityRecognitionSkill, proveďte jednu nebo několik následujících změn definice dovednosti. Definici dovedností můžete aktualizovat pomocí rozhraní API pro aktualizaci sady dovedností.

  1. (Povinné)@odata.type Změňte z "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" na "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Volitelné) Pokud používáte entities výstup, použijte namedEntities místo toho složitý výstup EntityRecognitionSkill V3 kolekce. V názvech vlastností nového namedEntities komplexního výstupu došlo k několika drobným změnám:

    1. value přejmenová se na text
    2. confidence přejmenová se na confidenceScore

    Pokud potřebujete vygenerovat přesně stejné názvy vlastností, přidejte ShaperSkill , aby se výstup přetvaroval požadovanými názvy. Například tento ShaperSkill přejmenuje vlastnosti na jejich staré hodnoty.

    {
    "@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"
        }
    ]
}

  3. (Volitelné) Pokud explicitně nezadáte categories, EntityRecognitionSkill V3 může vrátit jiný typ kategorií kromě těch, které byly podporovány .NamedEntityRecognitionSkill Pokud je toto chování nežádoucí, nezapomeňte parametr explicitně nastavit categories na ["Person", "Location", "Organization"].

    Ukázkové definice migrace

    • Jednoduchá migrace

      (Před) Definice dovednosti NamedEntityRecognition

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

      (Za) Definice dovednosti EntityRecognition V3

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

    • Mírně složitá migrace

      (Před) Definice dovednosti NamedEntityRecognition

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

      (Za) Definice dovednosti EntityRecognition V3

      {
    "@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"
        }
    ]
}

Viz také