Delen via

Afgeschafte cognitieve vaardigheden in Azure AI Search

  • Artikel

In dit document worden cognitieve vaardigheden beschreven die worden beschouwd als afgeschaft (buiten gebruik gesteld). Gebruik de volgende handleiding voor de inhoud:

  • Vaardigheidsnaam: de naam van de vaardigheid die wordt afgeschaft; het wordt toegewezen aan het @odata.type kenmerk.
  • Laatst beschikbare API-versie: de laatste versie van de openbare API van Azure AI Search waarmee vaardighedensets met de bijbehorende afgeschafte vaardigheid kunnen worden gemaakt/bijgewerkt. Indexeerfuncties met gekoppelde vaardighedensets met deze vaardigheden blijven zelfs in toekomstige API-versies worden uitgevoerd tot de datum 'Einde van ondersteuning', waarna ze mislukken.
  • Einde van de ondersteuning: de dag waarna de bijbehorende vaardigheid als niet-ondersteund wordt beschouwd en niet meer werkt. Eerder gemaakte vaardighedensets moeten nog steeds blijven functioneren, maar gebruikers worden aangeraden om te migreren van een afgeschafte vaardigheid.
  • Aanbevelingen: migratiepad vooruit voor het gebruik van een ondersteunde vaardigheid. Gebruikers wordt aangeraden de aanbevelingen te volgen om ondersteuning te blijven ontvangen.

Als u microsoft.Skills.Text.EntityRecognitionSkill (Cognitive Skill v2) gebruikt, helpt dit artikel u bij het upgraden van uw vaardighedenset om de Microsoft.Skills.Text.V3.EntityRecognitionSkill te gebruiken die algemeen beschikbaar is en nieuwe functies introduceert.

Als u de Microsoft.Skills.Text.SentimentSkill (gevoelsvaardigheid (v2)) gebruikt, helpt dit artikel u bij het upgraden van uw vaardighedenset om de Microsoft.Skills.Text.V3.SentimentSkill te gebruiken die algemeen beschikbaar is en nieuwe functies introduceert.

Als u microsoft.Skills.Text.NamedEntityRecognitionSkill (cognitive skill named Entity Recognition (v2) gebruikt, helpt dit artikel u bij het upgraden van uw vaardighedenset om de Microsoft.Skills.Text.V3.EntityRecognitionSkill te gebruiken die algemeen beschikbaar is en nieuwe functies introduceert.

Microsoft.Skills.Text.EntityRecognitionSkill

Laatst beschikbare API-versie

2021-04-30-Preview

Einde van ondersteuning

zaterdag 31 augustus 2024

Aanbevelingen

Gebruik in plaats daarvan Microsoft.Skills.Text.V3.EntityRecognitionSkill . Het biedt de meeste functionaliteit van entityRecognitionSkill met een hogere kwaliteit. Het bevat ook uitgebreidere informatie in de complexe uitvoervelden.

Als u wilt migreren naar Microsoft.Skills.Text.V3.EntityRecognitionSkill, moet u een of meer van de volgende wijzigingen aanbrengen in uw vaardigheidsdefinitie. U kunt de vaardigheidsdefinitie bijwerken met behulp van de API Vaardighedenset bijwerken.

  1. (Vereist) Wijzig het @odata.type van "#Microsoft.Skills.Text.EntityRecognitionSkill" in "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Optioneel) De includeTypelessEntities parameter wordt niet meer ondersteund omdat de nieuwe vaardigheid alleen entiteiten met bekende typen retourneert, dus als uw vorige vaardigheidsdefinitie ernaar verwijst, moet deze nu worden verwijderd.

  3. (Optioneel) Als u gebruikmaakt van de namedEntities uitvoer, zijn er enkele kleine wijzigingen in de eigenschapsnamen.

    1. value is hernoemd in text
    2. confidence is hernoemd in confidenceScore

    Als u exact dezelfde eigenschapsnamen wilt genereren, voegt u een ShaperSkill toe om de uitvoer opnieuw vorm te geven met de vereiste namen. Deze ShaperSkill wijzigt bijvoorbeeld de naam van de eigenschappen in hun oude waarden.

    {
    "@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. (Optioneel) Als u de entities uitvoer gebruikt om entiteiten te koppelen aan bekende entiteiten, is deze functie nu een nieuwe vaardigheid, de Microsoft.Skills.Text.V3.EntityLinkingSkill. Voeg de entiteitskoppelingsvaardigheden toe aan uw vaardighedenset om de gekoppelde entiteiten te genereren. Er zijn ook enkele kleine wijzigingen in de eigenschapsnamen van de uitvoer tussen de entities EntityRecognitionSkill en de nieuwe EntityLinkingSkill.

    1. wikipediaId is hernoemd in id
    2. wikipediaLanguage is hernoemd in language
    3. wikipediaUrl is hernoemd in url
    4. De type en subtype eigenschappen worden niet meer geretourneerd.

    Als u exact dezelfde eigenschapsnamen wilt genereren, voegt u een ShaperSkill toe om de uitvoer opnieuw vorm te geven met de vereiste namen. Deze ShaperSkill wijzigt bijvoorbeeld de naam van de eigenschappen in hun oude waarden.

    {
    "@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. (Optioneel) Als u de categorie niet expliciet opgeeft categories, kan het EntityRecognitionSkill V3 andere type categorieën retourneren dan categorieën die worden ondersteund door de EntityRecognitionSkill. Als dit gedrag ongewenst is, moet u de categories parameter expliciet instellen op ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

    Voorbeeld van migratiedefinities

    • Eenvoudige migratie

      (Vóór) Definitie van de vaardigheid EntityRecognition

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

      (Na) Definitie van EntityRecognition skill V3

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

    • Gecompliceerde migratie

      (Vóór) Definitie van de vaardigheid 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"
        }
    ]
}

      (Na) Definitie van EntityRecognition skill 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

