Introduction
AI roleplay is a Creator feature that helps learners practice real-world conversations in a simulated environment, featuring a virtual avatar powered by synthetic voice technology.
Please note: You now create and manage AI roleplays mainly in the AI roleplay section of the platform. Learn more in AI roleplay overview. This article describes how to use AI roleplay in Creator lessons.
This article explains how to add and use AI roleplay scenarios in a Creator lesson, including how to write effective prompts and provide supporting details so the AI can generate useful, realistic interactions. You can create AI roleplay scenarios for any type of conversation.
Learn how to create and manage Creator lessons and how to use the Creator tool.
Requirements and limitations
- AI roleplay is only available if you have activated the corresponding card in the Artificial intelligence control panel.
- While the learner experience for AI roleplay scenarios can be localized into all languages available for Creator lesson translations, the scenario configuration panel is available in English only, regardless of your platform language. Learn more on translating Creator lessons.
- Learners cannot start a simulation if no Simulation Pack is active or no simulations are available to them. This also applies to roleplays in Creator lessons. Learn more in Managing simulation pools.
Creating AI roleplay scenarios
You create new AI roleplays in the AI roleplay section. When you add AI roleplay to a lesson, a side panel lists the roleplays that already exist. Select one to add it to the lesson. You cannot create a new roleplay from Creator. Learn more in Creating and managing AI roleplays.
From an existing Creator lesson, use the plus icon to open the elements menu, then select AI roleplay in the AI category.
Configuring a scenario
For instructions on configuring a roleplay, see Creating and managing AI roleplays and Best practices for writing AI roleplays. For rubrics and reviewers, see Configuring evaluation, rubrics and reviewers in AI roleplay.
Configuring a legacy sales scenario
Please note! It is no longer possible to create new sales scenarios. Sales scenarios now use a configuration panel aligned with the standard scenario panel, so scenario setup follows a more consistent structure across scenario types. Legacy sales scenarios remain available and continue to work, but they do not receive new functionality. If you want to migrate an existing legacy sales scenario to the updated configuration, get in touch with your Customer success manager or contact us through Docebo Community (opens in a new tab).
The following section documents the configuration of existing legacy sales scenarios.
When you select a sales template, the sales scenario configuration panel opens. This panel is optimized for sales conversations with dedicated fields for customer profiles and company information. You can configure several sections. Let’s go through them one by one.
Interaction mode
Select how learners will interact with the AI character during the scenario.
- Video: Learners interact with an animated AI character that speaks and moves on screen. This mode provides the most immersive experience.
- Voice: Learners talk with the AI character through voice while a static avatar image appears on screen.
- Chat: Learners exchange written messages with the AI character through text only.
Scenario
Select one of the available options:
- Understanding needs: The learner practices how to ask the right questions and uncover the customer’s goals and challenges
- Addressing concerns: The learner responds to customer objections and builds trust through effective communication. For this scenario, you need to add at least one concern in the corresponding text field, but we suggest including two or three for the best results. Ensure each concern is specific, realistic, and clearly separated from the others. You can include different types of concerns to cover varied situations.
- Offering solutions: The learner presents a product or service as a tailored solution, focusing on value and benefits for the customer.
As an option, you can add context to your scenario. Click on the Add button to add:
- Customer knowledge: Describe what the customer already knows before the simulation begins. This may include information from previous conversations with the learner, such as having seen a demo or reviewed pricing. It helps the AI interpret the customer as being partially informed and adjust their responses accordingly.
- Scenario details: Add contextual information that helps the AI align the customer’s responses with the scenario. This field is flexible and can include anything relevant to the situation—like company priorities, internal blockers, or specific product considerations the learner should be aware of.
Customer profile
In this section, you can select one of the predefined profiles, optionally edit it, or create a new customer profile from scratch. Click on the ellipsis icon in the desired profile’s row to edit or delete the profile, or click on New customer profile to create one. You will need to enter a customer name and description. Press Save changes when you’re done.
AI character
Select one of the available characters or create a new one. Click on the ellipsis icon in the desired character’s row to edit or delete the character, or click on New character to create a new one.
Click on Select avatar to browse the avatar library. You can search avatars by name or filter them by appearance, age, and setting. Select the desired avatar by clicking on its card and press Confirm.
You can also define the character’s name, role, and personality:
- Approachable: Open to dialogue but resistant to change. This customer is friendly and collaborative, yet hesitant to shift from current solutions without strong justification.
- Vague: Evasive and hard to pin down. This personality avoids commitment and gives unclear or indirect answers, requiring the learner to ask targeted, clarifying questions.
- Skeptical: Questions assumptions and pushes back. This type of customer challenges the learner, raising objections or doubts that must be addressed with confidence and persuasive reasoning.
Press Save changes when you’re done.
My company
In this section, you can use the predefined company or create your own company profile. Click on the ellipsis icon in the desired company’s row to edit or delete the company, or click on New company to create one. You will need to enter a company name and description. Press Save changes when you’re done.
Advanced settings
Press the Settings button at the bottom of the panel to open an additional configuration window. Here you can define the following options:
- Time to complete: Set a time limit for the scenario. This option is only available in video and voice mode and can range from 5 to 20 minutes.
- Number of attempts: Define how many times the learner can attempt the scenario.
- Make scenario optional: If you select this option, the learner can complete the Creator lesson without performing the scenario. This option is not available when at least one reviewer is assigned, because submission is required for the review process.
- Introduction card: Set the information shown to learners before the scenario starts. Enter a title; the description is automatically generated by AI once the scenario is created. You can edit the title at any time by clicking on it directly on the introduction card.
Once you have set up your scenario, press the Save configuration button at the bottom of the panel. To see the learner experience, preview the Creator lesson.
AI-generated reports
Learn more in Practicing with AI roleplay and reading your report.
Best practices
Learn more in Best practices for writing AI roleplays.