Skip to main content

Emotional state

On each turn, uniqOS infers how the user seems to feel right now from their message, and uses that to shape the response. Unlike the personality model — which is stable — emotional state is per turn: it reflects this message, not a lasting trait.

What you get back​

Every /v1/respond result includes an inferred_emotional_state:

  • primary — the dominant inferred emotion, from a controlled vocabulary.
  • confidence — how sure the inference is.
  • secondary — other emotions present alongside the primary one.
  • intensity — how strong the affect appears.
  • valence — how positive or negative it is.
  • arousal — how activated or calm it is.

The agent's reply is already modulated for this state; the structured signal is returned so you can observe, log, or branch on it in your own product.

Inference only — nothing raw is kept​

The emotional state is inferred from the message and the message text is discarded. uniqOS persists structured signals, never the raw words. If you only want the inference without generating a reply, there is a dedicated infer-state endpoint that classifies without producing a response or consuming a turn.

See the API Reference for the exact fields and vocabularies.