Disclaimer: Some content in this article outlines how to use functionalities that may not be available on all plans. Get in touch with your account manager (if your plan includes this option) or reach out to Docebo using your platform's Help center if you wish to upgrade your plan.

Introduction

The AI authoring tool is a powerful feature designed to streamline the creation and management of interactive lessons within your learning platform. With an intuitive interface, it allows you to arrange screens, add multimedia, and incorporate activities to engage learners. This article will guide you through the process of creating AI lessons, editing them with the AI authoring editor, and customizing your content efficiently.

For more information on the AI features of the authoring tool, refer to our frequently asked questions on AI features.

You can start creating your AI lessons from the Central repository.

Creating AI lessons

As a Superadmin or Power User with granted permissions, you can create AI lessons if you have an AI authoring seat assigned. Learn more about AI authoring seats.

To create an AI lesson, open the Admin menu from the gear icon in the top right corner of your platform. In the E-learning section, click on Central repository.

To add a new AI lesson in the central repository, select a folder from the left panel, then click on the plus button in the top right corner of the page and select New AI lesson. In the slide-out panel, set the AI lesson title and, optionally, its code and description. The description will appear to learners as they play the course. You can edit it if needed by using the field text editor. When you’re done, click on Create and edit.

You will be redirected to the AI authoring editor. Refer to the next chapter to learn how to edit your AI lesson.

Editing AI lessons with the AI authoring editor

You will be redirected to the AI authoring editor when you first create a new AI lesson, and you can access it anytime from the AI lesson editing page. To access the editor, find your AI lesson in the Central repository and click on its title. As an alternative, click on the ellipsis button at the end of the AI lesson’s row and select Edit. Next, click on Edit content.

When you edit the content of your AI lesson, the changes are automatically saved. You can leave the editor anytime by clicking on the X icon (Close editor) in the editor header.

Selecting a format and managing screens

First, choose the layout you want to start with by clicking on one of the previews on the page. You can edit your layout later by moving or adjusting elements on the page as explained in the next section.

You will be redirected to the first screen of your AI lesson. In the Screen panel on the left, you will find the list of your screens. You can close this panel by using the Close panel button, or open it by using the Screens button in the header.

To add a screen, click on Add screen at the bottom of the panel, then select if you want to add a content screen or an assessment screen. Content screens form the informative part of your AI lesson, while assessment screens serve as an evaluation of the learner’s understanding. Refer to the chapter Adding an assessment screen of this article for detailed instructions on assessment screens. To add a new content screen, select Content screen and choose the desired layout for your screen.

To rearrange the order of the screens, use the drag icon in the screen’s row or click on the related ellipsis icon and select Move up or Move down.

To rename a screen, click on the ellipsis icon in the screen’s row and select Rename. In the pop-up window, type the new name and click on Rename. This is the name that learners will see at the top of the screen when playing the AI lesson. To remove a screen, select Delete among the screen actions.

To undo or redo any action, use the corresponding arrow buttons in the editor header.

Adding and managing elements

Select the elements on the screen by clicking on them, or add new elements to your screen by clicking on Insert in the editor header and selecting the desired type of element.

To enter a text element, select Text. Next, select the format of the text you want to add among the proposed options.

Select the text element and type in your text. To edit the text formatting, select the desired text. An editing bar will appear, from which you can select the desired options:

• Apply bold, italic, underlined, or strikethrough formatting
• Change the text color
• Change the type of paragraph (for example, heading, subheading, or description)
• Adjust the text alignment
• Format as numbered or bulleted list
• Insert a link.

To edit the text with the help of the AI revision tools, select the text box and click on one of the icons above it: Rephrase, to rework your sentences and express them in a different way, Expand, to lengthen your text, or Reduce, to shorten it.

Notes on AI text revision:

• AI revision is only available if you have activated AI features for authoring in the Artificial intelligence control panel
• The AI revision tools support all languages. However, right-to-left languages are not yet fully supported in the user interface. We are working on improving this functionality.

