Where to find settings documentation
Use these pages as the authoritative reference for configurable fields:| Document | Use it for |
|---|---|
| Simulation settings — full catalog | Top-level fields on SimulationSettings / UpdateSimulationSettingsRequest: meaning, defaults, learner impact, and operational notes. |
| Simulation policy paths | Nested simulation_policy.* settings (realism, routing, privacy, orchestration, memory, tools, and related areas). |
| Parameter documentation standard | A repeatable template for formal reviews, pilots, or customer appendices when you need more than the catalog tables. |
SimulationSettings and UpdateSimulationSettingsRequest in src/common/models.py; admin field mapping in src/apis/simulation_admin/settings.py.
Practices for safe changes
- Use a staging org first — Exercise scenario, chatter, and policy changes outside production.
- Watch cost and load — Chatter limits, compression, and context windows directly affect LLM usage and background work.
- Align with learners — Time-boxed modes, completion messaging, and approval flows should be clear before a cohort starts.
- Control Expert-level fields — Restrict who may edit Expert-only parameters; schedule changes when they can be reviewed and audited.
AI usage and pricing visibility
Organization admins can view tenant-scoped AI usage and set pricing used for estimated cost views.- Usage views include totals, trends, per-user breakdown, and request/model/feature splits.
- Pricing controls include:
- LLM input price per 1M tokens
- LLM output price per 1M tokens
- Embedding price per 1M tokens
- Optional mem0 unit price
Cost-control knobs in simulation settings
In addition to pricing rates, two org-level settings materially change monthly token/cost burn:simulation_policy.ambient.chatter_hourly_token_budget(ambient chatter token guardrail)psychometric_recalc_interval_messages(how often psychometric LLM scoring is recomputed)
- lowering them reduces spend but can reduce background realism/granularity
- raising them increases realism density but can materially increase cost
Quick Help voice assistant controls
In Workspace Configuration → Expert mode → Quick Help Voice, organization admins can tune LiveKit call assistance behavior:quick_help_call_enabled— master toggle for learner access to Quick Help callsquick_help_call_voice— default OpenAI voice used by the LiveKit workerquick_help_call_persona— organization-specific coaching persona instructions
Related
- Roles and product surfaces — API roles,
adminvshr, and which UI each role uses - Admin panels (frontend)
- Memory decision table