Migrar do Criador de FAQ para responder a perguntas personalizadas

Artigo
03/10/2024

Nota

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

Resposta a perguntas personalizada, um recurso da Linguagem de IA do Azure foi introduzida em maio de 2021 com vários novos recursos, incluindo relevância aprimorada usando um classificador de aprendizado profundo, respostas precisas e suporte de região de ponta a ponta. Cada projeto de resposta a perguntas personalizadas é equivalente a uma base de conhecimento no QnA Maker. Você pode migrar facilmente bases de conhecimento de um recurso do QnA Maker para projetos personalizados de resposta a perguntas dentro de um recurso de linguagem. Você também pode optar por migrar bases de conhecimento de vários recursos do QnA Maker para um recurso de idioma específico.

Para migrar com êxito as bases de conhecimento, a conta que executa a migração precisa de acesso do colaborador ao QnA Maker selecionado e ao recurso de idioma. Quando uma base de dados de conhecimento é migrada, os seguintes detalhes são copiados para o novo projeto de resposta a perguntas personalizadas:

Pares QnA, incluindo sugestões de aprendizagem ativa.
Sinónimos e resposta predefinida do recurso QnA Maker.
O nome da base de dados de conhecimento é copiado para o campo de descrição do projeto.

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

Etapas para migrar SDKs

Este Guia de Migração do SDK destina-se a ajudar na migração para a nova biblioteca de cliente de resposta a perguntas personalizada, Azure.AI.Language.QuestionAnswering, da antiga, Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker. Centra-se em comparações lado a lado para operações semelhantes entre os dois pacotes.

Etapas para migrar bases de conhecimento

Você pode seguir as etapas abaixo para migrar bases de conhecimento:

Crie um recurso linguístico com a resposta a perguntas personalizada ativada antecipadamente. Ao criar o recurso de idioma no portal do Azure, você verá a opção para habilitar a resposta a perguntas personalizadas. Quando selecionar essa opção e continuar, ser-lhe-ão solicitados os detalhes da Pesquisa do Azure para guardar as bases de conhecimento.
Se você quiser adicionar bases de conhecimento em vários idiomas ao seu recurso linguístico, visite Language Studio para criar seu primeiro projeto personalizado de resposta a perguntas e selecione a primeira opção, conforme mostrado abaixo. As configurações de idioma para o recurso de idioma podem ser especificadas somente ao criar um projeto. Se quiser migrar as bases de conhecimento existentes em um único 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. Uma caixa de diálogo será aberta para iniciar a migração.
Preencha os detalhes necessários para iniciar a migração. O locatário será selecionado automaticamente. Pode optar por mudar de inquilino.
Selecione o recurso QnA Maker, que contém as bases de dados de conhecimento a serem migradas.
Selecione o recurso de idioma para o qual você deseja migrar as bases de conhecimento. Você só poderá ver os recursos de idioma que têm a resposta personalizada a perguntas habilitada. A configuração de idioma para o recurso de idioma é exibida nas opções. Você não poderá migrar bases de conhecimento em vários idiomas dos recursos do QnA Maker para um recurso de idioma se sua configuração de idioma não for especificada.

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

Atenção

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
Levará alguns minutos para que a migração ocorra. Não cancele a migração enquanto ela estiver em andamento. Você pode navegar até os projetos migrados dentro do Language Studio após a migração.

Se alguma base de dados de conhecimento não conseguir migrar para projetos personalizados de resposta a perguntas, 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 base de dados de conhecimento vazia (KB).
- Você atingiu o limite para uma instância do Azure Search vinculada aos seus recursos de destino.
Depois de resolver esses erros, você pode executar novamente a migração.
A migração copiará apenas as instâncias de teste de suas bases de conhecimento. Quando a migração estiver concluída, você precisará implantar manualmente as bases de conhecimento para copiar o índice de teste para o índice de produção.