Zastaralé kognitivní dovednosti ve službě Azure AI Vyhledávač

Poznámka:

Azure AI Vyhledávač je k dispozici prostřednictvím portálu Azure, rozhraní REST API a Sady Azure SDK. Podporuje také Foundry IQ, spravovanou znalostní vrstvu, která transformuje podnikový obsah na opakovaně použitelné znalostní báze s podporou oprávnění pro agenty na portálu Microsoft Foundry.

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 vyřazena; mapuje se na @odata.type atribut.
Poslední dostupná verze rozhraní API: Poslední verze veřejného rozhraní API služby Azure AI Vyhledávač, pomocí které se dají vytvořit nebo aktualizovat sady dovedností obsahující odpovídající zastaralou dovednost. 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í: Cesta migrace 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í.

(Povinné)@odata.type Změňte z "#Microsoft.Skills.Text.EntityRecognitionSkill" na "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".
(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.

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

value přejmenová se na text
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"
        }
    ]
}

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

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

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

(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 analýzy sentimentu V3 nejsou kompatibilní s definicí indexu na základě SentimentSkill. Je nutné provést změny definice indexu, sady dovedností (pozdější vstupy dovedností a/nebo projekce úložiště znalostí) a mapování výstupních polí indexeru, které nahradí dovednosti mínění novou verzí.

(Povinné)@odata.type Změňte z "#Microsoft.Skills.Text.SentimentSkill" na "#Microsoft.Skills.Text.V3.SentimentSkill".
(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. Definici indexu je nutné aktualizovat 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í obohacovacího kanálu, aby používal nejnovější verzi analýzy sentimentu, nebo pokud pro vás není možnost resetovat indexer, otevřete novou žádost o podporu, kde s vámi můžeme pracovat přímo.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Poslední dostupná verze rozhraní API

11. 11. 2017 – 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.

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

(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:

value přejmenová se na text
confidence přejmenová se na 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"
        }
    ]
}

(Volitelné) Pokud explicitně nezadáte categories, EntityRecognitionSkill V3 může vrátit jiný typ kategorie kromě těch, které podporuje .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é

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-07-03

Zastaralé kognitivní dovednosti ve službě Azure AI Vyhledávač

Microsoft.Skills.Text.EntityRecognitionSkill

Poslední dostupná verze rozhraní API

Ukončení podpory

Doporučení

Microsoft.Skills.Text.SentimentSkill

Poslední dostupná verze rozhraní API

Ukončení podpory

Doporučení

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Poslední dostupná verze rozhraní API

Ukončení podpory

Doporučení

Viz také

Váš názor

Další materiály