Onboarding Guide for Admins
Last updated: June 1, 2026
This guide breaks down the steps each of your team admins should follow in order to properly set up the Solidroad workspace. Each step includes what to configure and why it matters. Steps 1–4 lay the foundation (workspace, users, groups, roles), and steps 5–8 build the training content (personas, scorecards, simulations, and integrations). Once you have built out the foundation and training content, you will be able to start interacting and testing!
Step 1: Workspace description and general settings
Open Settings and complete the workspace description first. This is the single most important field for AI quality.
What to do:
From the admin home screen, navigate to Settings located at the bottom left of the page → Select Workspace.
Populate the workspace description with context about what the company does, who it serves, and who will use the platform. It’s important to prioritize this first as it pays dividends on every future simulation.
Scroll to the preferences section underneath and configure: hide simulation library from learners (optional), hide feedback from learners (optional), restrict access for admins, and any other toggles relevant to your company’s policies.
Why it matters: This workspace description context flows directly into every prompt the LLM uses. The more detail you provide here, the more granular and on-brand your generated simulations will be.
Step 2: Invite users and assign role-based access
Add the people who need access, then assign each one the appropriate role.
What to do:
Navigate to Settings → Click on Users.
Click the green Invite button in the top right.
Invite each team member by email. Ensure all new members access the workspace by clicking ‘accept invitation’ embedded within the invite email. If new members try to access the workspace by visiting solidroad.com and clicking ‘sign in’ at the top right, they will be blocked.
Assign one of the following role types: Admin, Trainer, Group Lead, QA, or Learner.
Role reference:
Admin — Can view and manage all workspace features.
Admin (read only) - Can view all workspace features, but not create or manage.
Group Lead — Can view reporting and create assignments for their assigned groups.
Learner — Can take assigned simulations and assignments; can view performance and certificates.
Trainer — Can manage and create training content and reviews assignments.
QA — Can manage quality evaluations and scorecards.
Why it matters: Every user has role-based access control. A learner won’t see the admin views; trainers can see their reports, but not platform settings. Group Leads can assign and see performance of their learners. Get this right before you start assigning simulations so people see the right surfaces from day one.
Step 3: Create user groups
Group users by how you actually run training and reporting.
What to do:
Navigate to Settings → Click on Groups.
Create groups that mirror your company’s internal naming — e.g. Tier 1 Support, Tier 2 Support, Tier 3, Escalations, by line of business, by tenure, etc.
Add each user to the appropriate group(s).
Why it matters: Groups let you filter reports by team and mass-assign simulations to a whole tier in one action instead of selecting individuals. This is the single biggest time-saver for ongoing admin work!
Step 4: Training settings: roles and teams
Tell the platform what your agents are called and how your teams are structured. This step is applicable to training teams, not QA teams!
What to do for Learner Roles:
Navigate to Settings → Click on Training → Select Learner Roles.
Create a role per job title (e.g. Customer Support Tier 1).
Write a description for each role — e.g. “Tier 1 support for Solidroad is responsible for replying to email only.” Treat this like a prompt.
What to do for Teams:
Navigate to Settings → Click on Training → Select Teams.
Create teams matching your company’s structure: tiers, contact centres, BPOs, partners, offshore vs. on-site, or however your company segments internally.
Populate the description field on each team.
Why it matters: The AI uses the role name and description when generating simulations and scoring them. “Tier 1 support for Solidroad is responsible for replying to email only, replies in under 2 minutes” produces a more specific simulation than the generic default. Treat these descriptions like prompts because this yields a far more on-brand scenario than the default.
Step 5: Build personas in the resource library
Personas are the AI customers your agents will speak to in simulations.
What to do:
Click on the Resources tab located in the menu column on the left → Select Personas from the dropdown menu.
For the first few personas, create them manually so you understand each field. Use AI generation later once you have the rhythm.
Upload an avatar image — We recommend having fun with this (Disney characters, Greek mythology, anything that makes it memorable for agents)!
Give the persona an AI name (creative fake names are always fun!).
Write a Description: who they are, what they care about, and why they choose your company.
Job Title and Company Name — you can leave this blank for direct-to-consumer use cases; if your use case is B2B personas, feel free to fill this in.
Select a voice from the voice library.
Fill in Context: are they patient, kind, angry, irate, difficult to please? This is what makes the persona feel real.
Why it matters: The persona has agency. The richer the persona, the more realistic the edge cases. Have fun with these. Real-life inspired personas land better with agents and make demos memorable!
Step 6: Create scorecards
Scorecards define how the AI evaluates each simulation. You can create your own, migrate an existing scorecard, or leverage our AI powered assistant Roadie to generate a scorecard for you!
What to do:
Click on the Resources tab located in the menu column on the left → Select Scorecards from the dropdown menu → Click on New Scorecard.
Name it — can be product-specific, skill-specific, process-specific, or a combination of the three (e.g. “Tier 1 Email Proficiency Test”).
Add Sections. Each section is either a skill (e.g. communication, empathy) or a process (which can connect to your existing knowledge base).
Set the top score per section. Default is 10, but you can weigh more impactful sections higher than 10 or less than 10 (e.g. compliance 20, greeting 5).
For each section, define the Rated Opportunities (Poor / Average / Great). Use the sliding toggle to set what % of agents land in each band.
For each criterion, either let the AI generate the “poor / average / great” descriptors (e.g. “delivers clear, on-brand messaging; empathetic next steps; reassures the customer”), or paste in your existing rubric language. You can edit as needed!
Choose grading style per section: Graded (numeric) or Pass/Fail (strict yes/no).
Open Advanced Settings to configure automatic-failure triggers — e.g. profanity → scorecard nets to 0; agent didn’t greet → section nets to 0; sharing third-party private info → full fail.
Why it matters: This is what powers feedback! Write each criterion as detailed as possible while avoiding ambiguous wording like continuously, essentially, or obviously. Weighting also matters: if first-call resolution is the metric the business is judged on, weight it heavily so the scorecard reflects that.
Meet Roadie, the AI assistant!
Roadie is Solidroad's AI assistant (our roadrunner mascot)!
What Roadie can help with:
Building scorecards from a description or a pasted rubric.
Setting up workspace fields and roles.
Answering platform questions without leaving the page.
How to use it
Click the Roadie icon (bottom right of most views) and describe what you’re trying to do. Treat it as a shortcut for the steps in this guide — especially scorecard creation.
Migrating existing scorecards:
If your company already has a scorecard to leverage, there’s no need to rebuild within Solidroad, you can import the scorecard and auto-generate!
What to do:
Gather the existing rubrics (Excel, Word, internal QA tool — whatever you have).
Paste rubric language directly into the scorecard criteria — or hand the doc to Roadie and it will create a scorecard based on the rubric you provide.
Why it matters: Leveraging an already created scorecard or rubric saves admin time that would otherwise be spent creating a new form from scratch.
Step 7: Create folders and create simulations
Once personas and scorecards exist, simulations come together quickly!
How to set up folders:
Click on the Resources tab located in the menu column on the left → Select Simulations → Click on the folder icon next to 'New Simulation'.
Create and name the folder that matches how your team will leverage the trainings.
Examples: Onboarding Week 1, Ramp, New Product, New Feature, Empathy Practice, Escalations.
How to create a simulation:
Click on the Resources tab located in the menu column on the left → Select Simulations → Click New Simulation.
Title — optional; one will auto-generate from the scenario if you skip it.
Channel — email, phone, chat, or video.
Scorecard — select the universal scorecard or a specific one.
Difficulty — easy, medium, or hard.
Language — pick from the language library.
Learner Role — from the roles you created in Step 4.
Learner Team — from the teams you created in Step 4.
AI Customer — pick a persona from Step 5: 'Creating a Persona'.
Prompt the AI with the scenario — voice-to-text or typed (e.g. “customer having issue with their account in the app”) and click Generate AI Scenario. We recommend voice if you talk faster than you type!
Optionally show or hide the scenario instructions to the learner. If you show the scenario instructions, they will be visible to the learner during the simulation.
Optionally toggle Learner Speaks First if you want the learner to open the call.
Save the simulation into the folder you created!
Why it matters: The simulation is the star of the show. Folders make assignment and reporting easier later on!
Step 8: Software integrations
If your company leverages a 3rd party provider, i.e. Intercom or Zendesk, you are able to integrate the provider into Solidroad!
What to do:
Click on Integrations located above Settings.
Click on your integration, fill in your company's integration details, and select Install Integration.
A prompt will appear requesting access to your provider data, and you may be redirected to the provider website in order to approve the integration.
After authorization, you will return to Solidroad. The integration will now appear as active, which confirms that the integration is live!
Why it matters: Integrations allow you to automatically pull in and evaluate your 3rd party chat, email, and phone conversations!