Skip to content

Courses

Courses are the core training content in Aimee.ai. Each course defines an AI-powered conversational simulation that learners will complete.

Accessible to: Trainers, Workspace Owners, Admins

Course list

Navigate to Content Library in the sidebar to see all courses in the workspace on the Courses tab. For the full lifecycle view (drafts, versions, duplicating, templates, purchased courses), see Course Management.

Each course row shows:

  • Title and description
  • Status — Draft or Published
  • Version label (e.g., v1.0)
  • Last updated date

Use the search bar to filter courses by title, the status filter to show only drafts or published courses, and the tag filter bar to narrow by topic.

Creating a course

  1. Open the Courses tab in the Content Library.
  2. Enter a title in the inline create form.
  3. Click Create Course.
  4. Choose a starting point:
    • Blank course — open an empty editor and build the content yourself.
    • Generate with AI — answer a few questions and Aimee drafts slides, questions, and narration for you.

The new course opens in the Course Editor as a draft.

Start from a template

If you've already saved reusable templates, open the Templates tab of the Content Library, open the template, and click Save as new course — see Course Management.

Course Editor

The editor has several sections:

Basic information

  • Title — the course name
  • Description — internal description (not shown to learners)
  • Default Narration Voice — the default voice used for AI narration across this course's content blocks

Course Content & Voice Narration

The Course Content tab lets you build a structured set of blocks the learner progresses through before or during the simulation. Blocks are grouped into modules (chapters) so larger courses scan as a clear outline rather than a long flat list — see Modules below for how to create, rename, and reorder them.

Use the Import Content menu to pull a whole file in — each page, slide, section, or heading becomes its own block:

  • PDF — Aimee reads the PDF with AI and writes one editable slide per logical section, lifting embedded images out into the workspace image library so you can swap or re-use them. You see a cost preview before the import runs.
  • PowerPoint (.pptx) — one block per slide. Speaker notes become voice narration for that slide.
  • Word (.docx) — one block per Heading 2 (falls back to Heading 1 if the document has no H2, or becomes a single slide if it has neither). Lists, tables, bold / italic, and embedded images all carry through.
  • Markdown (.md / .markdown) — one block for every # or ## heading. Code blocks, tables, and embedded images are all preserved; images referenced by URL render in place.

Each import creates a new module named after the file you imported, and drops its slides into that module — so a course built from onboarding.pdf and safety.pptx ends up with two clearly named chapters.

If your course already has content, Aimee asks whether to append the new file at the end or replace the previously imported content (manually added media, quizzes, and other blocks are preserved when you replace).

