Udostępnij za pośrednictwem

Przestarzałe umiejętności poznawcze w usłudze Azure AI Search

  • Artykuł

W tym dokumencie opisano umiejętności poznawcze, które są uznawane za przestarzałe (wycofane). Skorzystaj z następującego przewodnika dotyczącego zawartości:

  • Nazwa umiejętności: nazwa umiejętności, która będzie przestarzała; mapuje na @odata.type atrybut .
  • Ostatnia dostępna wersja interfejsu API: ostatnia wersja publicznego interfejsu API usługi Azure AI Search, za pomocą którego można utworzyć/zaktualizować zestawy umiejętności zawierające odpowiednie przestarzałe umiejętności. Indeksatory z dołączonymi zestawami umiejętności z tymi umiejętnościami będą nadal działać nawet w przyszłych wersjach interfejsu API do daty zakończenia wsparcia technicznego, w którym momencie zaczynają kończyć się niepowodzeniem.
  • Koniec wsparcia: dzień, po którym odpowiednie umiejętności są uznawane za nieobsługiwane i przestaną działać. Wcześniej utworzone zestawy umiejętności powinny nadal działać, ale zaleca się migrowanie użytkowników z dala od przestarzałej umiejętności.
  • Zalecenia: ścieżka migracji do przodu, aby użyć obsługiwanej umiejętności. Użytkownicy powinni postępować zgodnie z zaleceniami, aby nadal otrzymywać pomoc techniczną.

Jeśli używasz zestawu umiejętności Microsoft.Skills.Text.EntityRecognitionSkill (umiejętności poznawcze rozpoznawania jednostek (wersja 2),ten artykuł ułatwia podwyższenie poziomu umiejętności w celu korzystania z zestawu umiejętności Microsoft.Skills.Text.V3.EntityRecognitionSkill, który jest ogólnie dostępny i wprowadza nowe funkcje.

Jeśli używasz zestawu umiejętności Microsoft.Skills.Text.SentimentSkill (umiejętność poznawcza tonacji (wersja 2),ten artykuł ułatwia uaktualnienie zestawu umiejętności w celu korzystania z biblioteki Microsoft.Skills.Text.V3.SentimentSkill, która jest ogólnie dostępna i wprowadza nowe funkcje.

Jeśli używasz umiejętności Microsoft.Skills.Text.NamedEntityRecognitionSkill (nazwane umiejętności poznawcze rozpoznawania jednostek (wersja 2)), ten artykuł ułatwia uaktualnienie zestawu umiejętności w celu korzystania z biblioteki Microsoft.Skills.Text.V3.EntityRecognitionSkill , która jest ogólnie dostępna i wprowadza nowe funkcje.

Microsoft.Skills.Text.EntityRecognitionSkill

Ostatnia dostępna wersja interfejsu API

2021-04-30-Preview

Koniec wsparcia

sobota, 31 sierpnia 2024 r.

Zalecenia

Zamiast tego użyj polecenia Microsoft.Skills.Text.V3.EntityRecognitionSkill . Zapewnia większość funkcji entityRecognitionSkill w wyższej jakości. Zawiera również bogatsze informacje w swoich złożonych polach wyjściowych.

Aby przeprowadzić migrację do biblioteki Microsoft.Skills.Text.V3.EntityRecognitionSkill, wprowadź co najmniej jedną z poniższych zmian w definicji umiejętności. Definicję umiejętności można zaktualizować przy użyciu interfejsu API aktualizacji zestawu umiejętności.

  1. (Wymagane) Zmień wartość z "#Microsoft.Skills.Text.EntityRecognitionSkill" na "#Microsoft.Skills.Text.V3.EntityRecognitionSkill"@odata.type .

  2. (Opcjonalnie) Parametr includeTypelessEntities nie jest już obsługiwany, ponieważ nowa umiejętność zwraca tylko jednostki ze znanymi typami, więc jeśli poprzednia definicja umiejętności odwołuje się do niego, powinna zostać usunięta.

  3. (Opcjonalnie) Jeśli używasz danych wyjściowych namedEntities , istnieje kilka drobnych zmian nazw właściwości.

    1. value zmieniono nazwę na text
    2. confidence zmieniono nazwę na confidenceScore

    Jeśli musisz wygenerować dokładnie te same nazwy właściwości, dodaj element ShaperSkill , aby ponownie ukształtować dane wyjściowe przy użyciu wymaganych nazw. Na przykład ten element ShaperSkill zmienia nazwę właściwości na ich stare wartości.

    {
    "@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. (Opcjonalnie) Jeśli używasz danych wyjściowych entities do łączenia jednostek z dobrze znanymi jednostkami, ta funkcja jest teraz nową umiejętnością Microsoft.Skills.Text.V3.EntityLinkingSkill. Dodaj umiejętność łączenia jednostek z zestawem umiejętności, aby wygenerować połączone jednostki. Istnieje również kilka drobnych zmian nazw właściwości danych wyjściowych entities między EntityRecognitionSkill a nowym EntityLinkingSkillelementem .

    1. wikipediaId zmieniono nazwę na id
    2. wikipediaLanguage zmieniono nazwę na language
    3. wikipediaUrl zmieniono nazwę na url
    4. Właściwości type i subtype nie są już zwracane.

    Jeśli musisz wygenerować dokładnie te same nazwy właściwości, dodaj element ShaperSkill , aby ponownie ukształtować dane wyjściowe przy użyciu wymaganych nazw. Na przykład ten element ShaperSkill zmienia nazwę właściwości na ich stare wartości.

    {
    "@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. (Opcjonalnie) Jeśli nie określisz categoriesjawnie elementu , EntityRecognitionSkill V3 element może zwrócić inny typ kategorii oprócz tych, które były obsługiwane przez element EntityRecognitionSkill. Jeśli to zachowanie jest niepożądane, upewnij się, że jawnie ustaw categories parametr na ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"]wartość .

    Przykładowe definicje migracji

    • Prosta migracja

      (Przed) Definicja umiejętności EntityRecognition

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

      (Po) Definicja umiejętności EntityRecognition w wersji 3

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

    • Skomplikowana migracja

      (Przed) Definicja umiejętności 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"
        }
    ]
}

      (Po) Definicja umiejętności EntityRecognition w wersji 3

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

