Centro de Ajuda
Treinar o seu chatbot

Treino avançado com sintaxe Markdown

Última atualização:

O Markdown é uma sintaxe de formatação leve que adiciona estrutura a texto simples. Ao fornecer dados de treino com Markdown, a IA consegue compreender melhor as secções, as hierarquias e as referências no seu conteúdo - e utilizará essa estrutura ao responder aos utilizadores.

Como funciona o Markdown no ChatLab

O Markdown é utilizado de duas formas, dependendo da fonte de treino:

  • Fontes de websites - O Markdown é aplicado automaticamente. Quando o ChatLab analisa um website, converte o HTML para o formato Markdown, preservando cabeçalhos, listas, hiperligações e a estrutura da página.
  • Fontes de texto e perguntas e respostas (Q&A) - Escreve o Markdown manualmente. Os campos de texto aceitam a sintaxe direta de Markdown, que é guardada tal como está e utilizada durante o treino.

Em ambos os casos, os dados estruturados ajudam a IA a reconhecer secções, a distinguir informações essenciais e a incluir hiperligações relevantes nas suas respostas.

Markdown em fontes de websites

Ao realizar o treino a partir de websites (Training > Links [Treino > Hiperligações]), o ChatLab converte automaticamente o conteúdo da página para um formato de texto que preserva as hiperligações. As hiperligações externas são guardadas com a sintaxe de hiperligação do Markdown, permitindo que a IA as referencie nas respostas.

Para ver como uma página analisada é guardada, clique no botão View (Ver) junto a qualquer hiperligação treinada. A pré-visualização mostra o conteúdo guardado, incluindo quaisquer hiperligações formatadas em Markdown.

Botão View a mostrar o conteúdo do website guardado com hiperligações em Markdown

No exemplo acima, o endereço de e-mail é guardado como [info@yoursite.com](mailto:info@yoursite.com) - uma hiperligação em Markdown que a IA pode incluir como uma ligação clicável nas suas respostas.

Markdown em fontes de texto

Aceda a Training > Text (Treino > Texto) e clique em Add New Training: Text (Adicionar novo treino: Texto). No campo de texto, pode escrever diretamente a sintaxe de Markdown.

Formulário de treino de texto com conteúdo em Markdown

O exemplo acima mostra uma política de devoluções escrita com cabeçalhos de Markdown (#, ##), texto a negrito (**30 days**), listas com marcadores (-) e hiperligações ([Returns Portal](https://example.com/returns)).

Markdown em fontes de perguntas e respostas (Q&A)

Aceda a Training > Questions & Answers (Treino > Perguntas e Respostas) e clique em Add New Training: QA (Adicionar novo treino: Perguntas e Respostas). O campo de resposta suporta a sintaxe de Markdown, permitindo-lhe estruturar as respostas com listas, texto a negrito e hiperligações.

Formulário de treino de Q&A com Markdown no campo de resposta

Sintaxe de Markdown suportada

Apresentamos um guia de referência dos elementos de Markdown que pode utilizar nas fontes de treino de texto e de perguntas e respostas (Q&A):

Cabeçalhos - Utilize # para um cabeçalho principal, ## para um subtítulo, até ###### para o nível de cabeçalho mais pequeno.

# Main heading
## Subheading
### Smaller heading

Negrito e itálico - Coloque o texto entre **dois asteriscos** para negrito ou *um asterisco* para itálico.

**bold text**
*italic text*

Listas não ordenadas - Inicie cada linha com - ou * seguido de um espaço.

- First item
- Second item
- Third item

Listas ordenadas - Inicie cada linha com um número seguido de um ponto e de um espaço.

1. First step
2. Second step
3. Third step

Hiperligações - Utilize o formato [texto da ligação](URL) para criar referências clicáveis.

Visit our [Help Center](https://example.com/help)
Email us at [support@example.com](mailto:support@example.com)

Imagens - Utilize ![texto alternativo](URL da imagem) para referenciar imagens. A IA pode descrever ou incluir hiperligações para estas nas respostas.

![Product photo](https://example.com/images/product.png)

Como o Markdown aparece nas respostas do chat

Quando os seus dados de treino estão estruturados com Markdown, o chatbot processa respostas formatadas no widget de chat - incluindo listas com marcadores, texto a negrito, passos numerados e hiperligações clicáveis.

Widget de chat a mostrar uma resposta formatada com listas de marcadores

O widget de chat suporta a apresentação de cabeçalhos, texto a negrito, texto em itálico, listas (ordenadas e não ordenadas), hiperligações, imagens e texto sobrescrito.

Utilização de carateres

Os carateres da sintaxe de Markdown (#, **, -, [](), etc.) contam para o limite de carateres dos seus dados de treino. O conteúdo formatado em Markdown utiliza normalmente cerca de 30% mais carateres do que o texto simples equivalente.

Por exemplo, a hiperligação [Help Center](https://example.com/help) utiliza mais carateres do que escrever apenas "Help Center", mas fornece à IA um URL que pode incluir nas respostas.

Se estiver perto do seu limite de carateres, pode reduzir o consumo simplificando o Markdown - por exemplo, utilizando menos cabeçalhos ou encurtando o texto visível das hiperligações.

Dicas para um treino eficaz com Markdown

  • Utilize cabeçalhos para organizar os tópicos - Isto ajuda a IA a identificar qual a secção do seu conteúdo que é relevante para a pergunta do utilizador
  • Utilize listas para opções, passos ou funcionalidades - A IA reflete frequentemente esta estrutura nas suas respostas
  • Inclua hiperligações para páginas importantes - A IA pode fornecer estas hiperligações ao responder a perguntas relacionadas
  • Mantenha a simplicidade - O Markdown básico (cabeçalhos, listas, negrito, hiperligações) é o mais eficaz. Formatações complexas, como tabelas aninhadas, podem não melhorar as respostas

Artigos relacionados