Levels & Actions
For end-to-end workflow guidance and display rules for clinical and patient-facing UIs, see Interpreting Results.
Level Definitions
Signal levels are applied to individual models in the signals array and to overall_level in summary.
| Level | Description |
|---|---|
| none | Signal not detected at a meaningful threshold. |
| low | Faint signal detected. Monitor for changes. |
| consider | Signal worth considering. Review alongside other clinical context. |
| moderate | Signal present. Provider review indicated. |
| elevated | Signal present at the highest level. Trigger your escalation workflow. |
| inconclusive | Analysis inconclusive or incomplete (for example, limited speech or notable audio_quality issues); prefer re-recording or collecting more information before routing. |
Score-to-level mapping uses a distribution-based calibration unique to each model, rather than fixed numeric ranges. This means the score value corresponding to each level varies by model. Use
level— not rawscore— for routing and display logic. If you log rawscorevalues for analytics, note the API version and model ID alongside each result.
For display label mappings (e.g. elevated → "Significant indicator"), see Interpreting Results — Display Guidelines.
Recommended Action Trigger Logic
recommended_action is determined by evaluating the full set of signal levels, not any single model in isolation. In some cases, both overall_level and recommended_action may be inconclusive when the analysis cannot complete to the usual quality standards (for example, very short recordings or notable audio_quality issues).
| Condition | recommended_action |
|---|---|
| No signals at low, consider, moderate, or elevated | none |
| 1+ at low (none at consider, moderate, or elevated) | monitor |
| 1+ at consider | consider |
| 1+ at moderate OR 2+ at consider | review |
| 1+ at elevated | escalate |
When recording conditions may be below optimal for analysis, the API may return recommended_action: "inconclusive" and overall_level: "inconclusive". Treat this as “no clear signal; prefer re-recording or collecting more information” rather than as a monitoring, review, or escalation trigger.
escalate takes precedence over all other conditions. When any signal is at elevated, the action is always escalate regardless of other signals.