Elavult kognitív képességek az Azure AI Searchben

Cikk
09/01/2024

Ez a dokumentum az elavultnak (kivezetettnek) tekintett kognitív képességeket ismerteti. A tartalomhoz használja az alábbi útmutatót:

Képesség neve: Az elavult képesség neve; megfelel az @odata.type attribútumnak.
Utolsó elérhető API-verzió: Az Azure AI Search nyilvános API utolsó verziója, amelyen keresztül a megfelelő elavult képességet tartalmazó képességkészletek hozhatók létre/frissíthetők. Az ezekkel a képességekkel rendelkező csatolt képességkészletekkel rendelkező indexelők a "Támogatás megszűnésének" dátumáig a jövőben is futni fognak az API-verziókban, és ekkor kezdik el a sikertelenségüket.
Támogatás megszűnése: Az a nap, amely után a megfelelő képesség nem támogatottnak minősül, és nem működik. A korábban létrehozott képességkészleteknek továbbra is működnie kell, de a felhasználóknak ajánlott távolodni egy elavult képességtől.
Javaslatok: Migrálási útvonal előre egy támogatott képesség használatához. A felhasználóknak javasoljuk, hogy kövessék az ajánlásokat, hogy továbbra is támogatást kapjanak.

Ha a Microsoft.Skills.Text.EntityRecognitionSkill (Entity Recognition kognitív képesség (v2)) eszközt használja, ez a cikk segít frissíteni a képességkészletet a Microsoft.Skills.Text.V3.EntityRecognitionSkill használatára, amely általánosan elérhető, és új funkciókat vezet be.

Ha a Microsoft.Skills.Text.SentimentSkill (Hangulatfelismerési képesség (v2)) eszközt használja, ez a cikk segít frissíteni a készségkészletet a Microsoft.Skills.Text.V3.SentimentSkill használatára, amely általánosan elérhető, és új funkciókat vezet be.

