Migrar do QnA Maker para as respostas às perguntas personalizadas

Artigo
12/19/2023

Observação

Você também pode migrar para o OpenAI do Azure.

As respostas às perguntas personalizadas, um recurso da Linguagem de IA do Azure foi introduzido em maio de 2021 com diversas novas funcionalidades, incluindo relevância avançada usando um classificador de aprendizado profundo, respostas precisas e suporte a região de ponta a ponta. Cada projeto das respostas às perguntas personalizadas é equivalente a uma base de dados de conhecimento no QnA Maker. Você pode migrar facilmente as bases de dados de conhecimento de um recurso do QnA Maker para projetos das respostas às perguntas personalizadas dentro de um recurso de idioma. Você também pode optar por migrar bases de dados de conhecimento de vários recursos do QnA Maker para um recurso de idioma específico.

Para migrar com êxito as bases de dados de conhecimento, a conta que executa a migração precisa ter acesso de colaborador ao QnA Maker e ao recurso de idioma selecionado. Quando uma base de dados de conhecimento é migrada, as seguintes informações são copiadas para o novo projeto de respostas às perguntas personalizadas:

Pares de pergunta e resposta, incluindo sugestões de aprendizado ativo.
Sinônimos e resposta padrão do recurso do QnA Maker.
O nome da base de dados de conhecimento é copiado para o campo de descrição do projeto.

Configurações no nível do recurso, como o controle de acesso baseado em função (RBAC), não são migradas para o novo recurso. Essas configurações precisariam ser reconfiguradas no recurso de idioma após a migração. Você também precisará reabilitar a análise para o recurso de idioma.

Etapas para migrar os SDKs

Esse Guia de Migração do SDK destina-se a ajudar na migração para a nova biblioteca de clientes de respostas a perguntas personalizadas, Azure.AI.Language.QuestionAnswering, da antiga Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker. Ele se concentrará em comparações lado a lado para operações semelhantes entre os dois pacotes.

Etapas para migrar bases de dados de conhecimento

Siga estas etapas para migrar as bases de dados de conhecimento:

Crie com antecedência um recurso de idioma com as respostas às perguntas personalizadas habilitadas. Ao criar o recurso de idioma no portal do Azure, você verá a opção de habilitar as respostas às perguntas personalizadas. Quando selecionar essa opção e continuar, você precisará fornecer detalhes do Azure Search para salvar as bases de dados de conhecimento.
Se quiser adicionar bases de dados de conhecimento em vários idiomas a um recurso de idioma, visite o Language Studio para criar seu primeiro projeto das respostas às perguntas personalizadas e selecione a primeira opção, conforme mostrado abaixo. As configurações de idioma do recurso de idioma só podem ser especificadas no momento da criação do projeto. Se quiser migrar bases de dados de conhecimento existentes em um só idioma para o recurso de idioma, ignore esta etapa.
Visite https://www.qnamaker.ai e selecione Iniciar migração na nota de migração na página da base de dados de conhecimento. Será aberta uma caixa de diálogo para iniciar a migração.
Preencha os detalhes necessários para iniciar a migração. O locatário será selecionado automaticamente. Você pode optar por trocá-lo.
Selecione o recurso do QnA Maker que contém as bases de dados de conhecimento a serem migradas.
Selecione o recurso de idioma para o qual deseja migrar as bases de dados de conhecimento. Você verá somente os recursos de idioma que têm as respostas às perguntas personalizadas habilitadas. A configuração de idioma do recurso de idioma é exibida nas opções. Você não poderá migrar bases de dados de conhecimento em vários idiomas de recursos do QnA Maker para um recurso de idioma se a configuração de idioma dele não estiver especificada.

Se quiser migrar bases de dados de conhecimento em vários idiomas para o recurso de idioma, você precisará habilitar a configuração de vários idiomas ao criar o primeiro projeto de respostas às perguntas personalizadas para o recurso de idioma. Faça isso seguindo as instruções na etapa 2. Se a configuração de idioma do recurso de idioma não for especificada, será atribuído a ela o idioma do recurso do QnA Maker selecionado.
Selecione todas as bases de dados de conhecimento que deseja migrar > escolha Avançar.
Você pode revisar as bases de dados de conhecimento que planeja migrar. Pode haver erros de validação nos nomes dos projetos, pois seguimos regras de validação mais rígidas para projetos das respostas às perguntas personalizadas. Para resolver esses erros que ocorrem devido a caracteres inválidos, marque a caixa de seleção (em vermelho) e clique em Avançar. Este é um método de um clique para substituir os caracteres problemáticos do nome pelos caracteres aceitos. Se houver uma duplicata, um novo nome de projeto exclusivo será gerado pelo sistema.

Cuidado

Se você migrar uma base de dados de conhecimento com o mesmo nome de um projeto que já existe no recurso de idioma de destino, o conteúdo do projeto será substituído pelo conteúdo da base de dados de conhecimento selecionada.
Depois de resolver os erros de validação, selecione Iniciar migração
A migração levará alguns minutos. Não cancele-a enquanto estiver em andamento. Você pode navegar até os projetos migrados no Language Studio após a migração.

Se a migração de alguma base de dados de conhecimento para projetos de respostas às perguntas falhar, um erro será exibido. Os erros de migração mais comuns ocorrem quando:
- Os recursos de origem e de destino são inválidos.
- Você está tentando migrar uma KB (base de dados de conhecimento) vazia.
- Você atingiu o limite de uma instância do Azure Search vinculada aos recursos de destino.
Após resolver esses erros, você pode executar a migração novamente.
Ela copiará apenas as instâncias de teste de suas bases de dados de conhecimento. Quando a migração for concluída, você precisará implantar manualmente as bases de dados de conhecimento para copiar o índice de teste para o índice de produção.