Habilidades cognitivas preteridas na Pesquisa de IA do Azure

Artigo
09/01/2024

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

Nome da habilidade: O nome da habilidade que será preterida; ele mapeia para o @odata.type atributo.
Última versão da api disponível: a última versão da API pública do Azure AI Search através da qual conjuntos de habilidades contendo a habilidade preterida correspondente podem ser criados/atualizados. Os 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", quando começarão 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 a funcionar, mas recomenda-se que os usuários migrem de uma habilidade obsoleta.
Recomendações: Caminho de migração para usar uma habilidade suportada. Os utilizadores são aconselhados a seguir as recomendações para continuarem a receber suporte.

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

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

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

Microsoft.Skills.Text.EntityRecognitionSkill

Última versão api disponível

2021-04-30-Pré-visualização

Fim do suporte

31 de agosto de 2024

Recomendações

Em vez disso, use Microsoft.Skills.Text.V3.EntityRecognitionSkill . Ele fornece a maioria das funcionalidades do EntityRecognitionSkill com uma qualidade superior. Ele também tem informações mais ricas 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 includeTypelessEntities parâmetro não é mais suportado, pois a nova habilidade retorna apenas entidades com tipos conhecidos, portanto, se sua definição de habilidade anterior fez referência a ele, ele deve ser removido.

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

value é renomeado para text
confidence é renomeado para confidenceScore

Se você precisar gerar exatamente os mesmos nomes de propriedade, adicione uma ShaperSkill para remodelar a saída com os nomes necessários. Por exemplo, este ShaperSkill renomeia as propriedades para seus 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 entities saída para vincular entidades a entidades conhecidas, esse recurso agora é uma nova habilidade, a Microsoft.Skills.Text.V3.EntityLinkingSkill. Adicione a habilidade de vinculação de entidade ao seu conjunto de habilidades para gerar as entidades vinculadas. Há também algumas pequenas alterações nos nomes de propriedade da entities saída entre o e o EntityRecognitionSkill novo EntityLinkingSkill.

wikipediaId é renomeado para id
wikipediaLanguage é renomeado para language
wikipediaUrl é renomeado para url
As type propriedades 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 pode retornar diferentes tipos de categorias além daquelas que foram suportadas EntityRecognitionSkillpelo . Se esse comportamento for indesejável, certifique-se de definir explicitamente o categories parâmetro como ["Person", "Location", "Organization", "Quantity", "Datetime", "URL", "Email"].

Definições de migração de exemplo

Migração simples

(Antes) Definição de competências 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 da 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 competências 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 da 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 api disponível

2021-04-30-Pré-visualização

Fim do suporte

31 de agosto de 2024

Recomendações

Em vez disso, use Microsoft.Skills.Text.V3.SentimentSkill . Ele fornece um modelo aprimorado e inclui a opção de adicionar mineração de opinião ou sentimento baseado em aspeto. Como a habilidade é significativamente mais complexa, os resultados 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.

Nota

Os resultados de habilidades para a Habilidade de Sentimento V3 não são compatíveis com a definição de índice baseada na Habilidade de Sentimento. Você terá que fazer alterações na definição do índice, 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 um positive, neutrale negative pontuação para o texto geral e as mesmas pontuações para cada frase no texto geral, enquanto a SentimentSkill anterior fornecia apenas um único duplo que variava de 0,0 (negativo) a 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 garantir que todas as suas entradas de habilidades downstream, projeções de armazenamento de conhecimento e mapeamentos de campo de saída sejam consistentes com as alterações de nomenclatura.

É recomendável substituir totalmente o antigo SentimentSkill pelo SentimentSkill V3, atualizar suas entradas de habilidades downstream, projeções de armazenamento 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 no futuro.

Nota

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 seu indexador não for uma opção para você, abra uma nova solicitação de suporte onde podemos trabalhar diretamente com você.

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Última versão api disponível

2017-11-11-Preview

Fim do suporte

31 de agosto de 2024

Recomendações

Em vez disso, use Microsoft.Skills.Text.V3.EntityRecognitionSkill . Ele fornece a maioria das funcionalidades do NamedEntityRecognitionSkill com uma qualidade superior. Ele também tem informações mais ricas 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 fazendo uso da entities saída, use a namedEntities saída de coleção complexa do EntityRecognitionSkill V3 em vez disso. Há algumas pequenas alterações nos nomes de propriedade da nova namedEntities saída complexa:

value é renomeado para text
confidence é 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 pode retornar diferentes tipos de categorias além daquelas que foram suportadas NamedEntityRecognitionSkillpelo . Se esse comportamento for indesejável, certifique-se de definir explicitamente o categories parâmetro como ["Person", "Location", "Organization"].

Definições de migração de exemplo

Migração simples

(Antes) Definição de habilidade NamedEntityRecognition

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

(Depois) Definição da 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 ligeiramente complicada

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

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

Partilhar via

Habilidades cognitivas preteridas na Pesquisa de IA do Azure

Microsoft.Skills.Text.EntityRecognitionSkill

Última versão api disponível

Fim do suporte

Recomendações

Microsoft.Skills.Text.SentimentSkill

Última versão api disponível

Fim do suporte

Recomendações

Microsoft.Skills.Text.NamedEntityRecognitionSkill

Última versão api disponível

Fim do suporte

Recomendações

Consulte também

Comentários

Recursos adicionais