Guide

Voice recording

Collect participant audio with automatic S3 upload. Describe the recording task in the AI editor.

Collect read-aloud or free-speech audio from participants. Recordings upload to S3 automatically; trial data stores an audio_s3_key reference rather than raw bytes.

Preview mode does not upload audio. Test recordings in a real participant session after publishing.

How it works

  1. 1

    Open your experiment in the editor

    Go to Dashboard → your project → open an experiment. Use the AI panel on the right to describe the recording task in plain language — for example which sentence to read, how long they may speak, and what to show on screen.

    You do not need a special protocol prompt. Asking to record audio is enough for the builder to wire up microphone capture and S3 upload.

  2. 2

    Review the generated code

    The AI should add a recording UI (start/stop) and keep prompts, duration, and labels in config.js. Adjust those CONFIG values as needed.

  3. 3

    Publish and test with a real session

    Publish your project and run it via /take/:projectId (not preview). Allow microphone access when prompted. Trial data will include audio_s3_key pointing to the recording in S3.

Example ask: “Add a trial where the participant records themselves reading this sentence aloud. Keep the sentence and max recording length in CONFIG.”

What gets saved in trial data

  • audio_s3_key — S3 path to the recording (required).
  • Any other fields you define (e.g. prompt , recording_duration_ms , custom labels in CONFIG).