Lesson dictionaries: how to use

The lesson editor has four dictionary types. Each solves a different task and affects validation, recognition, or speech synthesis.

Stop-words dictionary

Stop-words dictionary contains words and phrases a learner should not say in an answer.

• What it does: if a stop word appears in recognized speech, the system marks the answer as an error.
• When to use: for forbidden wording, filler words, or phrases that must not appear in answers.
• How to fill in: add each word or phrase as a separate tag.

Abbreviations dictionary

Abbreviations dictionary stores mappings between short and full forms.

• What it does: before answer validation, the system replaces short forms with full forms.
• When to use: when expected phrases include abbreviations.
• How to fill in: for each record, set two fields:
  • Abbreviation
  • Full form

Example pair: st -> street.

Hot-words dictionary

Hot-words dictionary improves recognition quality for difficult words and phrases in a specific lesson.

• What it does: added words are sent to the lesson recognition model as high-priority terms.
• When to use: when the system repeatedly misrecognizes specific terms, names, or phrases.
• How to fill in: add words and phrases as separate tags.

Recommendation: write numbers as words (for example, two hundred fifty three).

Transcription dictionary

Transcription dictionary is used for TTS pronunciation (primarily in adaptive responses).

• What it does: replaces words with custom transcriptions before speech synthesis.
• When to use: when abbreviations, names, or terms are pronounced incorrectly.
• How to fill in: use pairs in word [transcription] format, one per line or comma-separated.

Examples:

• LMS [el-em-es]
• KPI [ki-pi-ai]

Important:

• if the same word is listed multiple times, the last value is used;
• the same dictionary can be attached to multiple lessons and detached when needed.