Laatst beschikbare API-versie

2021-04-30-Preview

Einde van ondersteuning

zaterdag 31 augustus 2024

Aanbevelingen

Gebruik in plaats daarvan Microsoft.Skills.Text.V3.SentimentSkill . Het biedt een verbeterd model en bevat de optie om meninganalyse of op aspect gebaseerde sentimenten toe te voegen. Omdat de vaardigheid aanzienlijk complexer is, zijn de uitvoer ook heel verschillend.

Als u wilt migreren naar Microsoft.Skills.Text.V3.SentimentSkill, moet u een of meer van de volgende wijzigingen aanbrengen in uw vaardigheidsdefinitie. U kunt de vaardigheidsdefinitie bijwerken met behulp van de API Vaardighedenset bijwerken.

Notitie

De uitvoer van vaardigheden voor de Sentiment Skill V3 is niet compatibel met de indexdefinitie op basis van de SentimentSkill. U moet wijzigingen aanbrengen in de indexdefinitie, vaardighedenset (latere vaardigheidsinvoer en/of kennisarchiefprojecties) en toewijzingen van uitvoervelden van de indexeerfunctie om de gevoelsvaardigheid te vervangen door de nieuwe versie.

  1. (Vereist) Wijzig het @odata.type van "#Microsoft.Skills.Text.SentimentSkill" in "#Microsoft.Skills.Text.V3.SentimentSkill".

  2. (Vereist) De Gevoelsvaardigheid V3 biedt een positive, neutralen negative score voor de algemene tekst en dezelfde scores voor elke zin in de algemene tekst, terwijl de vorige SentimentSkill slechts één dubbel getal heeft geleverd dat varieerde van 0,0 (negatief) tot 1,0 (positief) voor de algehele tekst. U moet uw indexdefinitie bijwerken om de drie dubbele waarden in plaats van één score te accepteren en ervoor te zorgen dat al uw invoer van downstreamvaardigheden, projecties van kennisarchieven en toewijzingen van uitvoervelden consistent zijn met de naamwijzigingen.

Het is raadzaam om de oude SentimentSkill volledig te vervangen door de SentimentSkill V3, uw invoer voor downstreamvaardigheden bij te werken, projecties van kennisarchieven, toewijzingen van indexeerfuncties en indexdefinities zodat deze overeenkomt met de nieuwe uitvoerindeling en de indexeerfunctie opnieuw instellen, zodat al uw documenten in de toekomst consistente sentimentresultaten hebben.

Notitie

Als u extra hulp nodig hebt bij het bijwerken van uw verrijkingspijplijn om de nieuwste versie van de gevoelsvaardigheid te gebruiken of als het opnieuw instellen van uw indexeerfunctie geen optie voor u is, opent u een nieuwe ondersteuningsaanvraag waar we rechtstreeks met u kunnen werken.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Laatst beschikbare API-versie

11-11-2017-preview

Einde van ondersteuning

zaterdag 31 augustus 2024

Aanbevelingen

Gebruik in plaats daarvan Microsoft.Skills.Text.V3.EntityRecognitionSkill . Het biedt de meeste functionaliteit van de NamedEntityRecognitionSkill met een hogere kwaliteit. Het bevat ook uitgebreidere informatie in de complexe uitvoervelden.

Als u wilt migreren naar Microsoft.Skills.Text.V3.EntityRecognitionSkill, moet u een of meer van de volgende wijzigingen aanbrengen in uw vaardigheidsdefinitie. U kunt de vaardigheidsdefinitie bijwerken met behulp van de API Vaardighedenset bijwerken.

  1. (Vereist) Wijzig het @odata.type van "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" in "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Optioneel) Als u gebruikmaakt van de entities uitvoer, gebruikt u in plaats daarvan de namedEntities complexe verzamelingsuitvoer.EntityRecognitionSkill V3 Er zijn enkele kleine wijzigingen in de eigenschapsnamen van de nieuwe namedEntities complexe uitvoer:

    1. value is hernoemd in text
    2. confidence is hernoemd in confidenceScore

    Als u exact dezelfde eigenschapsnamen wilt genereren, voegt u een ShaperSkill toe om de uitvoer opnieuw vorm te geven met de vereiste namen. Deze ShaperSkill wijzigt bijvoorbeeld de naam van de eigenschappen in hun oude waarden.

    {
    "@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. (Optioneel) Als u de categorie niet expliciet opgeeft categories, kan het EntityRecognitionSkill V3 andere type categorieën retourneren dan categorieën die worden ondersteund door de NamedEntityRecognitionSkill. Als dit gedrag ongewenst is, moet u de categories parameter expliciet instellen op ["Person", "Location", "Organization"].

    Voorbeeld van migratiedefinities

    • Eenvoudige migratie

      (Vóór) Vaardigheidsdefinitie NamedEntityRecognition

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

      (Na) Definitie van EntityRecognition skill V3

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

    • Enigszins gecompliceerde migratie

      (Vóór) Vaardigheidsdefinitie 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"
        }
    ]
}

      (Na) Definitie van EntityRecognition skill 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"
        }
    ]
}

Zie ook