Refer to the next chapters to learn how to insert media and activity elements.

To rearrange the elements on the page, select them, click on the drag icon and drag them to the desired position.

To delete an element, select it and click on the trash icon.

You can resize a text or media element by selecting it and clicking on the square along the bottom or side border line, then drag it to the desired size. Note that side resizing is only possible for elements that don’t span the full width of a row (you can drag and drop elements as explained in the previous section to adjust their layout).

Adding and managing media

To embed an image from a URL, click on Insert and select Media, then click on Embed image. To change your image, select it and press the gear icon (Image settings). In the slide-out panel, insert the URL of the image you want to use.

You can also insert images and videos from files. To do so, click on Insert and select Media, then click on Media library. In the slide-out panel, you can upload your file or select a previously uploaded one. Check the list of supported files for AI authoring media. Once you have uploaded a file, if auto tagging is enabled, the platform’s AI will analyze it and assign it tags, so that you can easily find your media by looking for tags as well as for media titles.

When browsing media, you will see them all if you are in the root folder. To browse a specific folder, click on Folders in the header and select the desired folder or subfolder. If you are a Power User, you will only see the folders that you were granted visibility on. You can also use the search bar to search for specific media titles or tags, and filter media by type (image or video).

As an option, click on the ellipsis icon in the top right corner of a media to edit its details (title and tags) or to move it to a different folder. The media library folders are the same as the folders in your central repository. When you upload a media, this will be placed by default in the root folder, but you can organize them as you prefer. 

Select the media that you want to insert in your AI lesson by clicking on it, then click on the Insert button. To replace a media, while on the desired screen, click on the gear icon (Media settings) at the top of the media. If the media comes from a link, you can edit the URL as desired in the slide-out panel. If it comes from a file, note that a URL will be automatically generated and can't be edited. In the slide-out panel, click on Replace media, then browse or upload your files as explained in the previous section.

Adding and managing activities

Activities are questions for your learners, meant to increase their engagement with the AI lesson and to check their understanding of specific concepts.

To insert an activity, click on Insert and select Activities, then choose the desired type of activity:

• Multiple choice
• Single choice
• True or false
• Fill in the blank.

Type your question and the related answers. For multiple choice activities, select all the correct answers that apply. For single choice activities, select the one correct answer. Click on the drag icon in an answer’s row to move it up or down, or click on the trash icon to delete it. To add more options, use the Add answer button.

For true or false activities, just type the question and select the correct answer.

For fill in the blank activities, type your question and add one or more blanks by clicking on Add blank or typing Control+Shift+A or Option+Shift+A. In the pop-up window, type one or more correct answers and add them to the list by clicking on Add answer. You can add up to 10 possible correct answers. To remove answers, click on the X icon next to the desired answer. When you are done, click on Confirm. You can edit the answers by clicking on the blank, or remove blanks by using the corresponding X icon.

Once you have defined the question and the answers for an activity, you can click on Done to finalize it and preview what the activity will look like for the learner. To further edit the activity, just click on the activity element.

Click on the gear icon (Activity settings) of an activity to optionally customize its settings:

• Set the number of attempts the learner will have to perform the activity
• Assign a score to the activity
• Make the activity mandatory so that the learner cannot complete the AI lesson without performing the activity
• Show the correct answers after the learner has submitted their answer.

Adding an assessment screen

To add an end-of-lesson assessment to your AI lesson, click on the Add screen button and select Assessment screen. You will have two options for creating your assessment:

• Add activities manually: Choose this to manually add activities and write your questions and answers
• Auto-generate activities: If you select this option, the AI will analyze your lesson's content and create activities automatically. In the pop-up window, select the desired number of activities and the types you want to include among the available options, then click Confirm. The AI will generate the assessment screen, and you can review and edit the activities as needed.

Notes on AI-generated assessments:

• AI assessments are only available if you have activated AI features for authoring in the Artificial intelligence control panel
• The AI requires a minimum of 200 words in your lesson content to automatically generate activities.
• For lessons with fewer than 450 words, it is recommended to select no more than 8 activities for optimal performance.
• AI assessments are based on the lesson content at the time of creation. If you update the content, you can manually revise the assessment or generate a new one to include the changes.

