Habilidades cognitivas preteridas no IA do Azure Search

Artigo
11/15/2023

Este documento descreve as habilidades cognitivas que são consideradas preteridas (desativado). Use o seguinte guia para o conteúdo:

Nome da habilidade: o nome da habilidade que será descontinuada; mapeia para o atributo @odata.type.
Última versão da API disponível: a última versão da API pública do IA do Azure Search por meio dos conjuntos de habilidades que contêm a habilidade preterida correspondente pode ser criada/atualizada. Indexadores com conjuntos de habilidades anexados com essas habilidades continuarão a ser executados mesmo em versões futuras da API até a data de "Fim do suporte", momento em que eles começam a falhar.
Fim do suporte: o dia após o qual a habilidade correspondente é considerada sem suporte e para de funcionar. Os conjuntos de habilidades criados anteriormente ainda devem continuar funcionando, mas recomenda-se que os usuários migrem de uma habilidade obsoleta.
Recomendações: caminho de migração para usar uma habilidade suportada. Os usuários são aconselhados a seguir as recomendações para continuar recebendo suporte.

Se você estiver usando o Microsoft.Skills.Text.EntityRecognitionSkill (habilidade cognitiva de reconhecimento de entidade (v2)), este artigo ajudará você a atualizar seu conjunto de habilidades para usar o Microsoft.Skills.Text.V3.EntityRecognitionSkill, que geralmente está disponível e apresenta novos recursos.

Se você estiver usando o Microsoft.Skills.Text.SentimentSkill (habilidade cognitiva de sentimento (v2)), este artigo ajudará você a atualizar seu conjunto de habilidades para usar o Microsoft.Skills.Text.V3.SentimentSkill, que geralmente está disponível e apresenta novos recursos.

Se você estiver usando a habilidade cognitiva Microsoft.Skills.Text.NamedEntityRecognitionSkill (habilidade cognitiva de Reconhecimento de Entidade Nomeada (v2)), este artigo ajudará você a atualizar seu conjunto de habilidades para usar o Microsoft.Skills.Text.V3.EntityRecognitionSkill, que geralmente está disponível e apresenta novos recursos.

Microsoft.Skills.Text.EntityRecognitionSkill

Última versão disponível do api

2021-04-30-Prévia

Fim do suporte

31 de agosto de 2024

Recomendações

Use Microsoft.Skills.Text.V3.EntityRecognitionSkill. Ele fornece a maior parte da funcionalidade do EntityRecognitionSkill em uma qualidade superior. Também possui informações mais completas em seus campos de saída complexos.

Para migrar para o Microsoft.Skills.Text.V3.EntityRecognitionSkill, faça uma ou mais das seguintes alterações na sua definição de habilidade. Você pode atualizar a definição de habilidade usando a API Update Skillset.

(Obrigatório) Altere o @odata.type de "#Microsoft.Skills.Text.EntityRecognitionSkill" para "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".
(Opcional) O parâmetro includeTypelessEntities não tem mais suporte, pois a nova habilidade retorna apenas entidades com tipos conhecidos, portanto, se sua definição de habilidade anterior o referenciou, ele agora deve ser removido.

(Opcional) Se você estiver usando a saída namedEntities, haverá algumas pequenas alterações nos nomes das propriedades.

value foi renomeado para text
confidence foi renomeado para confidenceScore

Se você precisar gerar exatamente os mesmos nomes de propriedade, adicione um ShaperSkill para remodelar a saída com os nomes necessários. Por exemplo, esse ShaperSkill renomeia as propriedades de acordo com os valores antigos.

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

(Opcional) Se você estiver usando a saída entities para vincular entidades a entidades conhecidas, esse recurso agora é uma nova habilidade, o Microsoft.Skills.Text.V3.EntityLinkingSkill. Adicione a habilidade de vinculação de entidade ao seu conjunto de habilidades para gerar as entidades vinculadas. Existem também algumas pequenas alterações nos nomes das propriedades da saída entities entre EntityRecognitionSkill e o novo EntityLinkingSkill.

wikipediaId foi renomeado para id
wikipediaLanguage foi renomeado para language
wikipediaUrl foi renomeado para url
As propriedades type e subtype não são mais retornadas.

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

(opcional) Se você não especificar explicitamente o categories, o EntityRecognitionSkill V3 poderá retornar diferentes tipos de categorias além daquelas com suporte do EntityRecognitionSkill. Se esse comportamento for indesejável, certifique-se de definir explicitamente o categories parâmetro para ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

Exemplos de definições de migração

Migração simples

