Carrier Documentation

The left Library pane contains draggable participant, agent, and segment components. The centre Canvas shows your chamber lines as horizontal rows of chamber cards. The right Inspector pane updates automatically to show the settings for whatever element is selected — experiment, chamber, segment, participant, or agent.

Click the experiment name in the header to open global settings. Here you set the experiment name and description, configure the chamber line assignment method (random, counterbalance, or survey-based), attach global pre/post surveys using the built-in Survey.js editor, and optionally set a completion redirect URL for platforms like Prolific.

Each chamber line represents an experimental condition (e.g. treatment vs control). Add lines with the button at the bottom of the canvas, then add chambers within each line. Chambers appear as cards in a horizontal timeline — you can duplicate or delete lines, and add as many chambers per line as your design requires. Double-click a chamber card to expand it and start configuring its contents.

Create human participants and agents in the Library pane. Agents can be Script-based (trigger rules) or LLM-powered (OpenAI, Anthropic). Drag them from the library into a chamber's role zones — Communicators, Mediators, or Processors — to assign both placement and role in one action. The inspector updates to show role-specific settings for the selected participant or agent.

Select an agent to open its settings in the inspector. LLM agents are configured with a provider, model, system prompt (supports {{variable}} interpolation from survey responses), temperature, max tokens, context window size, and response delay range to simulate natural typing. Script agents use a visual trigger builder where you define condition–response rules (keyword, regex, time-based, message count, and more) with chaining, cooldowns, and probability controls.

Inside an expanded chamber, the right panel shows the segment timeline. Click Add Segment to append a new segment, then select its type: chat, slide, selection, ranking, input, media, timer, task, survey, or instruction. Each segment has its own duration, transition mode (auto, manual, sync, host), and type-specific options — for example, a chat segment lets you toggle emoji reactions, typing indicators, and message reporting. Use the move up/down buttons to reorder segments.

Chat segments support control events that modify the interaction at runtime. You can disable input for specific participants (e.g. to create a listening phase), enable input to restore it, or end the section based on a condition such as elapsed time, message count, or a bot trigger. A summary strip at the bottom of the chamber preview shows all active control events across segments.

Surveys can be attached at three levels: global pre/post (in experiment settings), chamber pre/post (in chamber settings), and segment-level (using the survey segment type). All surveys use the Survey.js format. The built-in question builder lets you add questions visually, or you can import/export survey JSON files for reuse across experiments. Survey response fields can drive chamber line assignment and be injected into agent system prompts via {{variable}} syntax.

When your design is ready, click Validate to run structural checks (every chamber line needs at least one chamber, every chamber needs segments, etc.). Use Preview to review the full experiment tree in a read-only modal. Finally, click Deploy to save the experiment to the database — the builder tracks unsaved changes with a dot indicator next to the Deploy button. You can also Export the configuration as JSON for backup or version control, and Import a previously exported experiment to continue editing.

The main dashboard shows a summary of all your experiments at a glance. The top row of statistics cards displays total experiments, active participants, participants online now, matching queue size, completed sessions, and active chatrooms. Below the stats, you'll find panels for your experiments list, active sessions, matching queue, and alerts.

The experiments panel lists every study you own or collaborate on. Each card shows the experiment name, status, and your access level (Owner, Collaborator, or Unowned). From here you can copy the participant link to share with subjects, open the detail view, edit the configuration in the Experiment Builder, manage collaborators, export data, or delete the experiment.

Click into an experiment to open the detail view, which shows a searchable, filterable table of every participant. Each row displays the participant's connection status (online/offline/disconnected), matching status, current stage, message count, and session duration. The table updates in real time via Socket.io — no page refresh needed. Use the search bar to filter by participant ID and the status dropdown to narrow by active, completed, paused, or dropped_out.

Each participant row has action buttons that let you intervene in real time. Pause prevents a participant from advancing to the next stage. Resume re-activates a paused session. End terminates the session with an optional reason that is logged for your audit trail. You can also click View Details to open a modal showing the participant's full progress, timing, and current chatroom information.

Click View Chatroom on any matched participant to open the full chatroom history. The chatroom modal shows the participant roster with roles (communicator/mediator/processor), every message with sender type and timestamp, and system notifications (joins, leaves, state changes). Messages from different sender types (human, AI, agent, system, mediator) are visually distinguished.

The alerts panel surfaces issues automatically: participant disconnections, long queue waits (over 2 minutes), drop-outs, and idle experiments. Alerts are sorted by severity (errors first) so you can triage quickly. The matching queue panel shows participants currently waiting to be grouped, along with their wait time, helping you spot bottlenecks before they affect your study.

Click Export on any experiment to download your data. Choose between JSON or CSV format, and select the data scope: participants (statuses, timing, response counts), chatrooms (chat history, message counts, session info), responses (individual survey records), or all (complete dataset with experiment metadata). The exported file is ready for analysis in your preferred tool.