AI Features

The Lex Editor integrates AI tools for lesson creation, exercise generation, translation, and content analysis.

Overview of AI Tools

AI Lesson Builder

The lesson builder is the main AI feature. It generates a complete, structured lesson from a topic, target language, and CEFR level.

How It Works

The generation follows a two-phase process for high-quality, coherent output:

1. Planning phase -- the AI creates a lesson plan with a storyline, key vocabulary, grammar focus, and section briefs. This ensures all parts of the lesson connect thematically.
2. Section generation -- each lesson section (warm-up, vocabulary, theory, exercises, reading, summary) is generated in parallel using the shared plan as context.

This two-phase approach means that vocabulary introduced early in the lesson reappears in exercises later, and the grammar explanations connect to the practice activities.

Available Sections

The lesson builder lets you enable or disable individual sections across four categories: Core (warm-up, vocabulary, theory, exercises, reading, listening, speaking, writing, summary), Games (flashcard, memory game, word scramble, etc.), Brain Breaks, and Visual (AI-generated images). Some sections also expose focused controls, such as teacher-supplied pronunciation targets, handwriting upload limits, handwriting mistake categories, and category sort items. For the full section list and configuration options, see AI Lesson Generation.

Review Generated Widgets

After AI generation, use Enter widget edit mode from the editor toolbar to switch all exercise widgets in the lesson into edit mode. This lets you review answers, options, instructions, scoring settings, and generated widget content quickly.

Click the same button again when you are done. Leaving widget edit mode on means the document is still showing teacher-edit controls instead of the normal lesson experience.

Some generated widgets, such as image prompts and audio dialogues, may start in edit mode on purpose. Review the prompt or script, make corrections, then click Generate inside the widget. If you do not generate the asset, the widget stays as an editable placeholder.

For widgets that depend on AI audio, such as Pronunciation, prepare and cache the generated audio before assigning the lesson when students should not trigger the AI cost themselves.

Before assigning the lesson, use Clear answers to remove any test answers you entered during review. If test answers remain in the lesson document, students can receive those answers in their assigned copy.

Ask AI Assistant

The Ask AI tool is a built-in assistant that helps with writing and editing tasks directly in the editor.

How to Use It

1. Click the Ask AI button in the toolbar, or type /askai
2. A prompt input appears where you can type your request
3. The AI generates content and inserts it at the cursor position

Example Prompts

• "Write 5 example sentences using the present perfect tense"
• "Create a dialogue between two people ordering food at a restaurant"
• "Explain the difference between 'since' and 'for' at B1 level"
• "Generate a vocabulary list of 10 travel-related words with definitions"
• "Write a short story using these vocabulary words: adventure, mysterious, discover"

Ask AI generates content that fits your current topic and level.

Help Assistant vs. Ask AI

Speakly.PRO also includes a Help Assistant for documentation questions. Use it when you want to know how the platform works. Use Ask AI when you want to create or edit lesson content inside the Lex Editor.

Conversation Memory

Ask AI remembers context across messages. Once you specify topic, exercise type, level, or language, you don't have to repeat them.

For example:

1. "Generate 10 vocabulary exercises on food for A2 level"
2. "Now add images to each one" — knows you mean the food exercises at A2
3. "Make 5 more but for B1" — carries over topic and type, updates the level

Fully specified requests generate content immediately without clarifying questions.

Lesson-Aware Requests

When you use Ask AI inside an existing lesson, the assistant automatically sees the lesson's name, description, CEFR level, lesson type, and tags. Short requests like "add a follow-up exercise" or "write a warm-up for this" work without you restating the topic. If you launch Ask AI from a live session, the student's age, gender, and native language are also available so the generated content can match the learner instead of a generic profile.

Ask AI with Materials Library

Ask AI can use your school's Materials Library as trusted source context. Upload or paste the source first, wait until the material is Ready, then use Ask AI from the Lex Editor to adapt that material into lesson content.

