Recommandations en matière de mise en forme pour les réponses aux questions personnalisées
Passez en revue ces instructions de mise en forme afin d’obtenir les meilleurs résultats pour votre contenu.
Mise en forme - Éléments à prendre en compte
Après avoir importé un fichier ou une URL, la réponse aux questions personnalisées convertit et stocke votre contenu au format Markdown. Le processus de conversion ajoute de nouvelles lignes dans le texte, telles que \n\n. Une connaissance du format Markdown vous aide à comprendre le contenu converti et à gérer le contenu de votre projet.
Si vous ajoutez ou modifiez votre contenu directement dans votre projet, utilisez la mise en forme Markdown pour créer un contenu de texte enrichi ou modifiez le contenu du format Markdown qui est déjà dans la réponse. La réponse aux questions personnalisées prend en charge une grande partie du format Markdown pour apporter des fonctionnalités de texte enrichi à votre contenu. Toutefois, l’application cliente, telle qu’un bot de chat, peut ne pas prendre en charge le même ensemble de formats Markdown. Il est important de tester l’affichage des réponses de l’application cliente.
Mise en forme de base du document
Les réponses aux questions personnalisées identifient les sections et sous-sections et relations dans le fichier en fonction des indices visuels tels que :
- la taille de police
- le style de police
- la numérotation
- les couleurs
Notes
Actuellement, nous ne prenons pas en charge l’extraction d’images à partir de documents chargés.
Manuels de produit
Un manuel comprend habituellement des supports d’orientation qui accompagnent un produit. Il aide l’utilisateur à configurer, utiliser, gérer et dépanner le produit. Lorsque la réponse aux questions personnalisées traite un manuel, elle extrait les titres et sous-titres en tant que questions et le contenu suivant sous forme de réponses. Un exemple vous est proposé ici.
Voici un exemple de manuel avec une page d’index et du contenu hiérarchique
Remarque
L’extraction est plus efficace sur les manuels qui ont une table des matières et/ou une page d’index, mais aussi une structure clairement définie avec des en-têtes hiérarchiques.
Brochures, instructions, livres blancs et autres fichiers
De nombreux autres types de documents peuvent également être traités pour générer des paires de questions-réponses, à condition qu’ils aient une structure et une disposition claires. notamment : brochures, instructions, rapports, livres blancs, articles scientifiques, stratégies, ouvrages, etc. Un exemple vous est proposé ici.
Voici un exemple de document semi-structuré, sans index :
Prise en charge des documents non structurés
Réponses aux questions personnalisées prend maintenant en charge les documents non structurés. Un document dont le contenu n’est pas organisé d’une manière hiérarchique bien définie, n’a pas de structure définie ou est libre de toute mise en forme peut être considéré comme un document non structuré.
Voici ci-dessous un exemple de document PDF non structuré :
Remarque
Les paires de Q/R ne sont pas extraites sous l’onglet « Modifier les sources » pour les sources non structurées.
Important
La prise en charge des fichiers/contenus non structurés est disponible uniquement dans les réponses aux questions personnalisées.
Document de réponse aux questions personnalisées structuré
Le format des questions-réponses structurées dans les fichiers DOC consiste à alterner les questions et les réponses ligne par ligne, une question sur une ligne suivie de sa réponse sur la ligne suivante, comme indiqué ci-dessous :
Question1
Answer1
Question2
Answer2
Vous trouverez ci-dessous un exemple de document word de réponse aux questions personnalisées structuré :
Fichiers TXT, TSV et XLS structurés
Les réponses aux questions personnalisées sous la forme de .txt structurés, .tsv ou .xls fichiers peuvent également être chargés dans des réponses aux questions personnalisées pour créer ou augmenter un projet. Il peuvent être en texte brut, ou peuvent avoir du contenu au format RTF ou HTML. Les paires de questions-réponses ont un champ de métadonnées facultatif qui peut être utilisé pour regrouper des paires de questions-réponses en catégories.
| Question | Réponse | Métadonnées (1 clé : 1 valeur) |
|---|---|---|
| Question1 | Réponse1 | Key1:Value1 | Key2:Value2 |
| Question2 | Réponse2 | Key:Value |
Toutes les autres colonnes du fichier source sont ignorées.
Format de données structurées via l’importation
L’importation d’un projet remplace le contenu du projet existant. L’importation nécessite un fichier .tsv structuré qui contient des informations sur la source de données. Ces informations aident à regrouper les paires de questions-réponses et à les attribuer à une source de données en particulier. Les paires de questions-réponses ont un champ de métadonnées facultatif qui peut être utilisé pour regrouper des paires de questions-réponses en catégories. Le format d’importation doit être similaire au format de base de connaissances exporté.
| Question | Réponse | Source | Métadonnées (1 clé : 1 valeur) | QnaId |
|---|---|---|---|---|
| Question1 | Réponse1 | Url1 | Key1:Value1 | Key2:Value2 |
QnaId 1 |
| Question2 | Réponse2 | Éditorial | Key:Value |
QnaId 2 |
Mise en forme multitour du document
- Utilisez des titres et sous-titres pour montrer la hiérarchie. Par exemple, vous pouvez utiliser h1 pour indiquer la réponse à la question parente et h2 pour indiquer la réponse à la question à considérer comme une invite. Utilisez une petite taille de titre pour dénoter la hiérarchie suivante. N’utilisez pas de style, de couleur ou d’un autre mécanisme pour impliquer la structure dans votre document, les réponses aux questions personnalisées n’extraient pas les invites à plusieurs tour.
- Le premier caractère de l’en-tête doit être en majuscule.
- Ne pas terminer un titre par un point d’interrogation (
?).
Exemples de documents :
Surface Pro (docx)
Contoso Benefits (docx)
Contoso Benefits (pdf)
URL de FAQ
Les réponses aux questions personnalisées peuvent prendre en charge les pages web FAQ sous trois formes différentes :
- Pages de FAQ simples
- Pages de FAQ avec des liens
- Pages de FAQ avec une page d’accueil Rubriques
Pages de FAQ simples
Il s’agit du type le plus courant de page de FAQ, dans lequel les réponses suivent immédiatement les questions dans la même page.
Pages de FAQ avec des liens
Dans ce type de page de FAQ, les questions sont regroupées puis associées à des réponses qui se trouvent soit dans différentes sections de la même page, soit dans différentes pages.
Voici un exemple de page de FAQ avec des liens dans des sections qui se trouvent dans la même page :
Liens de la page Rubriques parente vers les pages de réponses enfants
Ce type de FAQ comporte une page Rubriques sur laquelle chaque rubrique est liée à un ensemble de questions et de réponses correspondant sur une autre page. Réponse aux questions analyse toutes les pages liées pour extraire les questions et réponses correspondantes.
Voici un exemple de page Rubriques comportant des liens vers des sections de FAQ sur d’autres pages.
URL de support technique
Les réponses aux questions personnalisées peuvent traiter des pages web de support semi-structurées, telles que des articles web qui décrivent comment effectuer une tâche donnée, comment diagnostiquer et résoudre un problème donné, et quelles sont les meilleures pratiques pour un processus donné. L’extraction fonctionne de façon optimale sur du contenu ayant une structure claire avec des titres hiérarchiques.
Notes
L’extraction pour les articles de support est une nouvelle fonctionnalité à un stade de développement encore précoce. Il convient idéalement pour les pages simples, qui sont bien structurées et qui ne contiennent pas d’en-têtes ou pieds de page complexes.
Projet d’importation et d’exportation
L’utilisation de fichiers TSV et XLS provenant de projets exportés n’est possible qu’en les important à partir de la page Paramètres de Language Studio. Il est impossible de les utiliser en tant que sources de données lors d’un projet ou à partir de la fonctionnalité + Ajouter un fichier ou + Ajouter une URL dans la page Paramètres.
Lorsque vous importez le projet via ces fichiers TSV et XLS, les paires de questions-réponses sont ajoutées à la source éditoriale et non aux sources à partir desquelles la question et les réponses ont été extraites dans le projet exporté.