Global Field Glossary

Field Name	Description	Type	Example Value	Used In Reports
`trainee_email`	Email address of the trainee	string	`[email protected]`	Trainee Performance Summary, Quiz Overview, Session Overview, Topic Breakdown
`trainee_name`	Full name of the trainee	string	`Jane Doe`	Trainee Performance Summary, Quiz Overview, Session Overview, Topic Breakdown
`course_name`	Name of the training course	string	`Course 1A`	Trainee Performance Summary, Session Overview, Topic Breakdown
`task_name`	Specific task or simulation name	string	`HVAC Present Step`	Trainee Performance Summary, Topic Breakdown
`first_ai_score`	Initial AI-generated score for the task	number	`68`	Trainee Improvement: First to Best
`best_ai_score`	Highest AI score achieved by the trainee	number	`91`	Trainee Improvement: First to Best
`number_of_attempts`	Total number of attempts made by the trainee	number	`5`	Trainee Improvement: First to Best
`first_to_best_calculation`	Percentage improvement from first to best score	string	`44%`	Trainee Improvement: First to Best
`manager_name`	Name of the trainee’s manager	string	`Chris Wrolstad`	Trainee Performance Summary, Quiz Overview, Session Overview
`manager_email`	Email of the trainee’s manager	string	`[email protected]`	Trainee Performance Summary, Quiz Overview, Session Overview
`team_name`	Name of the team the trainee belongs to	string	`Team Jessy`	Proficiency Heatmap, Trainee Performance Summary
`region`	Geographic region of the trainee	string	`Field`	Proficiency Heatmap, Quiz Overview, Session Overview
`segment`	Business segment (e.g., HVAC, Plumbing)	string	`HVAC`	Proficiency Heatmap, Quiz Overview, Session Overview
`session_duration`	Duration of the simulation session	time	`08:06`	Session Overview
`session_score`	Score achieved in the session	number	`94`	Session Overview
`quiz_score`	Score achieved in a quiz	number	`86`	Quiz Overview
`passing_score`	Minimum score required to pass	number	`90`	Quiz Overview
`account_name`	Name of the account or organization	string	`Example`	Monthly License Usage
`plan_type`	Type of license plan	string	`Seats (annual)`	Monthly License Usage
`amount_used`	Number of seats or licenses used	number	`43`	Monthly License Usage
`amount_paid`	Amount paid for licenses	number	`150`	Monthly License Usage
`percentage`	Usage percentage	string	`29%`	Monthly License Usage
`accumulated_usage`	Total usage over time	number	`43`	Monthly License Usage
`deactivated`	Number of deactivated licenses	number	`0`	Monthly License Usage
`email`	Email of the user or trainee	string	`[email protected]`	Real Calls for Insights, Deactivated Users History
`course_id`	Unique identifier for the course	string	`e8e06b91-cd6f-4420-adfd-0c1afaf150a1`	Trainee Performance Summary, Topic Breakdown
`role`	Role of the user (e.g., Trainee, Manager)	string	`Trainee`	Trainee Performance Summary, Topic Breakdown
`top_ai_score`	Highest AI score recorded	number	`98`	Trainee Performance Summary
`top_evaluator_score`	Highest score given by a human evaluator	number	`100`	Trainee Performance Summary
`total_session_duration`	Total time spent across sessions	time	`01:14:38`	Trainee Performance Summary
`number_of_submitted_sessions`	Count of submitted sessions	number	`6`	Trainee Performance Summary

Report: Per-User License Usage

Description:
Tracks individual user activity and license status across the organization, including login history, license periods, and team assignments.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the user assigned a license	`Alex Johnson`
`trainee_email`	Trainee Email	email	Email address of the user	`[email protected]`
`role`	Role	string	User role (e.g., rep, manager)	`rep`
`manager_name`	Manager Name	string	Name of the user's manager	`Jordan Smith`
`manager_email`	Manager Email	email	Email address of the manager	`[email protected]`
`team`	Team	string	Team or group the user belongs to	`Team Jordan`
`region`	Region	string	Geographic region of the user	`US`
`segment`	Segment	string	Business segment or department	`Sales`
`license_start_date`	License Start Date	date	Start date of the user’s license	`2025-01-01`
`license_end_date`	License End Date	date	End date of the user’s license	`2026-01-01`
`login_date`	Login Date	date	Date the user logged into the platform	`2025-03-15`
`account_name`	Account Name	string	Name of the account	`Second Nature`
`current_status`	Current Status	string	Whether the user is currently active or deactivated	`Active`

Notes

