Condividi tramite

Competenze cognitive deprecate in Ricerca di intelligenza artificiale di Azure

  • Articolo

Questo documento descrive le competenze cognitive considerate deprecate (ritirate). Usare la guida seguente per il contenuto:

  • Nome competenza: nome della competenza che verrà deprecata; esegue il mapping all'attributo @odata.type .
  • Ultima versione dell'API disponibile: l'ultima versione dell'API pubblica di Ricerca intelligenza artificiale di Azure tramite cui è possibile creare/aggiornare i set di competenze contenenti la competenza deprecata corrispondente. Gli indicizzatori con set di competenze associati con queste competenze continueranno a essere eseguiti anche nelle versioni future dell'API fino alla data di fine del supporto, a quel punto che iniziano a non riuscire.
  • Fine del supporto: giorno dopo il quale la competenza corrispondente viene considerata non supportata e smette di funzionare. I set di competenze creati in precedenza dovrebbero continuare a funzionare, ma si consiglia agli utenti di eseguire la migrazione da una competenza deprecata.
  • Raccomandazioni: percorso di migrazione per usare una competenza supportata. Gli utenti sono invitati a seguire le raccomandazioni per continuare a ricevere supporto.

Se si usa Microsoft.Skills.Text.EntityRecognitionSkill (competenza cognitiva riconoscimento entità (v2), questo articolo consente di aggiornare il set di competenze per usare Microsoft.Skills.Text.V3.EntityRecognitionSkill, disponibile a livello generale e introduce nuove funzionalità.

Se si usa Microsoft.Skills.Text.SentimentSkill (competenza cognitiva sentiment (v2)), questo articolo consente di aggiornare il set di competenze per usare Microsoft.Skills.Text.V3.SentimentSkill, disponibile a livello generale e introduce nuove funzionalità.

Se usi Microsoft.Skills.Text.NamedEntityRecognitionSkill (competenza cognitiva riconoscimento entità denominata (v2), questo articolo ti aiuta ad aggiornare il set di competenze per usare Microsoft.Skills.Text.V3.EntityRecognitionSkill, disponibile a livello generale e introduce nuove funzionalità.

Microsoft.Skills.Text.EntityRecognitionSkill

Ultima versione disponibile dell'API

2021-04-30-Preview

Fine del supporto

sabato 31 agosto 2024

Consigli

Usare invece Microsoft.Skills.Text.V3.EntityRecognitionSkill . Offre la maggior parte delle funzionalità di EntityRecognitionSkill a una qualità superiore. Include anche informazioni più dettagliate nei campi dell'output complesso.

Per eseguire la migrazione a Microsoft.Skills.Text.V3.EntityRecognitionSkill, apportare una o più delle modifiche seguenti alla definizione della competenza. È possibile aggiornare la definizione della competenza usando l'API di aggiornamento del set di competenze.

  1. (Obbligatorio) Modificare @odata.type da "#Microsoft.Skills.Text.EntityRecognitionSkill" a "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Facoltativo) Il includeTypelessEntities parametro non è più supportato perché la nuova competenza restituisce solo entità con tipi noti, quindi se la definizione di competenza precedente vi fa riferimento, dovrebbe essere rimossa.

  3. (Facoltativo) Se si usa l'output namedEntities , vengono apportate alcune modifiche secondarie ai nomi delle proprietà.

    1. value viene rinominato in text
    2. confidence viene rinominato in confidenceScore

    Se è necessario generare gli stessi nomi di proprietà, aggiungere shaperSkill per modellare l'output con i nomi necessari. Ad esempio, shaperSkill rinomina le proprietà con i valori precedenti.

    {
    "@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. (Facoltativo) Se si usa l'output entities per collegare entità a entità note, questa funzionalità è ora una nuova competenza, Microsoft.Skills.Text.V3.EntityLinkingSkill. Aggiungere la competenza di collegamento dell'entità al set di competenze per generare le entità collegate. Esistono anche alcune modifiche secondarie ai nomi delle proprietà dell'output entities tra e EntityRecognitionSkill il nuovo EntityLinkingSkilloggetto .

    1. wikipediaId viene rinominato in id
    2. wikipediaLanguage viene rinominato in language
    3. wikipediaUrl viene rinominato in url
    4. Le type proprietà e subtype non vengono più restituite.

    Se è necessario generare gli stessi nomi di proprietà, aggiungere shaperSkill per modellare l'output con i nomi necessari. Ad esempio, shaperSkill rinomina le proprietà con i valori precedenti.

    {
    "@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. (Facoltativo) Se non si specifica in modo esplicito , l'oggetto categoriesEntityRecognitionSkill V3 può restituire un tipo diverso di categorie oltre a quelle supportate da EntityRecognitionSkill. Per non consentire questo comportamento, assicurarsi di impostare in modo esplicito il parametro categories su ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

    Definizioni di migrazione di esempio

    • Migrazione di esempio

      (Prima) Definizione della competenza EntityRecognition

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

      (Dopo) Definizione della competenza EntityRecognition V3

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

    • Migrazione complessa

      (Prima) Definizione della competenza 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"
        }
    ]
}

      (Dopo) Definizione della competenza 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

Ultima versione disponibile dell'API

2021-04-30-Preview

Fine del supporto

sabato 31 agosto 2024

Consigli

Usare invece Microsoft.Skills.Text.V3.SentimentSkill . Fornisce un modello migliorato e include l'opzione per aggiungere il sentiment di opinion mining o basato su aspetti. Poiché la competenza è significativamente più complessa, anche gli output sono molto diversi.

Per eseguire la migrazione a Microsoft.Skills.Text.V3.SentimentSkill, apportare una o più delle modifiche seguenti alla definizione della competenza. È possibile aggiornare la definizione della competenza usando l'API di aggiornamento del set di competenze.

Nota

Gli output delle competenze per la competenza sentiment V3 non sono compatibili con la definizione dell'indice in base a SentimentSkill. Sarà necessario apportare modifiche alla definizione dell'indice, al set di competenze (input delle competenze successive e/o alle proiezioni dell'archivio conoscenze) e ai mapping dei campi di output dell'indicizzatore per sostituire la competenza sentiment con la nuova versione.

  1. (Obbligatorio) Modificare @odata.type da "#Microsoft.Skills.Text.SentimentSkill" a "#Microsoft.Skills.Text.V3.SentimentSkill".

  2. (Obbligatorio) La competenza sentiment V3 fornisce un positivepunteggio , neutrale negative per il testo complessivo e gli stessi punteggi per ogni frase nel testo complessivo, mentre il sentimentSkill precedente fornisce solo un singolo doppio compreso tra 0,0 (negativo) e 1,0 (positivo) per il testo complessivo. Sarà necessario aggiornare la definizione dell'indice per accettare i tre valori double al posto di un singolo punteggio e assicurarsi che tutti gli input delle competenze downstream, le proiezioni dell'archivio conoscenze e i mapping dei campi di output siano coerenti con le modifiche di denominazione.

È consigliabile sostituire completamente sentimentSkill con sentimentSkill V3, aggiornare completamente gli input delle competenze downstream, le proiezioni dell'archivio conoscenze, i mapping dei campi di output dell'indicizzatore e la definizione di indice in modo che corrisponda al nuovo formato di output e reimpostare l'indicizzatore in modo che tutti i documenti abbiano risultati coerenti sul sentiment in futuro.

Nota

Se è necessaria ulteriore assistenza per aggiornare la pipeline di arricchimento per usare la versione più recente della competenza del sentiment o se la reimpostazione dell'indicizzatore non è un'opzione appropriata, aprire una nuova richiesta di supporto in cui è possibile collaborare direttamente con l'utente.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Ultima versione disponibile dell'API

2017-11-11-Preview

Fine del supporto

sabato 31 agosto 2024

Consigli

Usare invece Microsoft.Skills.Text.V3.EntityRecognitionSkill . Fornisce la maggior parte delle funzionalità di NamedEntityRecognitionSkill, ma di qualità più elevata. Include anche informazioni più dettagliate nei campi dell'output complesso.

Per eseguire la migrazione a Microsoft.Skills.Text.V3.EntityRecognitionSkill, apportare una o più delle modifiche seguenti alla definizione della competenza. È possibile aggiornare la definizione della competenza usando l'API di aggiornamento del set di competenze.

  1. (Obbligatorio) Modificare @odata.type da "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" a "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

  2. (Facoltativo) Se si usa l'outputentities, usare invece l'output namedEntities complesso della raccolta.EntityRecognitionSkill V3 Esistono alcune modifiche secondarie ai nomi delle proprietà del nuovo namedEntities output complesso:

    1. value viene rinominato in text
    2. confidence viene rinominato in confidenceScore

    Se è necessario generare gli stessi nomi di proprietà, aggiungere shaperSkill per modellare l'output con i nomi necessari. Ad esempio, shaperSkill rinomina le proprietà con i valori precedenti.

    {
    "@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. (Facoltativo) Se non si specifica in modo esplicito , l'oggetto categoriesEntityRecognitionSkill V3 può restituire un tipo diverso di categorie oltre a quelle supportate da NamedEntityRecognitionSkill. Per non consentire questo comportamento, assicurarsi di impostare in modo esplicito il parametro categories su ["Person", "Location", "Organization"].

    Definizioni di migrazione di esempio

    • Migrazione di esempio

      (Prima) Definizione della competenza NamedEntityRecognition

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

      (Dopo) Definizione della competenza EntityRecognition V3

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

    • Migrazione leggermente complessa

      (Prima) Definizione della competenza 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"
        }
    ]
}

      (Dopo) Definizione della competenza 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"
        }
    ]
}

Vedi anche