Ciclo de vida da base de conhecimento no QnA Maker

O QnA Maker aprende melhor em um ciclo iterativo de alterações de modelo, exemplos de enunciação, publicação e coleta de dados de consultas de ponto final.

Authoring cycle

Nota

O serviço QnA Maker será desativado no dia 31 de março de 2025. Uma versão mais recente do recurso de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para obter os recursos de resposta a perguntas no Serviço Linguístico, consulte Resposta a perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos do QnA Maker. Para obter informações sobre como migrar bases de conhecimento existentes do QnA Maker para responder a perguntas, consulte o guia de migração.

Criar uma base de dados de conhecimento do Criador de FAQ

O ponto de extremidade da base de conhecimento (KB) do QnA Maker fornece uma resposta de melhor correspondência para uma consulta de usuário com base no conteúdo do KB. Criar uma base de dados de conhecimento é uma ação única para configurar um repositório de conteúdo de perguntas, respostas e metadados associados. Um KB pode ser criado rastreando conteúdo pré-existente, como as seguintes fontes:

  • Páginas de FAQ
  • Manuais do produto
  • Pares Q-A

Saiba como criar uma base de dados de conhecimento.

Testando e atualizando a base de conhecimento

A base de conhecimento está pronta para teste assim que for preenchida com conteúdo, seja editorialmente ou através de extração automática. Os testes interativos podem ser feitos no portal QnA Maker, através do painel Teste . Você insere consultas comuns do usuário. Em seguida, você verifica se as respostas retornaram com a resposta correta e uma pontuação de confiança suficiente.

  • Para corrigir pontuações de confiança baixas: adicione perguntas alternativas.
  • Quando uma consulta retorna incorretamente a resposta padrão: adicione novas respostas à pergunta correta.

Esse ciclo apertado de atualização de teste continua até que você esteja satisfeito com os resultados. Saiba como testar a sua base de conhecimentos.

Para KBs grandes, use testes automatizados com a API generateAnswer e a propriedade body, que consulta a testisTest base de dados de conhecimento em vez da base de dados de conhecimento publicada.

{
  "question": "example question",
  "top": 3,
  "userId": "Default",
  "isTest": true
}

Publicar a base de dados de conhecimento

Depois de terminar de testar a base de conhecimento, você pode publicá-la. Publicar envia a versão mais recente da base de dados de conhecimento testada para um índice dedicado do Azure AI Search que representa a base de dados de conhecimento publicada . Também cria um ponto final que pode ser chamado na sua aplicação ou chatbot.

Devido à ação de publicação, quaisquer alterações adicionais feitas na versão de teste da base de dados de conhecimento não afetam a versão publicada. A versão publicada pode estar ativa em um aplicativo de produção.

Cada uma dessas bases de conhecimento pode ser direcionada para testes separadamente. Usando as APIs, você pode direcionar a versão de teste da base de dados de conhecimento com isTest a propriedade body na chamada generateAnswer.

Saiba como publicar sua base de conhecimento.

Monitorizar a utilização

Para poder registrar os logs de bate-papo do seu serviço, você precisará habilitar o Application Insights ao criar o serviço QnA Maker.

Você pode obter várias análises do uso do seu serviço. Saiba mais sobre como usar insights de aplicativos para obter análises para seu serviço QnA Maker.

Com base no que você aprende com suas análises, faça atualizações apropriadas em sua base de conhecimento.

Controle de versão para dados em sua base de dados de conhecimento

O controle de versão para dados é fornecido por meio dos recursos de importação/exportação na página Configurações no portal do QnA Maker.

Você pode fazer backup de uma base de dados de conhecimento exportando a base de dados de conhecimento, em qualquer um dos .tsv formatos .xls . Uma vez exportado, inclua esse arquivo como parte de sua verificação regular de controle do código-fonte.

Quando você precisa voltar para uma versão específica, você precisa importar esse arquivo do seu sistema local. Uma base de dados de conhecimento exportada só deve ser usada por meio de importação na página Configurações. Ele não pode ser usado como uma fonte de dados de arquivo ou documento URL. Isso substituirá as perguntas e respostas atualmente na base de dados de conhecimento pelo conteúdo do arquivo importado.

Base de conhecimento de teste e produção

Uma base de conhecimento é o repositório de perguntas e conjuntos de respostas criados, mantidos e usados por meio do QnA Maker. Cada recurso do QnA Maker pode conter várias bases de conhecimento.

Uma base de dados de conhecimento tem dois estados: teste e publicação.

Testar base de dados de conhecimento

A base de dados de conhecimento do teste é a versão atualmente editada e salva. A versão de teste foi testada quanto à precisão e à completude das respostas. As alterações feitas na base de dados de conhecimento de teste não afetam o usuário final do seu aplicativo ou bot de chat. A base de dados de conhecimento de teste é conhecida como test na solicitação HTTP. O test conhecimento está disponível com o painel de teste interativo do portal do QnA Maker.

Base de conhecimento de produção

A base de dados de conhecimento publicada é a versão usada em seu bot de chat ou aplicativo. A publicação de uma base de dados de conhecimento coloca o conteúdo de sua versão de teste em sua versão publicada. A base de dados de conhecimento publicada é a versão que o aplicativo usa por meio do ponto de extremidade. Certifique-se de que o conteúdo está correto e bem testado. A base de dados de conhecimento publicada é conhecida como prod na solicitação HTTP.

Próximos passos