How it works
You can create a Prolific study for your EDSL survey from your workspace (in code) or from your account dashboard (interactively). You can also choose whether to use your own Prolific account key or your Expected Parrot key (by default).Code-based workflow
Create a survey in a notebook
- Construct Questions and pass them to Surveys with desired logic.
- Create AI Agents with desired traits.
- Specify Language Models to generate responses.
- Use the run method to administer a survey with desired agents and models.
Use humanize to generate a project and web surveys
Use Coop to launch Prolific studies
- create_prolific_study: Create a new study for the project_uuid and specify the study details (name, description, num_participant, estimated_completion_time (minutes), participant_payment_cents), and optional filters for targeting specific demographics and Prolific participants (IDs list).
- get_prolific_study: Retrieve the study details for the project_uuid and study_id.
- list_prolific_filters: Show all the available filters for targeting specific demographics and characteristics of participants. Then use the find method to inspect the available filters by filter_id and the create_study_filter method to create a filter for your study with the desired parameters.
- update_prolific_study: Update the study with the filters.
- publish_prolific_study: Publish the study and make it available for participants.
- get_prolific_study_responses: Retrieve the responses from the study.
- approve_prolific_study_submission: Approve the responses from the study.
- reject_prolific_study_submission: Reject the responses from the study.
Interactive workflow
Create a survey project
Create a Prolific study
- Study name (Shown to participants)
- Description (Shown to participants)
- Required number of participants: Specify how many participants you want to recruit.
- Estimated completion time: Provide an estimate of how long it will take participants to complete the survey.
- Participant payment amount: Set the payment amount for participants.
- Participant allowlist: Optionally, you can specify a list of Prolific IDs of participants who are allowed to take part in the study.
- Configure filters: Optionally, you can set filters to target specific demographics or characteristics of participants (e.g., age, gender, ethnicity, languages, location, education, work status, etc.).
Launch the study
Access results
Example (code-based workflow)
The example below demonstrates how to create a survey with different question types, run it with an AI agent and language model, and then gather human responses. Create and run a survey with AI agents and models: See the Questions, Surveys, Agents and Language Models sections for more details on each of these components.agent.persona | Middle-aged mom |
---|---|
agent.location | Massachusetts |
answer.drive | Yes |
answer.count | 2 |
answer.enjoy | 4 |