Toloka documentation

Your first project

Learn your way around Toloka with the following steps:

  1. Create a project.
  2. Configure a task pool.
  3. Upload a file with tasks.
  4. Launch the pool and get the results.

Before you start

Make sure you're registered as a requester.

Log in to the Sandbox to create and test your project for free. This helps you avoid making mistakes and spending unnecessary money on a task that doesn't work.

Step 1. Create a project

In the project, you'll customize an appearance of the tasks.

  1. On the Projects tab, choose a project preset that matches your task. The preset has preconfigured settings, a template for the task interface, and sample instructions for Tolokers. You will need to make a few changes in the interface and instructions to fit your data.

    Presets for popular tasks
    • Image classification

      Designed to determine which category an image belongs to.

    • Product search relevance

      Intended to rate how relevant products are to specific search queries.

    • Object recognition & detection

      Used to outline objects on images for training computer vision to detect them.

    • Customer survey

      Designed to collect information for research purposes.

    Tip

    If you unsure which preset to choose, you can ask Toloka experts to create a project for you. To do that,

    • click Get expert help,
    • select the way Toloka can contact you (WhatsApp, Telegram, Viber, email, or phone),
    • enter your phone number or email address,
    • briefly describe the project and the results you want to get.

    Toloka engineering team will contact you for more details and explain your further steps.

    If you can't find a preset that works for you, choose Blank to set up a project from scratch. To learn how, see the Initial project settings section.

  2. In the General information section, fill in the project name and a brief explanation of what will happen within the project.

  3. In the Task interface section, do the following:

    1. Select Template builder.

    2. Edit the preset task interface to configure the task appearance.

    3. Click Show specifications to see the generated input and output data fields.

    To learn more, see the Template Builder Help.

  4. In the Instructions for Tolokers section, edit the ready-made instructions if needed.

  5. Click Create a project.

Step 2. Configure a task pool

A pool is a set of tasks sent out for completion at the same time. Create and configure the pool as follows:

  1. Click Add a pool on the project page.

  2. Set the Pool name (visible only to you) field. Only you will see this pool name on the project page.

  3. Specify the pool description which will be displayed instead of the project description in the task list for Tolokers. By default, Tolokers see the description from the project settings. To use a different description, uncheck the Use project description box and set Public description. If necessary, click + Private comment to add a private project description that only you will see.

  4. Click Create.

  5. Follow the steps in the pool wizard:

    Note

    After each step click Save to apply changes or Cancel to discard them.

    1. Select the audience for your task

      Select Tolokers using filters. Tasks will only be shown to matching Tolokers, rather than to all of them.

      Click the Add filter button and set the filter parameters.

    2. Setup quality control

      Quality control lets you get more accurate responses and restrict access to tasks for cheating users. Quality control consists of rules. All rules work independently.

      To learn more, see the Quality control overview section.

    3. Set the task price and overlap

      In the Price per task suite, $ field, set the amount of money to pay per task suite done by one Toloker.

      Pay attention to the Toloker interest at this price indicator. It shows how your price meets expectations of Tolokers. If the interest is low, you can raise price per task suite to have a bigger number of Tolokers in the project. If the interest is high, you can reduce price to save money.

      In the Overlap field, define how many Tolokers must do each task.

      You can also set up dynamic pricing and dynamic overlap.

    4. Prepare and upload data

      Upload tasks to the pool. This step will be enabled after you complete the previous steps.

    5. Add control tasks for checking performance

      Add control tasks to monitor the quality of task completion:

      1. Enter correct responses.

      2. Select the fields to use.

      3. Click Save and go to next or Skip task.

      4. Click Save all control tasks.

      Note

      This step will be enabled after you complete the previous steps. You can skip this step by clicking Do it later.

    6. Double-check your project and try out tasks

      At this step, check how the task will look from the Toloker's point of view.

      Note

      This step will be enabled after you complete the previous steps. You can skip this step by clicking Do it later.

    7. Add optional pool settings

      Set up advanced pool settings.

      Note

      This step will be enabled after you complete the previous steps. You can skip this step by clicking Use default settings.

After all the steps, you'll see the Set up is finished and your pool is ready for labeling tip on the pool page.

Step 3. Launch the pool and get the results

  1. Start the pool by clicking Start labeling. This assigns the tasks to the Tolokers.

  2. Complete your tasks as a Toloker by yourself.

  3. Track your project with the real-time statistics on the pool and project pages.

  4. When the tasks are completed, get the results:

    • Download a TSV file with the responses.

    • If you have used overlap, run aggregation to get the final results.

    • Get the files that Tolokers have attached to the tasks.

What's next

  • When you complete the testing in the Sandbox, move your project to the Toloka production version and launch the pool for real Tolokers.

  • View our tutorials. Perhaps there is an instruction that fits your task, and you will only need to insert your own data.

  • If you don't like Template Builder, try out the HTML/JS/CSS editor.

  • See the Toloka API documentation to learn how to manage your projects via the API.

  • If you have questions or problems, see the Troubleshooting and support section.

See also