Browse the docs

Get started

Finding your way around the app

The top bar, the command palette, Studio and its tabs, the Create dialog, notifications and the What's New page, and where each one takes you.

Plans: All plansView as Markdown
On this page

Inside the app, devlin.ai keeps its navigation in a bar across the top of every page. This page explains what is in that bar, how to jump anywhere with the command palette, how Studio is laid out and what its Create button offers, what the notification bell tells you, and where to read what has changed in the product.

The top bar

The top bar stays in place while a page scrolls. From left to right it holds:

  • The devlin.ai logo. Selecting it takes you to Studio.
  • The workspace switcher, which shows the active workspace. Studio, Results, Publish and the credit balance all show that workspace. See Personal and organization workspaces.
  • The destination tabs: Studio, Results and Publish. The tab you are on is highlighted.
  • The credit balance of the active workspace, which links to Settings → Credits & Billing. It is hidden on phone-width screens.
  • The notification bell. See "Notifications" below.
  • The account menu, shown as a circle with the first letter of your email address.
  • The Menu button, a three-line icon at the far right.

On narrower screens the tabs and the workspace switcher move to a strip directly under the top bar, and that strip also stays in place while you scroll. On phone-width screens the account menu is folded into Menu.

The top bar is also there while you create a simulation, a coach or an organization, so you can leave those screens through any tab.

While a page loads, the top bar stays where it is and the content area shows a spinner.

The three destinations

  • Studio is the library of everything you have built in the active workspace. Unless a link sent you somewhere specific, it is the page you land on after signing in. See "Studio" below.
  • Results shows what learners did across the workspace. See The Results dashboard.
  • Publish has three tabs: Publish → Overview, Publish → Hosting and Publish → SCORM Wrap. See Publish a simulation and Hosting and SCORM Wrap.

Settings is not a tab. You reach it from the account menu.

The account menu

The account menu starts with your email address and, under it, a line that names the active workspace and its plan. It then lists:

  • Plans, which opens Settings → Plans. See Plans and features.
  • A link to Settings → Credits & Billing. See Credits and usage.
  • Account settings, which opens Settings → Account. See Your account.
  • Workspace settings, which opens Settings → Workspaces.
  • The theme choice for the app.
  • Sign out.

The Menu button

Menu holds these items:

  • What's New opens the in-app list of product changes. See "What's New" below.
  • Docs opens the devlin.ai documentation in a new browser tab.
  • Homepage shows the devlin.ai homepage inside the app, with the top bar still in place.
  • Share feedback opens a form that sends your feedback to devlin.ai.

The command palette

The command palette is a search box that opens over any page in the app. Press Cmd+K (Ctrl+K on Windows) to open it, and the same keys to close it. It opens only from the keyboard: there is no button for it.

Type in the box, which reads "Search simulations, coaches, actions…". The list has three sections:

  • Actions are places to go. Each one matches when what you typed appears anywhere in its name. They include Go to Studio, Go to Results, Go to Learners, Go to Publish, Go to Settings, Go to Simulations, Go to Coaches, Go to Evaluators, Go to Knowledge, Go to Hosting, Go to SCORM Wrap, Go to Plans, Go to Account, What's New and Create simulation, which opens the simulation creation screen.
  • Simulations are the simulations of the active workspace, matched by name. Each row shows the simulation's status, and selecting one opens it in the editor.
  • Coaches are the coaches of the active workspace, matched by name. Selecting one opens it in the editor.

Things to know:

  • Before you type, the palette lists every action, then a few of the newest simulations and coaches.
  • Once you type, matching simulations and coaches come first, followed by matching actions. Only the first few matching simulations and the first few matching coaches are listed, so type more of the name to narrow the list.
  • The palette does not search evaluators or knowledge bases. Use Go to Evaluators or Go to Knowledge and look in that Studio tab.
  • Switch workspace… opens the workspace switcher. So does Cmd+Shift+O (Ctrl+Shift+O on Windows).
  • One action depends on the active workspace: Go to Personal workspace settings in your personal workspace, Go to Organization settings in an organization.
  • Use the up and down arrow keys to move through the list and Enter to open the highlighted row. Escape, or a click outside the palette, closes it.
  • If nothing matches, the palette says "No results for" followed by what you typed.
  • If your simulations and coaches cannot be loaded, the palette says "Couldn't load your simulations and coaches." Select Retry. The actions still work in the meantime.

Studio

Studio is the library for the active workspace. Under the heading Studio, a row of tabs switches between the kinds of content. There is no combined view: each tab lists one kind.

  • Simulations opens first. It lists every simulation under Your Simulations.
  • Coaches lists every coach under Your Coaches.
  • Evaluators lists your evaluators, which score work that learners submit. Evaluators are on every plan. See Evaluators.
  • Knowledge holds your knowledge bases, under Knowledge Bases. Knowledge bases are on these plans: Core, Team, Enterprise. On other plans the tab is still there, and it shows an upgrade prompt with a button that opens Settings → Plans. See Knowledge bases.

Selecting a tab changes the page address, so you can bookmark a tab or share a link to it.

The Simulations and Coaches tabs

Both tabs work the same way. Each item is a card with its type, its name, a short line about it and its status. Selecting a card opens the item in its editor.

