Expected Parrot: Tools for AI-Powered Research

Expected Parrot delivers powerful tools for conducting research with human and artificial intelligences.

This page provides documentation for the Expected Parrot Domain-Specific Language (EDSL), a Python package for performing research with AI agents and language models, and Coop, a platform for creating, storing and sharing AI-based research projects.

Key features

Simplified access to hundreds of models

A single API key lets you conduct research with many popular models at once. Learn more.

Collaboration made easy

Use Coop to create, store, and share your research projects seamlessly.

Data integrations

Easily import, analyze and extend many types of data. Learn more.

Hybrid human-AI surveys

Collect responses from both humans and AI. Learn more.

Built-in analysis tools

Analyze results with built-in methods. Learn more.

Use cases

Our tools simplify survey creation, experiment execution and response analysis. Common use cases include:

Data labeling

Design tasks that involve labeling data as qualitative and quantitative questions about your data, then use language models to generate answers. See examples.

Market research

Administer surveys to gather insights on consumer preferences, behaviors and trends. Simulate customer personas with AI agents and analyze their responses. See examples.

User experience research

Create surveys to assess user satisfaction, usability and engagement. Use AI agents to simulate user profiles and analyze their feedback on products or services. See examples.

Integrate human and AI data

Combine human responses with AI-generated responses to create richer datasets. See examples.

Analyze survey data

Generate or import survey data and analyze it with built-in methods. Simulate follow-up interviews using AI agent respondents. See examples.

Social science research

Explore hypotheses and gather qualitative or quantitative data using AI agents.

For more on EDSL’s key features and use cases, visit the Overview section.

Getting started

  1. Install the EDSL package. See Installation instructions.

  2. Log in to Coop to access special features for working with AI agents and language models, storage and collaboration tools.

  3. Choose how to access language models:

    • Remote: Use your Expected Parrot API key to access all available models at Coop. See instructions on activating Remote Inference.

    • Local: Use your own API keys for models to use on your own machine. See instructions on storing API Keys.

  4. Explore a Starter Tutorial, how-to guides and notebooks, and see tips on using EDSL effectively.

Researchers

Are you using EDSL for a research project? Send an email to info@expectedparrot.com and we’ll give you credits to run your project!

Introduction

  • Overview: An overview of the purpose, concepts and goals of the EDSL package.

  • Whitepaper: A whitepaper about the EDSL package (in progress).

  • Citation: How to cite the package in your work.

  • Papers: Research papers and articles that use or cite EDSL.

Core Concepts

  • Questions: Learn about different question types and applications.

  • Scenarios: Explore how questions can be dynamically parameterized for tasks like data labeling.

  • Surveys: Construct surveys with rules and conditions.

  • Agents: Design AI agents with relevant traits to respond to surveys.

  • Language Models: Select language models to generate results.

Working with Results

Coop

Coop is a platform for creating, storing and sharing AI-based research. It is fully integrated with EDSL and provides access to special features for working with AI agents and language models, storage and collaboration tools, including:

  • Remote Inference: Run surveys with any available models on the Expected Parrot server.

  • Remote Caching: Automatically store results and API calls on the Expected Parrot server.

  • Survey Builder: Design and launch hybrid human-AI surveys.

  • Notebooks: Post .ipynb and .py files to the Coop.

  • File Store: Store and share data files for use in EDSL projects.

Log in to access Coop.
Learn more about how it works

Importing Surveys

  • Conjure: Automatically import other survey data into EDSL to:

    • Clean and analyze your data

    • Create AI agents and conduct follow-on interviews

    • Extend results with new questions

    • Store and share data at the Coop

How-to Guides & Notebooks

Examples of special methods and use cases for EDSL, including:

  • Data labeling

  • Data cleaning

  • Analyzing survey results

  • Adding data to surveys from CSVs, PDFs, images and other sources

  • Conducting agent conversations

  • Converting surveys into EDSL

  • Cognitive testing

  • Research methods