devlin.ai documentation
Build practice simulations, embed them in your courses, and see how learners perform.
Get started
- Signing in and your first stepsSign in with an email code, Google, Microsoft or your company login, complete the welcome form, and keep a simulation you built in the homepage demo.
- Finding your way around the appThe top bar, the command palette, Studio and Brain and their tabs, the Create dialog, notifications and the What's New page, and where each one takes you.
- Starting from a templatePick a ready-made simulation or coach from the template gallery and get an editable draft copy in your workspace.
- Organizing Studio with foldersGroup simulations and coaches into folders, find them with search, filters and sorting, and duplicate, move, transfer or delete them.
Simulations
- Appearance and branding for simulations and coachesSet the colors, sizing, character portrait, loading screen and devlin.ai branding that learners see in a simulation or coach.
- Building a simulation: character, scenario and editorUse the simulation editor to define the character, the scenario and the learner's role, save your changes, and test the conversation in a live preview.
- Creating a simulationDescribe a scenario and devlin.ai generates a draft simulation you can preview, publish, or refine in the editor.
- Evaluation and scoring: criteria, pass threshold and feedback-only modeHow a simulation is evaluated when it ends, from criteria, rating scales and deductions to the pass threshold and feedback-only mode.
- How a simulation ends: end conditions and turn limitsA simulation ends when the character recognizes one of your end conditions or when the learner reaches the turn limit you set.
- The start screen learners see firstAdd a title screen with a heading, text, image and button that learners see before a simulation or coach conversation begins.
- Version history, undo and restoring a versionEvery save and publish keeps a snapshot of a simulation, so you can undo edits in the editor or restore an earlier version.
Coaches
- Building and publishing a coachCreate a coach, set its persona, guidance style, content and session ending, test it, then publish it and share its link or embed code.
- Linking a coach to simulations and evaluatorsLink a coach to simulations and evaluators so it can help during a live simulation and debrief the learner's results afterwards.
- Coach sessions across slides, reloads, and course restartsA coach keeps one conversation for the whole course sitting, and it resumes when the learner returns to the slide.
Evaluators
Journeys
- Building a journeyCreate a journey, lay out chapters, pages and blocks, set its checkpoints, paths, scorecard, theme and coach dock, and restore earlier versions.
- Publishing and sharing a journeyPublish a journey, share its learner link, preview the draft, export it for an LMS, and see how many learners open and finish it.
- Knowledge check resultsHow journey knowledge checks are graded, where to review every attempt and each question's results, and what reaches your LMS or LRS.
- Journey resultsHow a journey is scored from learners' runs, and how to drill from the journey to each item, its criteria or questions, and single attempts.
Knowledge bases and source materials
- Brain: audience profiles and organization contextHow audience profiles and organization context are created, attached to a simulation, and added to the character's instructions in text conversations.
- Custom charactersCreate a character portrait in a set of moods by describing or uploading it, choose its framing, and see how images are checked and what they cost.
- Document versions: replacing a document in placeUpload a new version of a library document so everything that uses it moves to it with no relinking, and see which version an evaluation was judged against.
- Grounding simulations and coaches in a knowledge baseAttach knowledge bases and documents to a simulation or coach, choose whether sources are cited, and control how voice sessions use them.
- Knowledge bases: uploading and managing documentsUpload reference documents to your workspace library, group them into knowledge bases, and see what each processing status and limit means.
- Recordings: building from a meetingUpload an audio or video recording of a meeting as a source and get a transcript with speakers and times that drafts are built from.
- Source materials: building from documents and linksAdd documents and public links when you create a simulation or coach so the draft is built from your own material, and choose whether to keep them.
Voice
- Letting learners switch between text and voiceChoose whether learners can move between text and voice on a link, and whether a failed voice session offers text, for a simulation or a coach.
- Setting up voice for a simulation or coachTurn on voice for a simulation or a coach, pick a voice, and set the session length limit, the transcript default and the voice turn limit.
- Voice sessions: how they run, end, and start from a course buttonWhat a learner sees in a voice session, how it ends, what is charged, and how to start or end a simulation's or coach's session from a Storyline button.
- Voice simulations on iPhone and iPadOn iPhone and iPad, an embedded voice simulation can open a separate voice window so the learner can grant microphone access.
Publish and embed
- Embedding a simulation in Articulate StorylineArticulate Storyline embeds a simulation through a Web Object that takes a URL, not an iframe tag.
- Embedding a simulation in Rise 360Paste a simulation's embed snippet into a Rise 360 lesson, then patch the Rise SCORM export so the simulation's result reaches your LMS.
- Hosting and SCORM WrapHost whole eLearning packages and static websites on devlin.ai, or wrap a single HTML course as a SCORM package.
- LMS packages: SCORM and xAPI reportingDownload a simulation or coach as a SCORM or xAPI package, and see exactly what it reports to your LMS and when.
- Publishing a simulation and sharing its linkPublish a simulation to make its learner link and embeds work, share the direct link, and unpublish it to take it offline.
- Stakeholder review links and commentsCreate a link that lets a stakeholder try a simulation and leave comments without a devlin.ai account, then read the comments in the editor and resolve them.
- Storyline variables a simulation or coach writesA simulation or coach writes completion, results and your own custom variables into the Articulate Storyline course that hosts it.
Results and analytics
- The Results dashboardWhat the workspace-wide Results screen shows, how each number is counted, and how to get from it to one simulation, coach or learner.
- Skills and business goalsDefine the skills your practice builds, tag criteria with them, follow each skill's score over time, and keep each business goal's evidence by level.
- Criteria breakdown and attempt limitsShow learners a per-criterion breakdown of their result, and control how many attempts they get.
- Exporting results, transcripts and evaluationsDownload attempts, transcripts, evaluations, evaluator results, coach sessions and workspace totals as CSV, and see what each file contains.
- Learner history and AI summariesLook up one learner, read their simulation attempts, evaluator results, coach sessions and knowledge checks, generate an AI summary, and export them.
- Results for one simulation or coach: attempts, transcripts and human reviewRead the results of one simulation or coach, open an attempt's transcript and evaluation, and review, override or delete a result.
- Results links for trainers and managersShare a read-only, live view of learner results with a trainer or manager who has no devlin.ai account, with optional names and an AI debrief.
Workspace and team
- Collecting learner identityTurn on learner identity for a workspace so simulations can record who took each attempt, with an identifier and supporting fields you define.
- Data privacy, retention and learner data requestsSet how long learner data is kept, download a full workspace export, and see how one learner's data is exported or deleted on request.
- Members, roles, invitations and the activity logInvite people to an organization workspace, set their roles, manage seats, and review the organization's activity log.
- Personal and organization workspacesEvery account has a personal workspace and can create or join organization workspaces, each with its own simulations, plan and credits.
- SAML SSO and multi-factor authenticationHow SAML single sign-on works for an organization, and how to protect your own account with a code from an authenticator app.
- Sub-workspacesRun several workspaces under one parent workspace, with the parent's owners and admins in charge of every sub-workspace.
- Your account: profile, email, theme, digest and deleting your accountSet up your profile, change your sign-in email, choose a dark or light theme, choose whether you get the weekly digest, and delete your account.
Plans, credits and billing
- Plans and what each includesThe devlin.ai plans, what each one includes, what the Plans page shows for your workspace and role, and how founders pricing works.
- Changing, switching or cancelling a subscriptionSubscribe, move between plans, switch between monthly and annual billing, cancel, fix a failed payment and download receipts.
- Credits, usage and low-credit alertsWhat credits are, what spends them, how they are granted and expire, how to top up, and how low-credit alerts work.
- Daily spending caps for simulations and coachesLimit how many credits one simulation or coach can use in a day, set a workspace default, and see what learners and owners are told at the limit.
Integrations
- MCP server, connecting ChatGPT, Claude, Claude Code, and Cursor to a workspaceThe devlin.ai MCP server lets AI tools read and change a workspace directly.
- Power BI exportConnect Power BI to an organization's results with a read-only API key and the Power Query snippets in Settings, and see what each dataset contains.
- Sending statements to your own LRSConnect a workspace LRS so devlin.ai sends every attempt's xAPI statements to it from its servers, with credentials stored encrypted and never shown again.
- xAPI reporting settingsChoose what xAPI statements from LMS packages carry, criteria, transcript links, messages and learner fields, and open an attempt from its transcript link.
Languages and accessibility
Design guidance
- Choosing text or voice for a simulationMatch the simulation's mode to the channel the skill is used in on the job, and weigh what a voice session costs.
- Designing evaluation criteria and pass thresholdsWell-designed evaluation criteria make a simulation's score meaningful; vague criteria make it a coin flip.
- Is practice the right fix?Practice fixes skill gaps. Check whether the problem is a skill gap or something in the work environment before you build.
- Measuring whether a simulation workedDecide during design what "worked" means, so every simulation ships with a measurement story.
- Scenario realism, difficulty, and simulation seriesMake scenarios realistic through cues rather than decoration, and tune difficulty to the audience.
- Seat time, scope, and pacing for simulationsUse seat time as a scoping tool to decide how much one simulation should attempt.
- Writing learning objectives for simulationsA simulation objective is an observable behavior the learner performs inside the scenario.
Ask devlin
- Building and managing content with devlinHow devlin turns a request into a change, builds drafts in the background, works with attached sources, and what it will not do.
- Trying ask devlin with an event offerWhat an event offer gives a workspace, how long it lasts, and what stays afterwards.
- devlin (the assistant) and getting around the appdevlin is the built-in assistant that helps design, edit and manage simulations by conversation.