Good requests include:

• "Create a B1 reading lesson from this source with vocabulary and comprehension questions."
• "Summarize the material for A2 students and add a speaking task."
• "Turn this PDF section into homework with deferred answer reveal."
• "Extract useful phrases from the source and make matching exercises."
• "Build a teacher-led warm-up from this image prompt."

When Ask AI uses library material, review the source references before publishing. This keeps the final lesson aligned with the uploaded material instead of drifting into a generic AI answer.

Exercise Generation from Context

The AI can generate exercises automatically from your lesson content:

1. Write or generate a text passage, grammar explanation, or vocabulary section
2. In the exercise block configuration, choose "Generate exercises from context"
3. The AI analyzes your content and creates relevant exercises:
   • Fill-in-the-blank questions based on grammar patterns in the text
   • Multiple choice questions based on vocabulary
   • Matching exercises from vocabulary tables
   • True/false statements about the reading passage
   • Comprehension questions

Works well after a reading passage or grammar theory section.

Translation Panel

The translation panel lets you quickly translate text between languages from inside a lesson.

How to Use It

1. Select the text you want to translate
2. Click the Translate button in the floating toolbar (or right-click menu) to open the Translation panel
3. Pick a language pair with the chips at the top of the panel
4. Press Enter (or click translate) — the translation appears and you can insert it, copy it, or dismiss it

Language Pair Selector

The Translation panel offers quick chips for the language pairs most relevant to the current lesson:

• Student native ↔ course language — for a student-facing translation. In a course-lesson view that is not yet assigned to a specific student, this chip uses the course's default student-native language.
• Teacher native ↔ course language — for a teacher-facing reference.

Switching the pair does not auto-translate — you confirm with Enter (or the translate button) so the panel never spends tokens on an accidental pair switch. If a translation is already in flight when you change the pair, the in-flight request is cancelled so the panel does not show stale output.

Use Cases

• Quickly translate vocabulary words for bilingual lessons
• Create side-by-side translation comparisons
• Verify your own translations
• Generate translations for matching exercises

Lesson Analysis

Beyond content creation, AI is also used to analyze student performance on completed lessons. This feature is accessed from the enrollment page rather than the editor.

What It Does

The AI examines a student's answers across all exercises in a completed lesson — fill-in-the-blank, multiple choice, matching, ordering, true/false, sentence builder, speech exercises, and essays. It produces a structured report with:

• Performance summary and exercise-by-exercise breakdown
• Error pattern identification — recurring mistakes across exercise types
• Strengths and weaknesses assessment
• Essay feedback with quality rating (if applicable)
• Follow-up recommendations — suggested topics, focus skills, and exercises

Reports are written in the student's target language.

How to Use It

1. Go to the student's enrollment page
2. Find a completed lesson (status: Passed or Verified)
3. Click the brain icon — a confirmation dialog shows the cost
4. The analysis runs in the background and a notification arrives when it finishes
5. Click the yellow brain icon to view the report in a side panel

A bulk analysis option analyzes the 20 most recent lessons in a single request.

See Lesson Analysis for more details.

AI Costs

All AI features use tokens from your account balance. A full lesson generation costs approximately 100 tokens (~$1). Other actions (Ask AI, translation, analysis) vary by complexity.

For token purchasing and balance management, see Billing & Tokens.

Frequently Asked Questions

Can I use AI to generate homework from a class lesson?

Yes. Use the section-by-section generation to create exercise sets based on topics you covered in class. You can also generate a full homework lesson using the same topic and vocabulary.

Can AI create audio content?

Yes. Listening sections can be generated with text-to-speech. The AI writes a dialogue or monologue script, and the text-to-speech engine converts it to audio with configurable voices, emotional tags, and natural pacing.

Can the AI generate images?

Yes. Image sections can include AI-generated images (realistic scenes or memes). The images are created during the content creation step and stored with your lesson.