Function user

user(content?: string | ModelMessage, options?: VoiceUserOptions): ScriptStep
Generate or specify a user message in the conversation.

If content is provided, it will be used as the user message. If no content is provided, the user simulator agent will automatically generate an appropriate message based on the scenario context.

Voice (PRD §4.2): pass { voiceStyle } and/or { audioEffects } to apply a per-step override to ONLY this turn's synthesized audio (scenario.user("I'm upset!", { voiceStyle: "angry" })). The simulator's default voice/effects resume on subsequent turns.
Parameters
- Optionalcontent: string | ModelMessage
  Optional user message content. Can be a string or full message object. If undefined, the user simulator will generate content automatically.
- Optionaloptions: VoiceUserOptions
  Optional per-step voice overrides (voiceStyle, audioEffects).
Returns ScriptStep
A ScriptStep function that can be used in scenario scripts.
- Defined in work/scenario/scenario/javascript/src/script/index.ts:156