Ostatnia dostępna wersja interfejsu API

2021-04-30-Preview

Koniec wsparcia

sobota, 31 sierpnia 2024 r.

Zalecenia

Zamiast tego użyj elementu Microsoft.Skills.Text.V3.SentimentSkill . Zapewnia ulepszony model i zawiera opcję dodawania wyszukiwania opinii lub nastrojów opartych na aspektach. Ponieważ umiejętności są znacznie bardziej złożone, dane wyjściowe są również bardzo różne.

Aby przeprowadzić migrację do biblioteki Microsoft.Skills.Text.V3.SentimentSkill, wprowadź co najmniej jedną z poniższych zmian w definicji umiejętności. Definicję umiejętności można zaktualizować przy użyciu interfejsu API aktualizacji zestawu umiejętności.

Uwaga

Dane wyjściowe umiejętności dla umiejętności Sentiment Skill V3 nie są zgodne z definicją indeksu na podstawie tonacjiSkill. Konieczne będzie wprowadzenie zmian w definicji indeksu, zestawie umiejętności (późniejsze dane wejściowe umiejętności i/lub projekcje magazynu wiedzy) oraz mapowania pól wyjściowych indeksatora w celu zastąpienia umiejętności tonacji nową wersją.

  1. (Wymagane) Zmień wartość z "#Microsoft.Skills.Text.SentimentSkill" na "#Microsoft.Skills.Text.V3.SentimentSkill"@odata.type .

  2. (Wymagane) Umiejętność tonacji w wersji 3 zawiera positivewartość , neutrali wynik dla całego tekstu oraz negative te same wyniki dla każdego zdania w ogólnym tekście, natomiast poprzednia wartość SentimentSkill dostarczyła tylko jedno podwójne, które wahało się od 0,0 (ujemne) do 1,0 (dodatnie) dla całego tekstu. Musisz zaktualizować definicję indeksu, aby zaakceptować trzy podwójne wartości zamiast pojedynczego wyniku i upewnić się, że wszystkie dane wejściowe umiejętności podrzędnych, projekcje magazynu wiedzy i mapowania pól wyjściowych są zgodne ze zmianami nazewnictwa.