(Antes) Definição de habilidade EntityRecognition

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

(Depois) Definição de habilidade EntityRecognition V3

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

Migração complicada

(Antes) Definição de habilidade 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"
        }
    ]
}

(Depois) Definição de habilidade 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

Última versão disponível do api

2021-04-30-Prévia

Fim do suporte

31 de agosto de 2024

Recomendações

Use Microsoft.Skills.Text.V3.SentimentSkill no lugar. Ele fornece um modelo aprimorado e inclui a opção de adicionar mineração de opiniões ou sentimento baseado em aspecto. Como a habilidade é significativamente mais complexa, as saídas também são muito diferentes.

Para migrar para o Microsoft.Skills.Text.V3.SentimentSkill, faça uma ou mais das seguintes alterações na sua definição de habilidade. Você pode atualizar a definição de habilidade usando a API Update Skillset.

Observação

As saídas de habilidade para a Habilidade de Sentimento V3 não são compatíveis com a definição de índice com base em SentimentSkill. Você terá que fazer alterações na definição de índice, no conjunto de habilidades (entradas de habilidades posteriores e/ou projeções de armazenamento de conhecimento) e mapeamentos de campo de saída do indexador para substituir a habilidade de sentimento pela nova versão.

(Obrigatório) Altere o @odata.type de "#Microsoft.Skills.Text.SentimentSkill" para "#Microsoft.Skills.Text.V3.SentimentSkill".
(Obrigatório) A Habilidade de Sentimento V3 fornece uma pontuação positive, neutral e negative para o texto geral e as mesmas pontuações para cada frase no texto geral, enquanto o SentimentSkill anterior forneceu apenas um único duplo que variava entre 0,0 (negativo) e 1,0 (positivo) para o texto geral. Você precisará atualizar sua definição de índice para aceitar os três valores duplos no lugar de uma única pontuação e certificar-se de que todas as suas entradas de habilidades downstream, projeções de repositório de conhecimento e mapeamentos de campo de saída sejam consistentes com as alterações de nomeação.

É recomendável substituir o SentimentSkill antigo pelo SentimentSkill V3 inteiramente, atualizar suas entradas de habilidade downstream, projeções do repositório de conhecimento, mapeamentos de campo de saída do indexador e definição de índice para corresponder ao novo formato de saída e redefinir seu indexador para que todos os seus documentos tenham resultados de sentimento consistentes daqui para frente.

Observação

Se você precisar de ajuda adicional para atualizar seu pipeline de enriquecimento para usar a versão mais recente da habilidade de sentimento ou se redefinir o indexador não for uma opção para você, abra uma nova solicitação de suporte na qual podemos trabalhar com você diretamente.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Última versão disponível do api

2017-11-11-Versão prévia

Fim do suporte

31 de agosto de 2024

Recomendações

Use Microsoft.Skills.Text.V3.EntityRecognitionSkill. Ele fornece a maior parte da funcionalidade do NamedEntityRecognitionSkill em uma qualidade superior. Também possui informações mais completas em seus campos de saída complexos.

(Obrigatório) Altere o @odata.type de "#Microsoft.Skills.Text.NamedEntityRecognitionSkill" para "#Microsoft.Skills.Text.V3.EntityRecognitionSkill".

(opcional) Se você estiver usando a saída entities, use a saída de coleção namedEntities complexa do EntityRecognitionSkill V3. Há algumas pequenas alterações nos nomes das propriedades da nova saída complexa namedEntities:

value foi renomeado para text
confidence foi renomeado para 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"
        }
    ]
}

(opcional) Se você não especificar explicitamente o categories, o EntityRecognitionSkill V3 poderá retornar diferentes tipos de categorias além daquelas com suporte do NamedEntityRecognitionSkill. Se esse comportamento for indesejável, certifique-se de definir explicitamente o categories parâmetro para ["Person", "Location", "Organization"].

Exemplos de definições de migração

Migração simples

(Before) NomeouEntityRecognition, definição de habilidade

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

(Depois) Definição de habilidade EntityRecognition V3

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

Um pouco complicado de migração

(Before) NomeouEntityRecognition, definição de habilidade

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

(Depois) Definição de habilidade 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"
        }
    ]
}

Habilidades cognitivas preteridas no IA do Azure Search

Microsoft.Skills.Text.EntityRecognitionSkill

Última versão disponível do api

Fim do suporte

Recomendações

Microsoft.Skills.Text.SentimentSkill

Última versão disponível do api

Fim do suporte

Recomendações

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Última versão disponível do api

Fim do suporte

Recomendações

Confira também

Recursos adicionais