Migrar do Criador de FAQ para responder a perguntas personalizadas

Resposta a perguntas personalizadas, uma funcionalidade do Azure Cognitive Service for Language foi introduzida em maio de 2021 com várias novas capacidades, incluindo relevância reforçada usando um ranker de aprendizagem profunda, respostas precisas e suporte de região de ponta a ponta. Cada projeto de resposta a perguntas personalizadas equivale a uma base de conhecimento na QnA Maker. Você pode facilmente migrar bases de conhecimento de um recurso QnA Maker para perguntas personalizadas responder projetos dentro de um recurso de idioma. Também pode optar por migrar bases de conhecimento de vários recursos do QnA Maker para um recurso linguístico específico.

Para migrar com sucesso bases de conhecimento, a conta que executa a migração necessita de acesso do contribuinte ao Fabricante QnA selecionado e ao recurso linguístico. Quando uma base de conhecimento é migrada, os seguintes detalhes são copiados para o novo projeto de resposta à pergunta personalizada:

  • Pares QNA incluindo sugestões de aprendizagem ativa.
  • Sinônios e resposta padrão do recurso QnA Maker.
  • O nome base do conhecimento é copiado para o campo de descrição do projeto.

As definições de nível de recursos, tais como o controlo de acesso baseado em funções (RBAC) não são migradas para o novo recurso. Estas definições de nível de recursos teriam de ser reconfiguradas para a migração pós-recursos de recursos linguísticos. Também terá de voltar a ativar a análise para o recurso linguístico.

Passos para migrar SDKs

Este Guia de Migração SDK destina-se a ajudar na migração para a nova biblioteca de clientes answering questioning, Azure.AI.Language.QuestionAnswering, do antigo, Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker. Centrar-se-á em comparações lado a lado para operações semelhantes entre os dois pacotes.

Passos para migrar bases de conhecimento

Pode seguir os passos abaixo para migrar bases de conhecimento:

  1. Crie um recurso de idioma com resposta de pergunta personalizada ativada com antecedência. Ao criar o recurso idioma no portal Azure, verá a opção de ativar a resposta de perguntas personalizadas. Quando selecionar essa opção e prosseguir, ser-lhe-á pedido que lhe sejam pedidos detalhes da Pesquisa Azure para guardar as bases de conhecimento.

  2. Se pretender adicionar bases de conhecimento em vários idiomas ao seu recurso de idioma, visite o Language Studio para criar o seu primeiro projeto de resposta a perguntas personalizadas e selecione a primeira opção como mostrado abaixo. As definições linguísticas para o recurso linguístico só podem ser especificadas quando se cria um projeto. Se quiser migrar as bases de conhecimento existentes numa única língua para o recurso linguístico, pode saltar este passo.

    Screenshot of choose language UI screen

  3. Visite https://www.qnamaker.ai e selecione Iniciar Migração na nota de migração na página base do conhecimento. Abrir-se-á uma caixa de diálogo para iniciar a migração.

    Start Migration button that appears in a banner on qnamaker.ai

  4. Preencha os detalhes necessários para iniciar a migração. O inquilino será selecionado automaticamente. Pode escolher trocar o inquilino.

    Migrate QnAMaker with red selection box around the tenant selection option

  5. Selecione o recurso QnA Maker, que contém as bases de conhecimento a migrar.

    Migrate QnAMaker with red selection box around the QnAMaker resource selection option

  6. Selecione o recurso linguístico para o qual pretende migrar as bases de conhecimento. Só poderá ver os recursos linguísticos que têm a resposta personalizada habilitada. A definição de idioma para o recurso idioma é apresentada nas opções. Não será capaz de migrar bases de conhecimento em várias línguas, desde os recursos do QnA Maker para um recurso linguístico se a sua definição linguística não for especificada.

    Migrate QnAMaker with red selection box around the language resource option currently selected resource contains the information that language is unspecified

    Se pretender migrar bases de conhecimento em várias línguas para o recurso idioma, deve ativar a definição de linguagem múltipla ao criar o primeiro projeto de resposta de perguntas personalizadas para o recurso idioma. Pode fazê-lo seguindo as instruções no passo nº 2. Se a definição de idioma para o recurso idioma não for especificada, é-lhe atribuída a língua do recurso QnA Maker selecionado.

  7. Selecione todas as bases de conhecimento que deseja migrar selecione >Next.

    Migrate QnAMaker with red selection box around the knowledge base selection option with a drop-down displaying three knowledge base names

  8. Pode rever as bases de conhecimento que pretende migrar. Pode haver alguns erros de validação em nomes de projetos à medida que seguimos regras de validação mais rigorosas para projetos de resposta a perguntas personalizadas. Para resolver estes erros que ocorrem devido a caracteres inválidos, selecione a caixa de verificação (a vermelho) e clique em Seguinte. Este é um método de um clique para substituir os caracteres problemáticos no nome pelos caracteres aceites. Se houver uma duplicata, um novo nome único do projeto é gerado pelo sistema.

    Atenção

    Se migrar uma base de conhecimento com o mesmo nome de um projeto que já existe no recurso idioma-alvo, o conteúdo do projeto será ultrapassado pelo conteúdo da base de conhecimentos selecionada.

    Screenshot of an error message starting project names can't contain special characters

  9. Depois de resolver os erros de validação, selecione Iniciar a migração

    Screenshot with special characters removed

  10. Levará alguns minutos para que a migração ocorra. Não cancele a migração enquanto estiver em curso. Você pode navegar para os projetos migrados dentro do Language Studio pós migração.

    Screenshot of successfully migrated knowledge bases with information that you can publish by using Language Studio

    Se alguma base de conhecimento não migrar para projetos de resposta a perguntas personalizadas, será apresentado um erro. Os erros de migração mais comuns ocorrem quando:

    • A sua fonte e os seus recursos-alvo são inválidos.
    • Está a tentar migrar uma base de conhecimento vazia (KB).
    • Atingiu o limite de uma instância de pesquisa Azure ligada aos recursos-alvo.

    Screenshot of a failed migration with an example error

    Assim que resolver estes erros, pode repetir a migração.

  11. A migração só copiará os casos de teste das suas bases de conhecimento. Uma vez concluída a sua migração, terá de implantar manualmente as bases de conhecimento para copiar o índice de teste para o índice de produção.

Passos seguintes