Diretrizes de formato para respostas a perguntas personalizadas
Examine as diretrizes a seguir para obter os melhores resultados para seu conteúdo.
Considerações de formatação
Depois de importar um arquivo ou URL, a resposta a perguntas personalizadas converte e armazena seu conteúdo no formato markdown. O processo de conversão adiciona novas linhas no texto, como \n\n
. Um conhecimento do formato Markdown ajuda você a entender o conteúdo convertido e gerenciar o conteúdo de seu projeto.
Se você adicionar ou editar seu conteúdo diretamente em seu projeto, use a formatação Markdown para criar conteúdo de rich text ou alterar o conteúdo do formato Markdown que já está na resposta. A resposta a perguntas personalizadas oferece suporte a grande parte do formato de marcação para trazer recursos de rich text ao seu conteúdo. No entanto, o aplicativo cliente, como um chatbot, pode não dar suporte ao mesmo conjunto de formatos Markdown. É importante testar a exibição de respostas do aplicativo cliente.
Formatação básica de documentos
A resposta personalizada à pergunta identifica seções e subseções e relacionamentos no arquivo com base em pistas visuais como:
- tamanho da fonte
- estilo da fonte
- numeração
- cores
Observação
Não há suporte para a extração de imagens de documentos carregados no momento.
Manuais de produtos
Normalmente, um manual é o material de diretrizes que acompanha um produto. Ele ajuda o usuário a configurar, usar, manter e solucionar problemas do produto. Quando a resposta a perguntas personalizadas processa um manual, ela extrai os títulos e subtítulos como perguntas e o conteúdo subsequente como respostas. Veja um exemplo aqui.
Abaixo está um exemplo de um manual com uma página de índice e conteúdo hierárquico
Observação
A extração funciona melhor em manuais com uma tabela de conteúdo e/ou uma página de índice e uma estrutura clara com cabeçalhos hierárquicos.
Brochuras, diretrizes, documentos e outros arquivos
Muitos outros tipos de documentos também podem ser processados para gerar pares de respostas às perguntas, contanto que tenham uma estrutura e um layout claros. Eles incluem: brochuras, diretrizes, relatórios, white papers, artigos científicos, políticas, livros etc. Confira um exemplo aqui.
Abaixo está um exemplo de um documento semiestruturado sem um índice:
Suporte a documentos não estruturados
Agora, as respostas às perguntas personalizadas dão suporte a documentos não estruturados. Um documento que não tem seu conteúdo organizado em uma maneira hierárquica bem definida, não tem uma estrutura definida ou tem seu fluxo de conteúdo livre, pode ser considerado um documento não estruturado.
Abaixo está um exemplo de um documento PDF não estruturado:
Observação
Os pares de perguntas e respostas não são extraídos na guia "Editar fontes" das fontes não estruturadas.
Importante
O suporte para arquivo/conteúdo não estruturado está disponível apenas na resposta a perguntas personalizadas.
Documento estruturado de resposta a perguntas personalizadas
O formato para respostas-perguntas estruturado em arquivos DOC é na forma de perguntas e respostas alternadas por linha, uma pergunta por linha seguida pela respectiva resposta na linha seguinte, conforme mostrado abaixo:
Question1
Answer1
Question2
Answer2
Abaixo está um exemplo de um documento estruturado de resposta a perguntas personalizadas:
Arquivos TXT, TSV e XLS Estruturados
A resposta de pergunta personalizada na forma de arquivos .txt estruturados, .tsv ou .xls também pode ser carregada para responder a perguntas personalizadas para criar ou aumentar um projeto. Podem ser texto sem formatação ou ter conteúdo em RTF ou HTML. Os pares de respostas às perguntas têm um campo de metadados opcional que pode ser usado para agrupá-los em categorias.
Pergunta | Resposta | Metadados (1 chave: 1 valor) |
---|---|---|
Pergunta1 | Resposta1 | Key1:Value1 | Key2:Value2 |
Pergunta2 | Resposta2 | Key:Value |
As colunas adicionais no arquivo de origem são ignoradas.
Formato de dados estruturados por meio de importação
A importação de um projeto substitui o conteúdo do projeto existente. A importação requer um arquivo .tsv estruturado que contenha informações de fonte de dados. Essas informações ajudam a agrupar os pares de respostas às perguntas e a atribuí-los a uma fonte de dados específica. Os pares de respostas às perguntas têm um campo de metadados opcional que pode ser usado para agrupá-los em categorias. O formato de importação precisa ser semelhante ao formato de base de dados de conhecimento exportado.
Pergunta | Resposta | Fonte | Metadados (1 chave: 1 valor) | QnaId |
---|---|---|---|---|
Pergunta1 | Resposta1 | Url1 | Key1:Value1 | Key2:Value2 |
QnaId 1 |
Pergunta2 | Resposta2 | Editorial | Key:Value |
QnaId 2 |
Formatação de documento de várias rodadas
- Usar títulos e subtítulos para denotar a hierarquia. Por exemplo, você pode usar h1 para denotar a resposta da pergunta pai e h2 para denotar a resposta da pergunta que deve ser tomada como prompt. Use títulos menores para indicar a hierarquia subsequente. Não use estilo, cor ou algum outro mecanismo para sugerir estrutura em seu documento, a resposta a perguntas personalizadas não extrairá os prompts de várias voltas.
- O primeiro caractere do título deve ser maiúsculo.
- Não termine um título com um ponto de interrogação,
?
.
Documentos de exemplo:
Surface Pro (docx)
Benefícios da Contoso (docx)
Benefícios da Contoso (pdf)
URLs de perguntas frequentes
A resposta a perguntas personalizadas pode oferecer suporte a páginas da Web de perguntas frequentes em três formas diferentes:
- Páginas de perguntas frequentes simples
- Páginas de perguntas frequentes com links
- Páginas de perguntas frequentes com uma página inicial de tópicos
Páginas de perguntas frequentes simples
Este é o tipo mais comum de página de perguntas frequentes em que as respostas a seguem imediatamente às perguntas na mesma página.
Páginas de perguntas frequentes com links
Nesse tipo de página de perguntas frequentes, as perguntas são agregadas e vinculadas a respostas em seções diferentes da mesma página ou em páginas diferentes.
Abaixo está um exemplo de uma página de perguntas frequentes com links nas seções que estão na mesma página:
Links da página Tópicos pai para páginas de respostas filho
Esse tipo de perguntas frequentes tem uma página Tópicos em que cada tópico está vinculado a um conjunto correspondente de perguntas e respostas em uma página diferente. A resposta à pergunta rastreia todas as páginas vinculadas para extrair as perguntas e respostas correspondentes.
Abaixo está um exemplo de uma página Tópicos com links para seções de perguntas frequentes em páginas diferentes.
URLs de suporte
A resposta a perguntas personalizadas pode processar páginas da Web de suporte semiestruturadas, como artigos da Web que descreveriam como executar uma determinada tarefa, como diagnosticar e resolver um determinado problema e quais são as práticas recomendadas para um determinado processo. A extração funciona melhor em documentos que têm uma estrutura clara com cabeçalhos hierárquicos.
Observação
Extração para artigos de suporte é um recurso novo e está nos estágios iniciais. Funciona melhor para páginas simples, que também são estruturadas e não contêm cabeçalhos/rodapés complexos.
Importar e exportar o projeto
Os arquivos TSV e XLS, dos projetos exportados, só podem ser usados ao importar os arquivos da página de Configurações no Language Studio. Eles não podem ser usados como fontes de dados durante a criação do projeto do recurso + Adicionar arquivo ou + Adicionar URL na página Configurações.
Quando você importa o projeto através desses arquivos TSV e XLS, os pares de respostas às perguntas são adicionados à fonte editorial e não às fontes das quais as perguntas e respostas foram extraídas no projeto exportado.