Ha a Microsoft.Skills.Text.NamedEntityRecognitionSkill (Named Entity Recognition cognitive skill (v2) szolgáltatást használja, ez a cikk segít frissíteni a képességkészletet a Microsoft.Skills.Text.V3.EntityRecognitionSkill használatára, amely általánosan elérhető, és új funkciókat vezet be.

Microsoft.Skills.Text.EntityRecognitionSkill

Utolsó elérhető API-verzió

2021-04-30-preview

Támogatás megszűnése

2024. augusztus 31., szombat

Ajánlások

Ehelyett használja a Microsoft.Skills.Text.V3.EntityRecognitionSkill parancsot . Az EntityRecognitionSkill funkcióinak nagy részét magasabb minőségben biztosítja. Összetett kimeneti mezőiben is gazdagabb információval rendelkezik.

A Microsoft.Skills.Text.V3.EntityRecognitionSkillre való migráláshoz végezze el az alábbi módosítások valamelyikét a képességdefinícióban. A képességdefiníciót az Update Skillset API-val frissítheti.

(Kötelező) Módosítsa a @odata.type következőt"#Microsoft.Skills.Text.V3.EntityRecognitionSkill""#Microsoft.Skills.Text.EntityRecognitionSkill": .
(Nem kötelező) A includeTypelessEntities paraméter már nem támogatott, mivel az új képesség csak ismert típusú entitásokat ad vissza, ezért ha a korábbi képességdefiníció hivatkozott rá, akkor el kell távolítani.

(Nem kötelező) Ha a namedEntities kimenetet használja, a tulajdonságnevek néhány kisebb módosítást is életbe léptetnek.

value a átnevezve text
confidence a átnevezve confidenceScore

Ha pontosan ugyanazokat a tulajdonságneveket kell létrehoznia, adjon hozzá egy ShaperSkillt a kimenetnek a szükséges névvel való újraformázásához. Ez a ShaperSkill például átnevezi a tulajdonságokat a régi értékekre.

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

(Nem kötelező) Ha a entities kimenetet arra használja, hogy entitásokat csatoljon jól ismert entitásokhoz, ez a funkció most egy új képesség, a Microsoft.Skills.Text.V3.EntityLinkingSkill. Adja hozzá az entitás-összekapcsolási képességet a képességkészlethez a csatolt entitások létrehozásához. Az új és az új EntityLinkingSkillkimenet közötti EntityRecognitionSkill kimenet tulajdonságnevében entities is van néhány kisebb változás.

wikipediaId a átnevezve id
wikipediaLanguage a átnevezve language
wikipediaUrl a átnevezve url
A type rendszer a továbbiakban nem adja vissza a subtype tulajdonságokat.

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

(Nem kötelező) Ha nem adja meg explicit módon a categorieselemet, az EntityRecognitionSkill V3 a támogatott kategóriákon kívül EntityRecognitionSkillmás típusú kategóriákat is visszaadhat. Ha ez a viselkedés nem kívánatos, győződjön meg arról, hogy a paramétert ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"]kifejezetten erre categories állítja be.

Migrálási mintadefiníciók

Egyszerű migrálás

(Előtte) EntityRecognition skill definition

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

(Utána) EntityRecognition skill V3 definíció

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

Bonyolult migrálás

(Előtte) EntityRecognition skill definition

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

(Utána) EntityRecognition skill V3 definíció

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

Utolsó elérhető API-verzió

2021-04-30-preview

Támogatás megszűnése

2024. augusztus 31., szombat

Ajánlások

Használja helyette a Microsoft.Skills.Text.V3.SentimentSkill parancsot . Továbbfejlesztett modellt biztosít, és lehetővé teszi véleménybányászat vagy aspektusalapú vélemény hozzáadását. Mivel a képesség lényegesen összetettebb, a kimenetek is nagyon eltérőek.

A Microsoft.Skills.Text.V3.SentimentSkillre való migráláshoz végezze el az alábbi módosítások valamelyikét a képességdefinícióban. A képességdefiníciót az Update Skillset API-val frissítheti.

Feljegyzés

A Sentiment Skill V3 képességkimenetei nem kompatibilisek a SentimentSkillen alapuló indexdefinícióval. Módosítania kell az indexdefiníciót, a készségkészletet (későbbi készségbemeneteket és/vagy tudástár-előrejelzéseket) és az indexelő kimeneti mezőleképezéseit, hogy lecserélje a hangulati készséget az új verzióra.

(Kötelező) Módosítsa a @odata.type következőt"#Microsoft.Skills.Text.V3.SentimentSkill""#Microsoft.Skills.Text.SentimentSkill": .
(Kötelező) A Sentiment Skill V3 a teljes szöveghez és az összes mondathoz ugyanazt a pontszámot biztosítjapositiveneutralnegative, míg az előző SentimentSkill csak egy dupla értéket adott meg, amely a teljes szöveg esetében 0,0 (negatív) és 1,0 (pozitív) között volt. Frissítenie kell az indexdefiníciót, hogy elfogadja a három dupla értéket egyetlen pontszám helyett, és győződjön meg arról, hogy az összes alsóbb rétegbeli készségbemenet, a tudástár-előrejelzések és a kimeneti mezőleképezések összhangban vannak az elnevezési módosításokkal.

Javasoljuk, hogy a régi SentimentSkillt teljes egészében cserélje le a SentimentSkill V3-ra, frissítse az alsóbb rétegbeli készségbemeneteket, a tudástár-előrejelzéseket, az indexelő kimeneti mezőleképezéseit és az indexdefiníciót az új kimeneti formátumnak megfelelően, és állítsa alaphelyzetbe az indexelőt, hogy minden dokumentuma konzisztens hangulati eredményeket kapjon.

Feljegyzés

Ha további segítségre van szüksége a bővítési folyamat frissítéséhez a hangulati képesség legújabb verziójának használatához, vagy ha az indexelő alaphelyzetbe állítása nem lehetséges, nyisson meg egy új támogatási kérelmet , ahol közvetlenül dolgozhatunk Önnel.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Utolsó elérhető API-verzió

2017. 11. 11. dátumú előzetes verzió

Támogatás megszűnése

2024. augusztus 31., szombat

Ajánlások

Ehelyett használja a Microsoft.Skills.Text.V3.EntityRecognitionSkill parancsot . A NamedEntityRecognitionSkill funkcióinak nagy részét magasabb minőségben biztosítja. Összetett kimeneti mezőiben is gazdagabb információval rendelkezik.

(Kötelező) Módosítsa a @odata.type következőt"#Microsoft.Skills.Text.V3.EntityRecognitionSkill""#Microsoft.Skills.Text.NamedEntityRecognitionSkill": .

(Nem kötelező) Ha a entities kimenetet használja, használja helyette az namedEntities összetett gyűjtemény kimenetét EntityRecognitionSkill V3 . Az új namedEntities összetett kimenet tulajdonságneveinek néhány kisebb módosítása van:

value a átnevezve text
confidence a átnevezve 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"
        }
    ]
}

(Nem kötelező) Ha nem adja meg explicit módon a categorieselemet, az EntityRecognitionSkill V3 a támogatott kategóriákon kívül NamedEntityRecognitionSkillmás típusú kategóriákat is visszaadhat. Ha ez a viselkedés nem kívánatos, győződjön meg arról, hogy a paramétert ["Person", "Location", "Organization"]kifejezetten erre categories állítja be.

Migrálási mintadefiníciók

Egyszerű migrálás

(Előtte) NamedEntityRecognition skill definition

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

(Utána) EntityRecognition skill V3 definíció

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

Kissé bonyolult migrálás

(Előtte) NamedEntityRecognition skill definition

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

(Utána) EntityRecognition skill V3 definíció

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

Megosztás a következőn keresztül:

Elavult kognitív képességek az Azure AI Searchben

Microsoft.Skills.Text.EntityRecognitionSkill

Utolsó elérhető API-verzió

Támogatás megszűnése

Ajánlások

Microsoft.Skills.Text.SentimentSkill

Utolsó elérhető API-verzió

Támogatás megszűnése

Ajánlások

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Utolsó elérhető API-verzió

Támogatás megszűnése

Ajánlások

Lásd még

Visszajelzés

További források