This report is useful for license audits, renewal planning, and tracking user engagement.
Multiple login entries per user indicate recurring platform usage.

Report: Monthly Active User – Consumption Report

Description:
Tracks monthly usage of Monthly Active User (MAU) licenses, showing how many licenses were used, paid for, and the percentage of usage.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`month`	Month	date (month)	Reporting month	`2025-01`
`account_name`	Account Name	string	Name of the account	`Acme Corp`
`plan_type`	Plan Type	string	Type of subscription plan	`Monthly Active Users (MAU)`
`amount_used`	Amount Used	number	Number of licenses used during the month	`38`
`amount_paid`	Amount Paid	number	Number of licenses paid for	`150`
`percentage`	Usage %	percentage	Percentage of used licenses relative to paid amount	`25%`

Notes

This report helps track license consumption trends over time.
Useful for monitoring usage against plan limits and forecasting renewals.

Report: Monthly Active User Credits – Consumption Report

Description:
Tracks monthly usage of Monthly Active User Credits (MAUC), showing how many credits were used, paid for, and remain available.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`month`	Month	date (month)	Reporting month	`2025-01`
`account_name`	Account Name	string	Name of the account	`Second Nature`
`plan_type`	Plan Type	string	Type of subscription plan	`Monthly Active Users Credits (MAUC)`
`amount_used`	Amount Used	number	Number of credits used during the month	`38`
`amount_paid`	Amount Paid	number	Number of credits paid for	`150`
`amount_available`	Amount Available	number	Remaining credits available after usage	`112`
`remaining_percentage`	Remaining %	percentage	Percentage of unused credits relative to paid amount	`75%`

Notes

This report helps track credit consumption trends over time.
Useful for monitoring usage against plan limits and forecasting renewals.

Report: Seats – Consumption Report

Description:
Tracks monthly seat usage and license consumption across accounts.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`month`	Month	date (month)	Reporting month	`2025-10`
`account_name`	Account Name	string	Name of the account	`Acme Services`
`plan_type`	Plan Type	string	Type of subscription plan	`Seats (annual)`
`amount_used`	Amount Used	number	Number of seats or credits used	`43`
`amount_paid`	Amount Paid	number	Number of seats or credits paid for	`150`
`percentage`	Usage %	percentage	Usage percentage relative to paid amount	`29%`
`accumulated_usage`	Accumulated Usage	number	Total usage accumulated over time	`43`
`deactivated`	Deactivated	number	Number of deactivated seats	`0`

Notes

This report includes both active and deactivated seats.
Useful for tracking license utilization and renewal planning.

Report: Trainee Improvement – First to Best

Description:
Summarizes how individual trainees improve their performance across multiple attempts at training tasks.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the trainee	`Darrell Vin Zant`
`trainee_email`	Trainee Email	email	Email address of the trainee	`[email protected]`
`role`	Role	string	Job role of the trainee	`Technician`
`manager_name`	Manager Name	string	Name of the trainee’s manager	`Chris Wrolstad`
`manager_email`	Manager Email	email	Email address of the manager	`[email protected]`
`team_name`	Team Name	string	Internal team or department	`H2`
`region`	Region	string	Geographic region	`Field`
`segment`	Segment	string	Business segment	`Call Center`
`course_name`	Course Name	string	Title of the training course	`Core Value`
`course_id`	Course ID	string (UUID)	Unique identifier for the course	`e8e06b91-cd6f-...`
`task_name`	Task Name	string	Specific task or scenario	`Explore Step`
`first_ai_score`	First AI Score	number	Score from the trainee’s first attempt	`68`
`best_ai_score`	Best AI Score	number	Highest score achieved by the trainee	`98`
`number_of_attempts`	Number of Attempts	number	How many times the trainee attempted the task	`5`
`first_to_best_calculation`	Improvement %	percentage	Percentage improvement from first to best score	`44%`

Notes

The report includes only completed sessions.
Improvement is calculated as:
$\text{Improvement %} = \frac{\text{Best Score} - \text{First Score}}{\text{First Score}} \times 100$

Report: Trainee Performance Summary

