Virtual Agent Dictionary - Description of the CSV File


A dictionary is used by a virtual agent to analyze user questions and to select the most relevant content related to the request. It is also used to correct spelling errors.

  • A dictionary is associated with one or more Self Help projects for a virtual agent via the Administration module.
  • It is associated with a given language. 
  • It appears as a CSV file comprising a list of terms and the links that exist among them.
  • Each row corresponds to one term or one set of synonyms.
             Dictionary CSV file via Excel.png

Caution

  • When you import a dictionary, you must ensure that the first character of each row in the CSV file is a semicolon (;). This character is used to separate data into columns in the CSV file and create one dictionary term per row.
             Dictionary CSV file via Notepad.png

Best Practice

  • Use Excel to modify the CSV file.

Contents of the CSV file

Column Description
A Column separator

Note: Must be a semicolon (;).

B Type of term.
  • nn: noun
  • vb: verb
  • ot: onomatopoeia
  • ad: adjective
  • pr: preposition

Note: The type remains identical regardless of the dictionary language.

C Contains one of the following:
  • The term to be added to the dictionary.
  • The character > indicating a parent - child relationship with the term in the previous row.
D and other List of synonyms of the term in column C.

Example

CSV file open in Excel

        Dictionary CSV file - Example Excel.png

  • Row 13:
    • Column B: nn ==> All terms in the row are nouns.
    • Column C: documentation ==> Term to be added to the dictionary.
    • Columns D and E: Synonyms of documentation ==> document, doc.
  • Row 14:
    • Column B: nn ==> All terms in the row are nouns.
    • Column C: > ==> Indicates a parent - child relationship with previous row 13. All terms in row 14 are child entities of the term documentation.
    • Column D: User manual
    • Columns E to I: Synonyms of the term User manual ==> instructions, guidebook, manual, guide, notice.
       

Display the dictionary in the Administration module

  • Display the term Documentation

(1)Type of term ==> Noun
(2) Term and synonyms: doc, document
(3) Child entities: guide, guidebook, instruction, manual, notice, user manual

        Dictionary CSV file - Example Administration module 1.png
 

  • Display the term Guide

(1)Type of term ==> Noun
(2) Parent entities: doc, document, documentation
(3) Term and synonyms: guide, guidebook, instruction, manual, notice, user manual

        Dictionary CSV file - Example Administration module 2.png

Tags:
Last modified by Unknown User on 2020/03/24 12:34
Created by Administrator XWiki on 2020/03/24 12:27

Shortcuts

Powered by XWiki ©, EasyVista 2020