Simulate interview

simulate_study Requires studies:write

In Test mode, simulate the interview before the user selects Go live: Juno plays both sides — the interviewer runs the study's real interview, and a synthetic participant answers it — producing a sample transcript. Optionally steer the participant with a persona description. Returns a job handle; poll get_simulation_status to watch the transcript grow turn by turn. Simulation uses no credits, provides no analysis or exports, and is not real participant research. The current tool does not enforce mode=test; callers must honor that contract.

Input

study_id

string <uuid> required

Unique study id returned by Juno.

persona

string | null

Optional plain-language description of the synthetic participant (e.g. 'a skeptical enterprise buyer who churned last month'). When omitted, Juno invents a plausible participant for the study.

max_turns

integer

Maximum number of interview turns to simulate. The interview may finish naturally in fewer turns.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "simulate_study",
    "arguments": {
      "study_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "persona": null,
      "max_turns": 12
    }
  }
}