Description:
Provides a detailed overview of each trainee’s top scores, session activity, and performance trends across training tasks.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the trainee	`Darrell Vin Zant`
`trainee_email`	Trainee Email	email	Email address of the trainee	`[email protected]`
`role`	Role	string	Job role of the trainee	`Technician`
`manager_name`	Manager Name	string	Name of the trainee’s manager	`Chris Wrolstad`
`manager_email`	Manager Email	email	Email address of the manager	`[email protected]`
`team_name`	Team Name	string	Internal team or department	`H2`
`region`	Region	string	Geographic region	`Field`
`segment`	Segment	string	Business segment	`HVAC`
`course_name`	Course Name	string	Title of the training course	`Core Value`
`course_id`	Course ID	string (UUID)	Unique identifier for the course	`e8e06b91-cd6f-...`
`task_name`	Task Name	string	Specific task or scenario	`Explore Step`
`top_ai_score`	Top AI Score	number	Highest AI-generated score for the task	`98`
`top_evaluator_score`	Top Evaluator Score	number	Highest score given by a human evaluator	`5`
`number_of_attempts`	Number of Attempts	number	Total attempts made by the trainee	`3`
`total_session_duration`	Total Session Duration	time	Cumulative time spent across sessions	`00:25:35`
`number_of_submitted_sessions`	Submitted Sessions	number	Number of sessions submitted for evaluation	`0`

Notes

This report aggregates performance across all submitted sessions.
Useful for identifying top performers and coaching opportunities.

Report: Quiz Overview

Description:
Provides a history of quiz attempts by trainees, including scores, passing thresholds, and course context.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the trainee	`Nathan Snell`
`trainee_email`	Trainee Email	email	Email address of the trainee	`[email protected]`
`manager_name`	Manager Name	string	Name of the trainee’s manager	`Marty Stecker`
`manager_email`	Manager Email	email	Email address of the manager	`[email protected]`
`team`	Team	string	Internal team or department	`P1`
`date`	Date	date	Date of the quiz attempt	`2025-10-14`
`time`	Time	time	Time of the quiz attempt	`17:52:04`
`course`	Course	string	Title of the training course	`Core Value`
`task`	Task	string	Specific quiz topic or module	`Core Values`
`passing_score`	Passing Score	number	Minimum score required to pass	`90`
`quiz_score`	Quiz Score	number	Score achieved by the trainee	`82`
`region`	Region	string	Geographic region of the trainee	`Field`
`segment`	Segment	string	Business segment	`Plumbing`

Notes

This report includes all quiz attempts, regardless of pass/fail status.
Useful for tracking knowledge retention and identifying coaching needs.

Report: Quiz Overview

Description:
Provides a history of quiz attempts by trainees, including scores, passing thresholds, and course context.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the trainee	`Nathan Snell`
`trainee_email`	Trainee Email	email	Email address of the trainee	`[email protected]`
`manager_name`	Manager Name	string	Name of the trainee’s manager	`Marty Stecker`
`manager_email`	Manager Email	email	Email address of the manager	`[email protected]`
`team`	Team	string	Internal team or department	`P1`
`date`	Date	date	Date of the quiz attempt	`2025-10-14`
`time`	Time	time	Time of the quiz attempt	`17:52:04`
`course`	Course	string	Title of the training course	`Core Value`
`task`	Task	string	Specific quiz topic or module	`Core Values`
`passing_score`	Passing Score	number	Minimum score required to pass	`90`
`quiz_score`	Quiz Score	number	Score achieved by the trainee	`82`
`region`	Region	string	Geographic region of the trainee	`Field`
`segment`	Segment	string	Business segment	`Plumbing`

Notes

This report includes all quiz attempts, regardless of pass/fail status.
Useful for tracking knowledge retention and identifying coaching needs.

Report: Session Overview

Description:
Provides a detailed log of all simulation sessions completed by trainees, including timing, scores, and course context.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the trainee	`Lauren Mullins`
`trainee_email`	Trainee Email	email	Email address of the trainee	`[email protected]`
`manager_name`	Manager Name	string	Name of the trainee’s manager	`Mark Daniels`
`manager_email`	Manager Email	email	Email address of the manager	`[email protected]`
`team_name`	Team Name	string	Internal team or department	`Customer Service`
`year`	Year	number	Year the session was completed	`2025`
`date`	Date	date	Date of the session	`09-23`
`time`	Time	time	Time the session started	`23:11:44`
`course_name`	Course Name	string	Title of the training course	`Course 4-B`
`task_name`	Task Name	string	Specific task or scenario	`Custom Conversation 2.0`
`session_duration`	Session Duration	time	Length of the session	`10:00`
`ai_score`	AI Score	number	Score generated by AI evaluation	`79`
`evaluator_score`	Evaluator Score	number	Score given by human evaluator (if applicable)	`N/A`
`region`	Region	string	Geographic region of the trainee	`Office`
`segment`	Segment	string	Business segment	`Call Center`
`session_link`	Session Link	string (URL)	Link to session analysis	`https://app.secondnature.ai/session-analysis/...`