Or add blocks by hand from the Add Block menu:

  • Acknowledgement — ask the learner to type their name to confirm they have read a policy.
  • Matching — click-to-place exercise: pair terms with definitions, order steps, or sort into categories.
  • Media — embed a video or audio clip (YouTube, uploaded video, image).
  • Quiz — knowledge check with one or more questions.
  • Resource — downloadable take-away files (policy PDFs, job aids, templates, checklists).
  • Scenario — open-ended AI-driven roleplay the learner works through in conversation.
  • Slide — rich-text slide with optional images and voice narration. Slides can use a one-column layout (text only, today's default) or a two-column layout that puts the text on the left and a single image from the workspace image library on the right; pick the Image width (20% / 30% / 40% / 50% / 60%) so the image gets as much room as it needs without crowding the text. On phones and other narrow screens the image stacks above the text so the slide stays legible. Voice narration on a two-column slide is generated from the left-column text only — the image is silent. Save is disabled until you've picked an image.

Templates lose the two-column flag

Two-column slides round-trip through duplicate-course, but the template export → re-ingest path currently flattens them back to one-column. If you regenerate a template, recreate the two-column layout in the new course.

Browse uploaded files

Click Browse Files in the Content tab toolbar to see every file uploaded into this course — PDFs, PowerPoints, Word documents, Markdown files, images, and the audio files generated for voice narration. You can download or delete any file, and choose which PDF should be treated as the course's source.

Duplicate a block

Each block has a copy icon beside the trash icon. Click it to drop an independent copy of that block immediately after the original — handy when you want a quiz, slide, or scenario with the same shape but different wording. Media, voice audio, and (for resource blocks) attached files are all copied; editing the duplicate never changes the original.

Modules

Modules are the chapters of your course. Each block belongs to exactly one module, and modules are ordered top-to-bottom in the Content tab. Every course starts with a single default module called Course content — you can rename it like any other module, but it can't be deleted, so a course always has somewhere for its blocks to live.

Authoring. From the Content tab toolbar:

  • Click + Module to add a new module at the end of the list. Click the module title to rename it inline.
  • Drag a module's grip handle to reorder modules.
  • Drag a block by its grip handle into another module to move it across chapters; drop on a module header to insert it at the top of that module.
  • Open a module's kebab menu and choose Delete module to remove a module — its blocks are moved to the end of the Course content module so nothing is lost.
  • An empty module is allowed, so you can lay out a chapter skeleton before importing the content for it.

What the learner sees. When learners open the Table of contents from the bottom nav bar, blocks are grouped under their module names. The first block of each module shows an inline chapter chip so learners know when a new chapter begins.

Resource Blocks

A resource block lets you attach one or more downloadable files alongside the lesson — policy PDFs, SOPs, spreadsheets, job aids, templates, checklists. Each file in the block gets its own label shown to the learner (e.g. "Policy PDF", "Signing template", "Onboarding checklist"), so related artefacts can live together in one block instead of a separate block per file.

Authoring. Click Add Block and choose Resource, then:

  1. (Optional) Give the block a title and description — context shown above the file list.
  2. Click Add files to pick one or more files. You can add up to 20 files per block.
  3. Set a label for each file (optional; defaults to the filename).
  4. Remove a file with the trash icon; replace the entire set by removing and re-adding.

File types accepted: PDF, Word, Excel, PowerPoint, CSV, TXT, ZIP. Uploads that exceed the workspace file-size cap are rejected, and file types outside the allowlist are refused at save time — not just in the picker.

What the learner sees. Each file renders as its own download card: a file-type icon, the label (or filename as a fallback), the filename and size, and a Download button that triggers the browser's save-as dialog using the original filename.

Resources are optional

Resource blocks are informational, not assessments — downloading is not a prerequisite for course completion. Use them for reference material that learners may want to keep after the course.

ZIPs are trusted at upload time

Files are stored as-is; there's no virus scan. Only upload materials you have authored or vetted.

Matching Blocks

Matching blocks are interactive click-to-place activities for assessment shapes a multiple-choice quiz can't capture naturally. The learner clicks an item in the bank, then clicks the target slot where it belongs. One block, three modes:

  • Pair terms with definitions — e.g. match each ISO 27001 control to the risk it mitigates.
  • Order steps — e.g. put the incident-response steps in the correct sequence.
  • Sort into categories — e.g. sort each attribute into PII / Sensitive PII / Non-PII.

Authoring. Click Add Block and choose Matching, then:

  1. Pick the mode (pairs, ordering, or categories).
  2. Fill in a title and optional instructions shown above the activity.
  3. Add at least two items:
  4. For pairs, each item has a left (term) and right (definition).
  5. For ordering, each item has a label; the order you enter is the correct order.
  6. For categories, add at least two categories first, then tag each item with its correct category.
  7. Optionally tick Allow partial credit and set a pass fraction (e.g. 0.75 means 75% of items must be in the right place).

Labels typed in one mode carry over if you switch modes, so you can prototype the wording and pick the shape that fits best.

Not for high-stakes assessment

Matching blocks are scored in the learner's browser (same as Knowledge Check quizzes on a slide). A motivated learner can inspect the page to see the correct answer before submitting. This is fine for practice-style inline assessment; for certification-grade testing, use a dedicated assessment workflow.

Acknowledgement Blocks

An acknowledgement block asks the learner to read a piece of content and attest that they have read and understood it. It is the right choice for compliance training — ISO, GDPR, HIPAA, internal policies — where you need a signed, dated record that a learner saw the exact wording of a policy.

Authoring. Click Add Block and choose Acknowledgement, then fill in:

  • Title (optional) — e.g. "Information Security Policy".
  • Text the learner must acknowledge — the full wording of the policy, written in the rich-text editor.
  • Require learner to type their full name — leave this on for compliance training; the typed name is stored on the attestation record.
  • Button label (optional) — defaults to "I acknowledge".

What the learner sees. The block shows the policy text, a checkbox ("I have read and understood the above"), a name field (if required), and an I acknowledge button that only enables once both inputs are filled. Once submitted, the block switches into a read-only banner showing when they acknowledged it and what name they typed.

What is recorded. Each acknowledgement stores the learner, the slide, the course version, the timestamp, the typed name, and a hash of the exact text the learner saw. Because the hash is frozen at submission, later edits to the block text cannot rewrite history — auditors can verify what wording was actually attested.

Editing an acknowledged block. If you edit the policy text, the course version bumps. Learners who already acknowledged the previous version will be asked to acknowledge the new wording the next time they enter the course.

Voice Narration

Trainers can add AI-generated voice narration to slides, scenarios, and most other blocks.

Per-block narration. Click the microphone icon on a slide block to open the Voice Narration modal. Write your own script or click Generate with AI to produce one from the block's content. On the Scenario Editor, open the Details tab and click Generate voice — the narration is composed from the scenario's title and description and opens with something like "In this scenario…". If the scenario has no description yet, the button shows an inline notice asking you to add one first. Editing a scenario's title or description clears its audio so the next generation matches the updated text.

Bulk narration. Click Generate All Voice in the Content tab toolbar to narrate every Slide and Scenario block in the course in one pass. You can choose Skip existing (only blocks missing audio are processed) or Overwrite (every block is re-generated). Other block types — Quiz, Matching, Acknowledgement, Media, Resource — are not narrated and are skipped. Scenarios that don't have a description yet are reported as failed so you can fill them in and retry.

Learner playback. When a block has narration, the course viewer plays it automatically on arrival. Learners can mute from the bottom nav bar, or click the slide content (or press Space while the slide is focused) to pause and resume the voiceover for that slide. Pause resets on every slide change; muting is global for the rest of the session.

AI-generated images

When you add an image block (or when Aimee generates a course for you), blocks marked Upload image can be filled with an AI-generated photograph based on a short description — click the upload action on the block to either upload your own image or generate one.

Learner Brief

The instructions shown to the learner before they launch the simulation. This should explain:

  • The situation and context
  • Who the learner is playing
  • What they need to achieve
  • Any constraints or guidelines

Write clear briefs

The learner brief is the only context your trainee gets. Be specific about the course, the learner's role, and success criteria.

Runtime Configuration

A JSON object that configures the AI simulation engine. This may include:

  • AI character persona and backstory
  • Conversation objectives
  • Escalation triggers
  • Environmental details

Scoring settings

Setting Description
Retry Limit Maximum number of attempts (default: 3)
Pass Threshold Minimum score to pass (default: 70%)

Rubric

The scoring rubric defines how the AI evaluates performance. See Scoring & Rubrics for full details.

Playback

The Playback tab on the editor rail controls how the course plays for learners.

  • Enable Autoplay — when on, the course viewer renders an autoplay toggle in the bottom nav bar beside the mute button. Learners opt in per session; the viewer never auto-starts. Once engaged, the course advances automatically:
  • Blocks with narration advance when the voice track ends.
  • Passive blocks without narration (slides, images, videos, YouTube, resources) advance on a 30-second fallback timer.
  • Interactive blocks (quizzes, scenarios, matching, acknowledgements) always wait for the learner to finish.
  • Enable Playback Speed (on by default) — exposes a settings cog in the course viewer's bottom bar. Learners can choose between 0.5× and 2× to slow down or speed up narration. Turn this off for compliance or attestation courses where pacing is part of the training record.
  • Both settings are version-scoped — changing them and publishing produces a new version only if the overall content has changed, otherwise it overwrites in place.

Previewing a course

Before you publish, click Preview in the Course Editor to see the course exactly as a learner will. The preview opens the learner viewer pinned to your current draft (or the latest published version if there is no draft).

In preview:

  • Every slide, image, video, and downloadable resource renders identically to the learner experience.
  • Voice narration plays so you can hear pacing, accents, and pronunciation.
  • Quizzes show their questions and options, including which answers are correct, so you can sanity-check the answer key.
  • Acknowledgements and matching activities show their wording and items but the submit / drag-drop actions are disabled.
  • Scenario blocks show their title, description, and grounding image; the AI chat is intentionally not started.

A persistent banner across the top reminds you you're in preview. Click Exit Preview to return to the editor.

Preview leaves no trace

Preview never starts a real session, never bills against AI usage, and doesn't appear in the workspace activity log. Use it as often as you like.

Accessible to: Trainers and Workspace Owners. Other roles don't see the Preview button, and direct links into the preview URL bounce them back to the catalog.

Publishing a course

Before you can publish, the course must have at least one tag in the Settings tab. Tags are how learners find your course in the catalog and how the workspace organises content — see Workspace Settings → Tags for managing the tag list.

  1. In the Course Editor, click Publish.
  2. Enter a version label (e.g., "v1.0", "v2.0-beta").
  3. Confirm the publication.

If the course has no tags yet, the publish action shows the validation error and bounces you to the Settings tab so you can add at least one before retrying.

Published versions are immutable

Once published, a course version cannot be edited. To make changes, create a new version. This ensures learners who were assigned a specific version always see the same content.