Editar pares de QnA na sua base de dados de conhecimento
O QnA Maker permite que você gerencie o conteúdo de sua base de conhecimento, fornecendo uma experiência de edição fácil de usar.
Os pares QnA são adicionados a partir de uma fonte de dados, como um arquivo ou URL, ou adicionados como uma fonte editorial. Uma fonte editorial indica que o par QnA foi adicionado manualmente no portal QnA. Todos os pares QnA estão disponíveis para edição.
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.
Pares de perguntas e respostas
Uma base de conhecimento consiste em pares de perguntas e respostas (QnA). Cada par tem uma resposta e um par contém todas as informações associadas a essa resposta. Uma resposta pode se assemelhar vagamente a uma linha de banco de dados ou a uma instância de estrutura de dados. As configurações necessárias em um par de perguntas e respostas (QnA) são:
- uma pergunta - texto da consulta do usuário, usado para o aprendizado de máquina do QnA Maker, para alinhar com o texto da pergunta do usuário com palavras diferentes, mas a mesma resposta
- A resposta - a resposta do par é a resposta que é retornada quando uma consulta de usuário é correspondida com a pergunta associada
Cada par é representado por um ID.
As configurações opcionais para um par incluem:
- Formas alternativas da pergunta - isso ajuda o QnA Maker a retornar a resposta correta para uma maior variedade de frases de perguntas
- Metadados: Os metadados são marcas associadas a um par QnA e são representados como pares chave-valor. As tags de metadados são usadas para filtrar pares de QnA e limitar o conjunto no qual a correspondência de consulta é executada.
- Prompts de várias voltas, usados para continuar uma conversa de várias voltas
Adicionar um par QnA editorial
Se você não tiver conteúdo pré-existente para preencher a base de dados de conhecimento, poderá adicionar pares QnA editorialmente no portal do QnA Maker.
Entre no portal QnA e selecione a base de dados de conhecimento à qual adicionar o par QnA.
Na página EDIT da base de dados de conhecimento, selecione Adicionar par QnA para adicionar um novo par QnA.
Na nova linha de pares QnA, adicione os campos de pergunta e resposta necessários. Os outros campos são opcionais. Todos os campos podem ser alterados a qualquer momento.
Opcionalmente, adicione frases alternativas. Fraseado alternativo é qualquer forma da pergunta que é significativamente diferente da pergunta original, mas deve fornecer a mesma resposta.
Quando sua base de conhecimento é publicada e você tem o aprendizado ativo ativado, o QnA Maker coleta opções de fraseado alternativo para você aceitar. Essas escolhas são selecionadas para aumentar a precisão da previsão.
Opcionalmente, adicione metadados. Para exibir metadados, selecione Exibir opções no menu de contexto. Os metadados fornecem filtros para as respostas que o aplicativo cliente, como um bot de chat, fornece.
Opcionalmente, adicione prompts de acompanhamento. Os prompts de acompanhamento fornecem caminhos de conversa adicionais para o aplicativo cliente apresentar ao usuário.
Selecione Salvar e treinar para ver as previsões, incluindo o novo par QnA.
Edição rich-text para resposta
A edição rich-text do texto da resposta oferece um estilo de marcação a partir de uma barra de ferramentas simples.
Selecione a área de texto para uma resposta, a barra de ferramentas do editor de rich text é exibida na linha do par QnA.
Qualquer texto já na resposta é exibido corretamente, pois o usuário o verá de um bot.
Edite o texto. Selecione recursos de formatação na barra de ferramentas de edição de rich text ou use o recurso de alternância para alternar para a sintaxe de marcação.
Recursos do editor de rich text Atalho de teclado Alterne entre editor de rich text e markdown. </>CTRL+M Negrito. B CTR+LB Itálico, indicado com um I em itálico CTRL+I Lista não ordenada Lista ordenada Estilo de parágrafo Imagem - adicione uma imagem disponível a partir de um URL público. CTRL+G Adicione um link ao URL disponível publicamente. CTRL+K Emoticon - adicione a partir de uma seleção de emoticons. CTRL+E Menu avançado - desfazer CTRL+Z Menu avançado - refazer CTRL+Y Adicione uma imagem à resposta usando o ícone Imagem na barra de ferramentas rich-text. O editor in-loco precisa do URL da imagem acessível publicamente e do texto alternativo para a imagem.
Adicione um link a um URL selecionando o texto na resposta e, em seguida, selecionando o ícone Link na barra de ferramentas ou selecionando o ícone Link na barra de ferramentas e inserindo novo texto e o URL.
Editar um par QnA
Qualquer campo em qualquer par QnA pode ser editado, independentemente da fonte de dados original. Alguns campos podem não estar visíveis devido às suas configurações atuais de Opções de Visualização, encontradas na barra de ferramentas de contexto.
Excluir um par QnA
Para excluir um QnA, clique no ícone de exclusão na extremidade direita da linha QnA. Esta é uma operação permanente. Não pode ser desfeito. Considere exportar seu KB da página Publicar antes de excluir pares.
Localizar o ID do par QnA
Se você precisar encontrar o ID do par QnA, você pode encontrá-lo em dois lugares:
- Passe o cursor sobre o ícone de exclusão na linha de pares QnA em que você está interessado. O texto focalizado inclui o ID do par QnA.
- Exporte a base de conhecimento. Cada par QnA na base de dados de conhecimento inclui o ID do par QnA.
Adicionar perguntas alternativas
Adicione perguntas alternativas a um par QnA existente para melhorar a probabilidade de uma correspondência com uma consulta de usuário.
Vinculando pares QnA
A vinculação de pares QnA é fornecida com prompts de acompanhamento. Esta é uma conexão lógica entre pares QnA, gerenciados no nível da base de conhecimento. Você pode editar prompts de acompanhamento no portal do QnA Maker.
Não é possível vincular pares QnA nos metadados da resposta.
Adicionar metadados
Adicione pares de metadados selecionando primeiro as opções de exibição e, em seguida, selecionando Mostrar metadados. Isso exibe a coluna de metadados. Em seguida, selecione o + sinal para adicionar um par de metadados. Este par consiste em uma chave e um valor.
Saiba mais sobre metadados no início rápido do portal do QnA Maker para metadados:
Salvar alterações nos pares QnA
Selecione periodicamente Salvar e treinar depois de fazer edições para evitar a perda de alterações.
Quando usar edição rich-text versus markdown
A edição rich-text de respostas permite que você, como autor, use uma barra de ferramentas de formatação para selecionar e formatar texto rapidamente.
Markdown é uma ferramenta melhor quando você precisa gerar automaticamente conteúdo para criar bases de conhecimento a serem importadas como parte de um pipeline de CI/CD ou para testes em lote.
Editando sua base de dados de conhecimento localmente
Depois que uma base de dados de conhecimento é criada, é recomendável que você faça edições no texto da base de dados de conhecimento no portal do QnA Maker, em vez de exportar e reimportar por meio de arquivos locais. No entanto, pode haver momentos em que você precise editar uma base de dados de conhecimento localmente.
Exporte a base de dados de conhecimento da página Configurações e edite a base de dados de conhecimento com o Microsoft Excel. Se você optar por usar outro aplicativo para editar o arquivo exportado, o aplicativo pode introduzir erros de sintaxe porque não é totalmente compatível com TSV. Os arquivos TSV do Microsoft Excel geralmente não introduzem erros de formatação.
Depois de concluir as edições, reimporte o arquivo TSV da página Configurações . Isso substituirá completamente a base de conhecimento atual pela base de conhecimento importada.