Notes

This report includes all completed simulation sessions.
Useful for tracking training activity and performance over time.

Here is the next sanitized documentation page for the knowledge base:

Report: Topic Breakdown

Description:
Provides detailed scoring and feedback for each trainee across specific conversation topics and behavioral metrics.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the trainee	`Rick Benitez`
`trainee_email`	Trainee Email	email	Email address of the trainee	`[email protected]`
`role`	Role	string	Job role of the trainee	`Rep`
`manager_name`	Manager Name	string	Name of the trainee’s manager	`Chris Wrolstad`
`manager_email`	Manager Email	email	Email address of the manager	`[email protected]`
`team_name`	Team Name	string	Internal team or department	`H2`
`region`	Region	string	Geographic region of the trainee	`Field`
`segment`	Segment	string	Business segment	`HVAC`
`course_name`	Course Name	string	Title of the training course	`Explore Step`
`course_id`	Course ID	string (UUID)	Unique identifier for the course	`700f7c91-6d99-...`
`task_name`	Task Name	string	Specific task or scenario	`Custom Conversation 2.0`
`session_id`	Session ID	string (UUID)	Unique identifier for the session	`91c1870e-be54-...`
`date`	Date	date	Date of the session	`2025-10-04`
`time`	Time	time	Time the session started	`17:28`
`session_duration`	Session Duration	time	Length of the session	`03:21`
`overall_score`	Overall Score	number	Composite score for the session	`49`
`knowledge_score`	Knowledge Score	number	Score for factual accuracy	`36`
`style_score`	Style Score	number	Score for tone and professionalism	`80`
`clarity_score`	Clarity Score	number	Score for clarity of communication	`100`
`energy_score`	Energy Score	number	Score for enthusiasm and engagement	`100`
`filler_words_score`	Filler Words Score	number	Score penalizing filler words	`66`
`sentence_length_score`	Sentence Length Score	number	Score for sentence structure and conciseness	`66`
`pace_score`	Pace Score	number	Score evaluating speech rhythm	`66`
`overall_feedback`	Overall Feedback	string	Narrative feedback summarizing performance	`"Your performance showed potential..."`
`topic_name`	Topic Name	string	Specific skill or behavior evaluated	`Open ended questions`
`topic_score`	Topic Score	number	Score for the topic	`40`
`topic_feedback`	Topic Feedback	string	Detailed feedback on the topic	`"You asked a few open-ended questions..."`

Notes

This report includes both numeric scores and qualitative feedback per topic.
Useful for coaching, performance reviews, and skill development.

Here is the next sanitized documentation page:

Report: Proficiency Heatmap

Description:
Provides a matrix-style view of trainee performance across multiple courses and conversation types, enabling quick identification of strengths and gaps.

Available via:
UI and API

Fields

Field Name	Display Name	Type	Description	Example Value
`trainee_name`	Trainee Name	string	Full name of the trainee	`Amanda Whaley`
`trainee_email`	Trainee Email	email	Email address of the trainee	`[email protected]`
`team_name`	Team Name	string	Internal team or department	`Team A`
`team_leader_email`	Team Leader Email	email	Email address of the team leader	`[email protected]`
`total_trainees`	Total Trainees	number	Number of trainees in the team	`46`
`certified_trainees`	Certified Trainees	percentage	Percentage of trainees certified	`2%`
`total_simulations`	Total Simulations	number	Number of simulations completed by the team	`347`
`team_score`	Team Score	number	Average score across all simulations	`72`
`region`	Region	string	Geographic region of the team	`Field`
`segment`	Segment	string	Business segment	`HVAC`
`course_name`	Course Name	string	Name of the course or simulation module	`HVAC Present Step`
`score`	Score	number	Score achieved by the trainee in the course	`95`

Notes

This report includes both individual and team-level performance data.
Courses are listed as columns; scores are mapped per trainee or team.
Useful for identifying training gaps and targeting coaching efforts.

Reports glossary

Global Field Glossary

Report: Per-User License Usage

Fields

Notes

Report: Monthly Active User – Consumption Report

Fields

Notes

Report: Monthly Active User Credits – Consumption Report

Fields

Notes

Report: Seats – Consumption Report

Fields

Notes

Report: Trainee Improvement – First to Best

Fields

Notes

Report: Trainee Performance Summary

Fields

Notes

Report: Quiz Overview

Fields

Notes

Report: Quiz Overview

Fields

Notes

Report: Session Overview

Fields

Notes

Report: Topic Breakdown

Fields

Notes

Report: Proficiency Heatmap

Fields

Notes