Zaleca się całkowite zastąpienie starego elementu SentimentSkill wartością SentimentSkill V3, zaktualizowanie danych wejściowych umiejętności podrzędnych, projekcji magazynu wiedzy, mapowań pól wyjściowych indeksatora i definicji indeksu w celu dopasowania do nowego formatu danych wyjściowych i zresetowania indeksatora, aby wszystkie dokumenty miały spójne wyniki tonacji w przyszłości.

Uwaga

Jeśli potrzebujesz dodatkowej pomocy przy aktualizowaniu potoku wzbogacania, aby użyć najnowszej wersji umiejętności tonacji lub jeśli zresetowanie indeksatora nie jest opcją, otwórz nowe żądanie pomocy technicznej, w którym możemy pracować bezpośrednio z Tobą.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Ostatnia dostępna wersja interfejsu API

2017-11-11-Preview

Koniec wsparcia

sobota, 31 sierpnia 2024 r.

Zalecenia

Zamiast tego użyj polecenia Microsoft.Skills.Text.V3.EntityRecognitionSkill . Zapewnia większość funkcji namedEntityRecognitionSkill w wyższej jakości. Zawiera również bogatsze informacje w swoich złożonych polach wyjściowych.

Aby przeprowadzić migrację do biblioteki Microsoft.Skills.Text.V3.EntityRecognitionSkill, wprowadź co najmniej jedną z poniższych zmian w definicji umiejętności. Definicję umiejętności można zaktualizować przy użyciu interfejsu API aktualizacji zestawu umiejętności.

  1. (Wymagane) Zmień wartość z "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" na "#Microsoft.Skills.Text.V3.EntityRecognitionSkill"@odata.type .

  2. (Opcjonalnie) Jeśli używasz danych wyjściowych, użyj złożonych entities danych wyjściowych kolekcji z elementu EntityRecognitionSkill V3 .namedEntities Istnieje kilka drobnych zmian nazw właściwości nowych namedEntities złożonych danych wyjściowych:

    1. value zmieniono nazwę na text
    2. confidence zmieniono nazwę na confidenceScore

    Jeśli musisz wygenerować dokładnie te same nazwy właściwości, dodaj element ShaperSkill , aby ponownie ukształtować dane wyjściowe przy użyciu wymaganych nazw. Na przykład ten element ShaperSkill zmienia nazwę właściwości na ich stare wartości.

    {
    "@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. (Opcjonalnie) Jeśli nie określisz categoriesjawnie elementu , EntityRecognitionSkill V3 element może zwrócić inny typ kategorii oprócz tych, które były obsługiwane przez element NamedEntityRecognitionSkill. Jeśli to zachowanie jest niepożądane, upewnij się, że jawnie ustaw categories parametr na ["Person", "Location", "Organization"]wartość .

    Przykładowe definicje migracji

    • Prosta migracja

      (Przed) Definicja umiejętności NamedEntityRecognition

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

      (Po) Definicja umiejętności EntityRecognition w wersji 3

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

    • Nieco skomplikowana migracja

      (Przed) Definicja umiejętności 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"
        }
    ]
}

      (Po) Definicja umiejętności EntityRecognition w wersji 3

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

Zobacz też