AI Module Builder User Guide

This guide is for Training Developers. It explains how to turn your existing training material such as manuals, SOPs, slide decks, handouts - into a complete eLearning module, what every setting does, and what to check before you hand the module on.

Who can use it

If you have the Training Developer role but no menu item, your learning center most likely has no active AI plan: Contact your administrator.

What the AI Module Builder does

You upload your source document, usually a PowerPoint Presentation or PDF manual. The AI module builder will read and analyze the material, propose a course outline, and once you approve that outline, writes every page, adds review questions, builds a final exam, and optionally adds AI images and avatar presenter videos.

You stay in control at every step. The AI never publishes anything on its own:

• You edit the outline before any content is written.
• You edit, regenerate or delete any page after it is written.
• The finished result lands in Draft Modules, not in front of students.

By default the AI module builder is restricted to only what is in your uploaded files. It will not invent facts unless you explicitly allow it to.

Before you start

1. Gather your source files. Accepted formats: PDF, PPT, PPTX, DOC, DOCX, TXT, MD, CSV, PNG, JPG, GIF, WEBP. You can upload up to 10 files, and mix formats freely. Note: The AI module builder works best with a single file, but if you have files that are related and want to include them you can; It will do it’s best to incorporate your subject material.
2. Know your focus. If your source material is broad but the module should cover only part of it, write that down in the description field.
3. Check your plan headroom. Large modules with avatar videos and AI images consume significantly more of your AI plan than a short text-only module.

Tip: Your first build on a new document set should be Short length with avatar videos off. It finishes in a few minutes and tells you quickly whether the AI is reading your source material the way you expected.

Finding the builder

Open AI Module Builder in the sidebar

You will end up in the AI module builder drafts landing page, your home base. Every module you start appears here and stays here until you move it to Draft Modules. Click Create New Module to begin a new build.

The one-time disclaimer

The first time you open the builder you are asked to confirm:

I have read and understand the risks of using AI-generated content.

Tick the box and click Continue. Clicking Cancel returns you to the drafts list — you cannot use the builder until you accept. You only see this once.

The five steps at a glance

1. Upload & Configure - Add files, name the module and choose settings
2. Outline - AI module builder proposes module structure - You edit the outline before generating content
3. Build - AI module builder generates and fact reviews every page
4. Review - You read, edit, regenerate (pages/images/questions) and resolve any unsolved fact discrepancies
5. Move to Draft Modules - Copies module into the regular draft modules area

Steps 2 and 3 run in the background. You can close the page at any point and pick the draft back up later from the drafts list. You will also be notified via email when those steps complete, so you don’t need to keep checking on their status while they work in the background.

Step 1 — Upload and configure

What to do

1. Enter a Module Name (required). This becomes the module's name throughout the LMS.
2. Optionally fill in What should this module cover?
3. Under Upload Course Materials, upload at least one file.
4. Work through Course Configuration (full reference below).
5. Click Build Course Outline.

The Build Course Outline button stays disabled until you have both a module name and at least one uploaded file.

Outline generation takes roughly 30 - 60 seconds for a small Powerpoint or PDF. You will see "Analyzing your training materials…" while the AI reads your files, extracts key topics and drafts the structure. If it fails, a Retry button appears.

Setting reference — module identity

Setting reference — course configuration

About Enable AI Generated Content

This is the strict/flexible switch, and it is on by default deliberately.

If in doubt, leave it on. Turning it off means you will completely rely on your source material for all content.

About Output Quality

This sets the AI model used to write your course. It is a preset: it seeds both content quality and image quality, which you can then fine-tune separately on the next step.

Setting reference — avatar presenter (optional)

Turning on Enable Virtual Avatar Host adds an AI video presenter who narrates key moments. This is an important driver of both build time and plan usage: A module with avatar videos takes noticeably longer to build.

Step 2 — Review and shape the outline

The AI now shows you its proposed structure before writing any content. This is a very important point in the whole process.

Fix the structure here. Reordering a section or deleting three unwanted pages costs you nothing now. Doing it after the build means paying to generate content you then throw away.

What you can change

• Course Overview — edit the Module Name, Course Title and Description.
• Section titles and descriptions — the section description guides the AI when it writes that section's pages, so it's worth making it specific.
• Reorder — drag sections and pages by their drag handles.
• Add — Add Section, and per section: Add Page, Add Review Question, and Add Avatar Video (only when avatars are enabled).
• Delete — remove any section or page you don't want.

Your edits save automatically about two seconds after you stop typing. The indicator at the top shows Saving… / Saved, with a Retry link if a save fails. There is also a manual Save button.

Content & Image Quality

A card on this step lets you override the quality tier you picked in Step 1:

• Content Quality — Fast / Normal / High, the tier used to write the pages.
• Image Quality — Fast / Normal / High, shown only when AI images are on. Higher quality images are noticeably more accurate, but take longer to generate.

Higher quality uses a stronger AI model and costs more; lower quality builds faster and cheaper.

AI Plan Usage

A stacked bar shows where this build leaves you:

Underneath, the estimate is broken down by what's actually in your outline — content pages, review questions, avatar videos, AI images and the exam. It updates live as you edit the outline, so you can trim until the number looks right.

If you go over budget

If the projected total would exceed 95% of your plan, you will see:

Over plan budget — this module can't be generated.

