Importar de fontes de dados
Uma base de dados de conhecimento é composta por pares de pergunta e resposta trazidos por arquivos e URLs públicos.
Observação
O serviço de QnA Maker está sendo desativado no dia 31 de março de 2025. Uma versão mais recente da funcionalidade de perguntas e respostas agora está disponível como parte da Linguagem de IA do Azure. Para saber mais sobre o recurso de respostas às perguntas no Serviço de Linguagem, confira respostas às perguntas. A partir de 1º de outubro de 2022, você não poderá criar novos recursos de QnA Maker. Para obter informações sobre como migrar bases de dados de conhecimento do QnA Maker existentes para responder perguntas, consulte o guia de migração.
Locais de origem de dados
O conteúdo é trazido para uma base de dados de conhecimento de uma fonte de dados. Os locais de fonte de dados são URLs ou arquivos públicos, que não exigem autenticação.
Os arquivos do SharePoint, protegidos com autenticação, são a exceção. Os recursos do SharePoint precisam ser arquivos, não páginas da Web.
O QnA Maker dá suporte a URLs públicas que terminem com uma extensão da Web .ASPX, que não são protegidas por autenticação.
Conteúdo de bate-papo
O conjunto de conteúdo de bate-papo é oferecido como uma fonte de dados de conteúdo completa em vários idiomas e estilos conversacionais. Esse pode ser um ponto de partida para a personalidade do seu bot, o que economizará o tempo e o custo de escrevê-la do zero. Saiba como adicionar conteúdo de bate-papo à sua base de dados de conhecimento.
Formato de dados estruturados por meio de importação
Importar uma base de dados de conhecimento substitui o conteúdo da base de dados de conhecimento existente. A importação requer um arquivo .tsv estruturado que contenha perguntas e respostas. Essas informações ajudam o QnA Maker a agrupar os pares de resposta de pergunta e atribuí-los a uma fonte de dados específico.
| Pergunta | Resposta | Fonte | Metadados (1 chave: 1 valor) |
|---|---|---|---|
| Pergunta1 | Resposta1 | Url1 | Key1:Value1 | Key2:Value2 |
| Pergunta2 | Resposta2 | Editorial | Key:Value |
Formato estruturado de várias rodadas por meio de importação
Você pode criar conversas com várias rodadas em um formato de arquivo .tsv. O formato fornece a capacidade de criar conversas com várias rodadas analisando os logs de chat anteriores (com outros processos, não usando o QnA Maker) e criar o arquivo .tsv por meio da automação. Importe o arquivo para substituir a base de dados de conhecimento existente.
A coluna para um .tsv com várias rodadas, específica para várias rodadas, é Prompts. Um exemplo .tsv, mostrado no Excel, mostra as informações a serem incluídas para definir os filhos com várias rodadas:
[
{"displayOrder":0,"qnaId":2,"displayText":"Level 2 Question A"},
{"displayOrder":0,"qnaId":3,"displayText":"Level 2 - Question B"}
]
displayOrder é numérico e displayText é um texto que não deve incluir Markdown.
Exportar como exemplo
Se você não tiver certeza de como representar seu par de pergunta e resposta no arquivo .tsv:
- Usar este exemplo para download do GitHub
- Ou crie o par no portal do QnA Maker, salve e exporte a base de dados de conhecimento para obter um exemplo de como representar o par.
Formato de dados não estruturados
Você também pode criar uma base de dados de conhecimento com base no conteúdo não estruturado importado através de um arquivo. Atualmente, essa funcionalidade está disponível apenas através do upload de documentos para documentos em qualquer um dos formatos de arquivo com suporte.
Importante
O suporte para conteúdo não estruturado por meio do upload de arquivo está disponível apenas em Respostas às perguntas.
Tipos de conteúdo de documentos que você pode adicionar a uma base de dados de conhecimento
Os tipos de conteúdo incluem muitos documentos estruturados padrão, como PDF, DOC e TXT.
Tipos de dados de arquivo e URL
A tabela a seguir resume os tipos de conteúdo e formatos de arquivo com suporte no QnA Maker.
| Tipo de Fonte | Tipo de conteúdo | Exemplos |
|---|---|---|
| URL | Perguntas frequentes (simples, com seções ou com uma página inicial de tópicos) Páginas de suporte (artigos de instrução de uma página, artigos de solução de problemas etc.) |
Perguntas frequentes simples, Perguntas frequentes com links, Perguntas frequentes com home page de tópicos Artigo de suporte |
| PDF/DOC | Perguntas frequentes, Manual do Produto, Folhetos, Papel, Política de folheto, Guia de suporte, QnA estruturado, etc. |
Sem várias rodadas QnA.docx estruturado, Exemplo produto Manual.pdf, Exemplo semi-structured.docx, Exemplo papel em branco.pdf, Blog.pdf não estruturado, White paper.pdf não estruturado Várias rodadas: Surface Pro (docx) Benefícios da Contoso (docx) Benefícios da Contoso (pdf) |
| *Excel | Arquivo QnA estruturado (incluindo suporte RTF, HTML) |
Sem várias rodadas: Exemplo de QnA FAQ.xls Várias rodadas: Perguntas frequentes simples estruturadas.xls Perguntas frequentes de laptop do Surface.xls |
| *TXT/TSV | Arquivo QnA estruturado | Exemplo de chit-chat.tsv |
Se você precisar de autenticação para sua fonte de dados, considere os seguintes métodos para inserir esse conteúdo no QnA Maker:
- Baixar o arquivo manualmente e importá-lo no QnA Maker
- Adicionar o arquivo da localização do SharePoint autenticada
Conteúdo da URL
Dois tipos de documentos podem ser importados por meio de URL no QnA Maker:
- URLs de perguntas frequentes
- URLs de suporte
Cada tipo indica um formato esperado.
Conteúdo baseado em arquivo
Você pode adicionar arquivos a uma base de dados de conhecimento de uma fonte pública ou do seu sistema de arquivos local, no portal do QnA Maker.
Diretrizes para formato de conteúdo
Saiba mais sobre as diretrizes de formato para os diferentes arquivos.
Próximas etapas
Saiba como editar QnAs.