Importar de fontes de dadosImporting from data sources

Uma base de dados de conhecimento é composta por pares de pergunta e resposta trazidos por arquivos e URLs públicos.A knowledge base consists of question and answer pairs brought in by public URLs and files.

Locais de origem de dadosData source locations

O conteúdo é trazido para uma base de dados de conhecimento de uma fonte de dados.Content is brought into a knowledge base from a data source. Os locais de fonte de dados são URLs ou arquivos públicos, que não exigem autenticação.Data source locations are public URLs or files, which do not require authentication.

Os arquivos do SharePoint, protegidos com autenticação, são a exceção.SharePoint files, secured with authentication, are the exception. Os recursos do SharePoint precisam ser arquivos, não páginas da Web.SharePoint resources must be files, not web pages. Se a URL terminar com uma extensão da Web, como .ASPX, ela não será importada do SharePoint para o QnA Maker.If the URL ends with a web extension, such as .ASPX, it will not import into QnA Maker from SharePoint.

Conteúdo de bate-papoChit-chat content

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.The chit-chat content set is offered as a complete content data source in several languages and conversational styles. 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.This can be a starting point for your bot's personality, and it will save you the time and cost of writing them from scratch. Saiba como adicionar conteúdo de bate-papo à sua base de dados de conhecimento.Learn how to add chit-chat content to your knowledge base.

Formato de dados estruturados por meio de importaçãoStructured data format through import

Importar uma base de dados de conhecimento substitui o conteúdo da base de dados de conhecimento existente.Importing a knowledge base replaces the content of the existing knowledge base. A importação requer um arquivo .tsv estruturado que contenha perguntas e respostas.Import requires a structured .tsv file that contains questions and answers. 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.This information helps QnA Maker group the question-answer pairs and attribute them to a particular data source.

PerguntaQuestion RespostaAnswer FonteSource Metadados (1 chave: 1 valor)Metadata (1 key: 1 value)
Pergunta1Question1 Resposta1Answer1 Url1Url1 Key1:Value1 | Key2:Value2
Pergunta2Question2 Resposta2Answer2 EditorialEditorial Key:Value

Formato estruturado de várias rodadas por meio de importaçãoStructured multi-turn format through import

Você pode criar conversas com várias rodadas em um formato de arquivo .tsv.You can creating the multi-turn conversations in a .tsv file format. 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.The format provides you with the ability to create the multi-turn conversations by analyzing previous chat logs (with other processes, not using QnA Maker), then create the .tsv file through automation. Importe o arquivo para substituir a base de dados de conhecimento existente.Import the file to replace the existing knowledge base.

Modelo conceitual de três níveis de uma pergunta com várias rodadasConceptual model of 3 levels of multi-turn question

A coluna para um .tsv com várias rodadas, específica para várias rodadas, é Prompts.The column for a multi-turn .tsv, specific to multi-turn is Prompts. Um exemplo .tsv, mostrado no Excel, mostra as informações a serem incluídas para definir os filhos com várias rodadas:An example .tsv, shown in Excel, show the information to include to define the multi-turn children:

[
    {"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.The displayOrder is numeric and the displayText is text that shouldn't include markdown.

Exemplo de pergunta com várias rodadas, conforme mostrado no ExcelMulti-turn question example as shown in Excel

Exportar como exemploExport as example

Se você não tiver certeza de como representar seu par de pergunta e resposta no arquivo .tsv:If you are unsure how to represent your QnA pair in the .tsv file:

  • Usar este exemplo para download do GitHubUse this downloadable example from 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.Or create the pair in the QnA Maker portal, save, then export the knowledge base for an example of how to represent the pair.

Tipos de conteúdo de documentos que você pode adicionar a uma base de dados de conhecimentoContent types of documents you can add to a knowledge base

Os tipos de conteúdo incluem muitos documentos estruturados padrão, como PDF, DOC e TXT.Content types include many standard structured documents such as PDF, DOC, and TXT.

Tipos de dados de arquivo e URLFile and URL data types

A tabela a seguir resume os tipos de conteúdo e formatos de arquivo com suporte no QnA Maker.The table below summarizes the types of content and file formats that are supported by QnA Maker.

Tipo de FonteSource Type Tipo de conteúdoContent Type ExemplosExamples
URLURL Perguntas frequentesFAQs
(simples, com seções ou com uma página inicial de tópicos)(Flat, with sections or with a topics homepage)
Páginas de suporteSupport pages
(artigos de instrução de uma página, artigos de solução de problemas etc.)(Single page how-to articles, troubleshooting articles etc.)
Perguntas frequentes simples,Plain FAQ,
Perguntas frequentes com links,FAQ with links,
Perguntas frequentes com home page de tópicosFAQ with topics homepage
Artigo de suporteSupport article
PDF/DOCPDF / DOC Perguntas frequentes,FAQs,
Manual do Produto,Product Manual,
Folhetos,Brochures,
Papel,Paper,
Política de folheto,Flyer Policy,
Guia de suporte,Support guide,
QnA estruturado,Structured QnA,
etc.etc.
Sem várias rodadasWithout Multi-turn
QnA.docx estruturado,Structured QnA.docx,
Exemplo produto Manual.pdf,Sample Product Manual.pdf,
Exemplo semi-structured.docx,Sample semi-structured.docx,
Exemplo papel em branco.pdf,Sample white paper.pdf,

Várias rodadas:Multi-turn:
Surface Pro (docx)Surface Pro (docx)
Benefícios da Contoso (docx)Contoso Benefits (docx)
Benefícios da Contoso (pdf)Contoso Benefits (pdf)
*Excel*Excel Arquivo QnA estruturadoStructured QnA file
(incluindo suporte RTF, HTML)(including RTF, HTML support)
Sem várias rodadas:Without Multi-turn:
Exemplo de QnA FAQ.xlsSample QnA FAQ.xls

Várias rodadas:Multi-turn:
Perguntas frequentes simples estruturadas.xlsStructured simple FAQ.xls
Perguntas frequentes de laptop do Surface.xlsSurface laptop FAQ.xls
*TXT/TSV*TXT/TSV Arquivo QnA estruturadoStructured QnA file Exemplo de chit-chat.tsvSample 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:If you need authentication for your data source, consider the following methods to get that content into QnA Maker:

Conteúdo da URLURL content

Dois tipos de documentos podem ser importados por meio de URL no QnA Maker:Two types of documents can be imported via URL in QnA Maker:

  • URLs de perguntas frequentesFAQ URLs
  • URLs de suporteSupport URLs

Cada tipo indica um formato esperado.Each type indicates an expected format.

Conteúdo baseado em arquivoFile-based content

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.You can add files to a knowledge base from a public source, or your local file system, in the QnA Maker portal.

Diretrizes para formato de conteúdoContent format guidelines

Saiba mais sobre as diretrizes de formato para os diferentes arquivos.Learn more about the format guidelines for the different files.

Próximas etapasNext steps

Saiba como editar QnAs.Learn how to edit QnAs.