Generate Full Course is disabled until you get back under. The 95% ceiling exists to leave room for the rest of the billing period. To get under it:

• Trim the outline — fewer pages, review questions, avatar videos or exam questions
• Lower the content or image quality
• Turn off avatar videos or AI images
• Wait for the next billing period, or ask your administrator about a larger plan

Moving on

Click Generate Full Course when the outline looks right. Back discards the generated outline and returns to Step 1 — you will be asked to confirm.

Step 3 — The build

The AI now writes the whole module: every content page, the review questions, the exam, any AI images, and any avatar videos. It then fact-checks the content back against your source documents.

You can safely close this page. The build runs in the background. You will get an email when it's ready, plus a phone notification if you have the Ascent app installed (You need student role for app). The draft waits for you in your drafts list either way.

A progress bar shows percentage complete and the current step. Show all steps expands the full progress log.

How long? Several minutes for a typical module — longer for large courses, and considerably longer when avatar videos are enabled. A medium to large module with avatars commonly takes 5 - 20 minutes.

If the build fails, you get Back to Outline and Retry. (Retry is disabled if you are over plan budget.)

Step 4 — Review and refine

You now have the finished module to review page by page. Use the page list on the left to move through it; the Final Exam has its own entry at the bottom.

Two warnings may appear at the top:

• "{Number} pages failed to generate content." — those pages need regenerating.
• "Potential inconsistencies detected on {Number} pages." — the fact checker found something; see below.

Editing pages directly

Content pages are editable in place — click into the page and type. Your edits autosave every 30 seconds and again when you leave the page.

The editor palette

A palette docks at the bottom of the screen whenever a page is selected:

Review questions and exam questions can be regenerated the same way.

Images

Click an AI-generated image to open the image modal:

• Modify existing — adjust the current image with a prompt.
• Create new — generate a fresh image from a prompt.

• Revert to original — go back to the image you started with.

  
  

  

Fact-check flags

After the build, the AI checks the generated content against your source documents and flags anything that looks inconsistent. Each flag shows a severity badge, what the page says versus what the source says, an explanation, and a suggested fix.

You have two choices per flag:

Always look at high-severity flags before moving on. The fact checker is good but not infallible in either direction: it can flag correct content, and it can miss things. Treat it as a checklist, not a guarantee.

Step 5 — Move to Draft Modules

When you are happy, click Move to Draft Modules.

If any fact flags are still unresolved you will be warned first — "{Number} pages still have unresolved fact discrepancies. Publish anyway?" — and can go back.

This is not publishing to students. The module lands in your regular Draft Modules section. Nobody is assigned it and no student can see it. It behaves exactly like a manually built draft module from this point on.

You will then see Module Moved to Drafts Successfully! with two buttons:

• Back to Drafts — return to the AI builder drafts list.
• Open in Module Editor — opens the module in the standard module editor in a new tab.

What to do in the module editor

The regular module editor is where you finish the job:

1. Clear any pages that were flagged for review.
2. Make final wording, branding and formatting adjustments.
3. Publish the module and assign it, exactly as you would any other module.

Managing your drafts

The drafts landing page lists every AI module you've started. Each card shows its status, file count and dates.

Everything autosaves, so you can leave a draft at any stage and resume it later — it reopens on the step you left it.

Sharing a draft

Click Share (available on the outline and review steps, and on each draft card) to share an in-progress build with colleagues.

• You can only share with other Training Developers in your learning center.
• Use Select all / Clear to manage the list quickly, then Save.
• If you see "No other Training Developers found in this learning center", you may not have permission to share the draft module.
• A draft shared with you shows a Shared with you badge. You can work on it, but you cannot re-share or delete it, only the owner can.

Custom content themes

Beyond the three built-in themes, your learning center can define its own. Manage these from the Custom Content Themes section on the drafts landing page. Custom themes appear alongside Modern, Corporate and Playful in the theme picker.

Limit: 3 custom themes per learning center.

The 13 selectable components are: Two-Column Layout, Callout Box, Icon Grid, Card Grid / Content Cards, Comparison Table, Statistic Highlight, Timeline, Step-by-Step Process, Checklist Block, Definition List / Term Block, Quote Block, Scenario Block, and Image + Caption Gallery.

Hero sections and video blocks are always available and cannot be turned off.

Tip: Enabling everything gives the AI the most freedom and generally produces more varied pages. Restrict the list when you need a consistent, tightly branded house style.

Tips for good results

• Use the description field if you need a specific area covered. It is the easiest way to steer the whole module. A broad manual plus a focused description beats trying to fix scope later.
• Build short first. A Short, avatar-free build is a fast, cheap check that the AI is reading your source material correctly. Then rebuild properly.
• Keep AI Generated Content off for strictly regulated material.
• Spend your time on the outline, not the content. Structural fixes are easiest before the build and harder to do after it.
• Section descriptions do real work. They guide how the AI writes that section — vague descriptions produce vague pages.
• Watch the plan bar as you edit. It updates live, so you can see exactly which additions are expensive.
• Start at Normal quality. Only move to High for material where precision genuinely matters.

Troubleshooting

Quick reference

Defaults at a glance

Rough timings

Getting help

• How to use the builder, settings, content quality: Follow this guide, or the in-app tour on the drafts page.
• AI plan limits or a larger plan: Contact your learning center administrator.
• Something broken, or a build that repeatedly fails: Submit a help request from within Ascent and support will get back to you.