As an option, you can assign a score to each activity in the assessment. To do so, click on the gear icon (Activity settings) of an activity, then type the desired score in the slide-out panel, and close the panel when done.

By default, the assessment screen will be placed at the end of the lesson, but you can rearrange it as explained in the chapter Selecting a format and managing screens of this article.

Customizing themes

You can customize the theme of your AI lesson by clicking on the Theme button in the header. In the slide-out panel, select the desired background color, font, and text color. This customization will be applied to the current screen.

To reset the screen to the default theme, press the circular arrow icon (Reset to default theme) in the Current theme field.

To apply the customization to the whole AI lesson (including any new screens that you will add), click on the Update default theme button. A pop-up window will open, where you can choose if you want to overwrite any possible customization you have made in other screens.

Please note! You cannot create new themes at the moment, so the updated default theme will only be applied within the current AI lesson, and not in future AI lessons. Also note that you cannot customize activities.

If you want to apply the customization only to the current screen, simply close the theme panel when you are done.

Previewing AI lessons

To preview how learners will see the AI lesson, click on the play icon (Preview) in the editor header. Browse screens by using the arrow icons on the sides, and exit the preview mode by clicking on the pen icon (Back to editor lesson).

Publishing AI lessons

You need to publish your AI lesson before you can assign it to courses as training material. To do so, click on the Publish button in the editor header. 

While all your changes in the editor are automatically saved while you work, they only appear in the published version of your training material after it’s been published. If you update and publish an AI lesson that’s already assigned to courses, the version in those courses will automatically be updated. Refer to the Assigned courses tab chapter of this article to learn more about assigning AI lessons to courses.

AI lessons are published in xAPI format. However, they don’t have the same tracking settings as the other xAPI training materials in the platform. Refer to the next section for information on AI lesson tracking.

AI lesson tracking

As learners play AI lessons, the following events are tracked:

• Lesson opened: When a learner opens an AI lesson
• Screen started: When a learner begins a new screen within the lesson
• Screen progress: Tracks the progress of the learner on a screen, calculated as a percentage
• Screen completed: When a learner completes a screen within the lesson
• Lesson completed: When a learner completes the entire lesson
• Activity submitted: When a learner submits an activity
• Scores: The scores achieved by the learner for activities
• Number of attempts: Tracks the number of attempts a learner makes on an activity
• Video started: When a learner starts watching a video
• Video paused: When a learner pauses a video
• Video completed: When a learner finishes watching a video.

Managing AI lessons

To manage your AI lesson, find it in the Central repository and click on its title. As an alternative, click on the ellipsis button at the end of the AI lesson’s row and select Edit.

Properties tab

Details

The Details vertical tab allows you to manage the details of the AI lesson training material (except for the type, which cannot be changed). Upon creation, the training material is assigned to the folder where it was created. Use this area to move it to a different folder, if needed.

As an option, you can assign a thumbnail to the training material, and add a short description and tags (up to 15) to improve its searchability in your platform’s global search.

To enter the AI authoring editor, click on Edit content. Refer to the previous chapter to learn how to edit the content of your AI lesson with the AI authoring editor.

View mode

Move to the View mode vertical tab and select the view mode for the training material in the course player: inline, theater mode, stand-alone mode or new window.

Assigned courses tab

The Assigned courses tab lists the courses to which the training material is assigned. Click on Assign to courses in the top right corner of the page to assign the training material to other courses by selecting them from the slide-out panel and clicking on Assign.

Find out more about managing the content coming from the Central repository in courses.

Notes for Power Users

• This tab is not visible for the Power Users who do not have View permission on courses.
• The Power Users who have the View permission on courses can see the tab and the courses assigned to them, but cannot create new assignments.
• The Power Users who have View and Edit permissions on courses can see the tab and the courses assigned to them as resources, and can assign the training material to the other courses they manage.