Once a tab has at least one item, it also shows:

  • A search box, which matches on the name. For simulations it also matches on the character description, and for coaches on the coach's own name.
  • A status filter: All statuses, Published, Draft or Archived.
  • A sort order: Newest first, Oldest first or Name A–Z.
  • A switch between List view and Tile view. Your choice is remembered in the browser you are using.
  • A New simulation or New coach button beside the heading.

Once the tab has an item, or the workspace has a folder, a row of folders sits above the list. See Organizing Studio with folders.

An empty tab shows a short introduction and a button instead: Create simulation on the Simulations tab, Create Your First Coach on the Coaches tab.

The Create button

Create, at the top right of Studio, opens the Create new dialog. It asks "What do you want to create?" and offers:

  • Simulation: "A practice conversation with an AI character."
  • Coach: "Real-time guidance and debrief conversations."
  • Knowledge base: "Reference documents the AI grounds its answers in."

What happens next depends on your choice:

  • For a simulation, describe who the learner is and what they need to practice under Explain your simulation, then select Generate simulation. devlin.ai builds the simulation from your description and shows you a preview. A description is required. To skip it, select Start from scratch, which creates a blank simulation named "Untitled simulation" and opens it in the editor. See Create a simulation.
  • For a coach, describe what it should help with under Explain what this coach should help with, then select Generate coach. Start from scratch creates a blank coach named "Untitled Coach" and opens it in the editor.
  • For a knowledge base, enter a name under Knowledge base name and confirm. The knowledge base is created and Studio switches to the Knowledge tab, where you add documents. On a plan without knowledge bases, this step shows the upgrade prompt instead.

When you opened the dialog with Create, All types takes you back to the list of choices. Cancel closes the dialog without creating anything. Browse templates, on the first step and the knowledge base step, opens the template gallery. See Start from a template.

The New simulation and New coach buttons, and the buttons on an empty tab, open the same dialog with the type already chosen. Evaluators are not in the Create new dialog: create one with New evaluator on the Evaluators tab.

Until your personal workspace has a name, opening the app shows a welcome form over Studio, and the Create new dialog follows it on the simulation step. See Sign in and first steps.

Notifications

The bell in the top bar collects things that happened in your workspaces while you were doing something else. Notifications are personal: each member gets a copy and reads it separately.

What creates a notification

  • A first evaluated learner session. The first time a learner session in a workspace is evaluated, every member gets a notification that names the simulation and says it "got its first completed learner session." Test sessions do not count, and this happens once for a workspace, not once for each simulation. Selecting it opens Results.
  • A comment on a review link. Every member is told who commented and on what. A member who posts a comment is not notified about their own comment. Selecting it opens the simulation on its publish stage. See Review links.
  • A change in pass rate. A weekly check compares the workspace's pass rate for the last week with the week before. When the two differ by 10 percentage points or more, and each week has at least 5 scored sessions, every member is told that the pass rate dropped or moved up, with both rates. Selecting it opens Results.
  • Low credits. Every member is told when the balance falls below one of the workspace's low-credit thresholds, with the credits remaining. Selecting it opens Settings → Credits & Billing. See Credits and usage.
  • Out of credits. When a session, an evaluation or a generation is declined because the workspace cannot pay for it, every member gets "A session was declined: your workspace is out of credits." A workspace that has never had any credit activity does not get this. This is sent at most once in any 24 hours.
  • A daily spending cap is close. When a simulation or a coach has used 80% or more of its daily credit limit, the owner and admins of the workspace are told which one and how much. Members are not. Each simulation and each coach sends this at most once in any 24 hours. Selecting it opens the item's publish stage. See Daily spending caps.

Reading notifications

  • A badge on the bell shows how many notifications you have not read, up to a ceiling, after which it shows a plus sign. The count is taken when the app loads and does not update by itself. Open the bell, or reload the page, to see whether anything new has arrived.
  • Select the bell to open the list. It shows your most recent notifications, newest first, each with how long ago it happened. Until you have any, it says "No notifications yet." If the list cannot be loaded, it says "Couldn't load notifications." Select Try again.
  • Opening the list marks the unread notifications shown in it as read and clears the badge. Only the most recent notifications are shown, so if you have more unread ones than that, the older ones stay unread and the badge comes back the next time the app loads.
  • Selecting a notification takes you to the page it is about.
  • The list is not limited to the active workspace: it includes notifications from every workspace you belong to. A notification opens its page in the workspace that is active, so switch to the workspace it came from first.

Several of these events also send an email. The pages linked above explain who receives it and how to turn it off. The notification in the app is created either way.

What's New

What's New lists what has shipped in devlin.ai: "New features, improvements, and fixes as they ship". Open it from Menu, from the What's New action in the command palette, or from the link in the page footer.

  • Entries are grouped by month, with the newest month and the newest entries first.
  • Each entry has a label, its date, a title and usually a sentence or two of detail. The label is New for something you could not do before, Improved for a change to something that was already there, and Fixed for a problem that was corrected.
  • An entry about something that has a documentation page also has a Read the docs link, which opens that page in a new browser tab.
  • The same list is public on the devlin.ai website for people who are not signed in. When you are signed in, that address brings you to the in-app page.