Toloka documentation

Project 1. Does the photo contain a certain object?

In this project, you will ask Tolokers if there are shoes in the photo.

Create a project

To create a project, open Toloka for requesters.

In the interface:

  1. Choose a template:

    1. Click Create project.

    2. Select the Image classification template.

  2. Provide general information:

    1. In the Name for Tolokers field, enter Are there shoes in the photo?.

    2. In the Description for Tolokers field, enter Look at the picture and answer if there are shoes in it..

    3. Optionally add a Private comment.

    4. Save the changes.

  3. Edit the task interface in the editor you selected:

    1. The task interface describes how the elements should be arranged in the task.

      The template has pre-configured validation. The Toloker won't be able to submit a response without selecting one of the options.

      For more information, see the Template Builder Help:

    2. On the Configuration panel, replace lines 19 to 28 in the code:

      "label": "What is the cat's mood?",
      "options": [
      {
      "label": "Good",
      "value": "ok"
      },
      {
      "label": "Bad",
      "value": "bad"
      },
      

      with the following:

      "label": "Are there shoes in the image?",
      "options": [
      {
      "label": "Yes",
      "value": "ok"
      },
      {
      "label": "No",
      "value": "bad"
      },
      
    3. Click Show specifications to see the input and output data fields.

      Input data fields are created from the code on the Example of input data tab.

      The output data fields depend on the components that use data.output and values supported by it.

      Learn more about input and output data fields in the Template Builder Help.

      • Input data field: image — A link to an image.

      Change the data type to string to add links to your files.

      • Output data field: result — string for saving the Toloker's response.
      What are input and output data?

      Input data is types of objects that are passed to the Toloker for completing the task. For example, this could be a text, an image, or geographic coordinates.

      Output data is types of objects that you receive after the task is completed. For example, this could be one of several response options, typed text, or an uploaded file.

      If you add interface elements to the task template, the corresponding fields in the Data specification block will be created automatically.

    1. In the Task interface, edit the HTML block.

      • After the image line, add the question:

        <div>Are there <b>shoes</b> in the picture?<div>

      • Change the labels on the response options: GoodYes, BadNo:

      {{img src=image width="100%" height="400px"}} <div>Are there <b>shoes</b> in the picture?<div>
      
      {{field type="radio" name="result" value="OK" label="Yes" hotkey="1"}}
      {{field type="radio" name="result" value="BAD" label="No" hotkey="2"}}
      {{field type="radio" name="result" value="404" label="Loading error" hotkey="3"}}
      
    2. Leave the JS, CSS, and Data specification blocks unchanged.

      Learn more about the Specification parameters in Input and output data.

    3. Click to see the Toloker's view of the task.

      Note

      The project preview shows one task with standard data. You can define the number of tasks to show on the page later.

    4. In the window that opens, check if the task options work correctly. In the lower-right corner, click Submit.

    5. Exit preview mode.

      In the lower-left corner, click Exit. If there were errors when testing, check the code blocks that you entered.

  4. Save the changes.

  5. In the Instructions for Tolokers field, enter the instructions and add an image.

    1. Instructions:

      Look at the picture and determine if there are **shoes** in the picture.
      If there are, click **Yes**.
      If there aren't, click **No**.
      For example, there are shoes in the photo, so the correct answer is **Yes**.
      
    2. To add an image, click and provide a link to the image you want to use as an example.

    3. Save the changes.

  6. To go back to the Projects page, click Finish editing.

Learn more about working with the project in the Project section.

Create a pool

To create a pool:

  1. Open the page of the project titled Are there shoes in the photo?.

  2. Click Add a pool on the project page.

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

  4. 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.

  5. Click Create.

  6. At the Select the audience for your task step, set up filters to select Tolokers for your pool.

    1. Use the Languages filter to select Tolokers with knowledge of the language.

    2. Clear My tasks may contain shocking or pornographic content if your project has none of those.

    3. Tasks in pools will be automatically available in the web version of Toloka and the mobile app. If you want to change the default settings and limit the visibility of the task for any of the versions, add the Client filter and select the desired value: Toloka web version or Toloka for mobile.

  7. (optional) In the Speed/quality balance section, specify the desired quality level. Improving quality may reduce the speed of task completion because the pool will be available to fewer Tolokers. Learn more in the Speed/quality balance section.

  8. At the Set the task price and overlap step, set up how much a single task will cost for you.

    1. In Price per task suite, $, set the amount of money to pay per task suite done by one Toloker. For example, 0.01.

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

  9. At the Setup quality control step, set quality control rules for more accurate results:

    1. Click Add a quality control rule.

    2. Find the Rules block in the list and choose Control tasks.

    3. Set a rule for control tasks: If the number of responses to control questions is greater than or equal to 3 and the percentage of correct responses to control questions is less than 60, then restrict the Toloker's access to the project for 10 days. Specify the Control task as a reason.

      Learn more in Quality control.

  10. At the Add optional pool settings step, specify the Time per task suite, sec.

    The time should be long enough to read the instructions and wait for task data to load. For example, 600 seconds.

  11. At the Prepare and upload data step, upload your task data.

    1. Prepare your own task file. Check out the example in the demo file. In the Toloka interface under the pool name, there are links to file templates for regular, control, and training tasks.

    2. Click Drop file here or select, and upload the file you’ve just made.

    3. Click Continue.

    4. Choose Smart mixing.

    5. In the General tasks field, specify 9.

    6. In the Training tasks field, specify 0.

    7. In the Control tasks field, specify 1.

    8. Click Combine tasks into suites.

  12. Create control tasks at the Add control tasks for checking performance step. To do it, add correct answers to some of your tasks.

    1. In the left column, turn on the result option.

    2. Choose the correct answer to the question.

    3. Click Save and go to next.

    4. Click Are there shoes in the photo? to exit the task markup mode.

      Note

      In small pools, control tasks should be 10-20% of all tasks. Include different versions of correct responses in equal amounts. See the distribution of responses on the Edit tasks page, Control tasks tab.

  13. At the Double-check your project and try out tasks 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.

  14. Click to start the pool.

Get the results

To get the results:

  1. Next to the Download results button, click .

  2. Choose the Dawid-Skene aggregation model. Learn more about Result aggregation based on the Dawid-Skene model.

  3. In the window that opens, click Yes.

  4. At the top of the page, click View operations list.

    Note

    To track the progress, refresh the page from time to time. Aggregation takes from 5 to 20 minutes. You can start designing another project meanwhile.

  5. When the operation is complete, download the file with the results. To do this, click Download in the Files column.

  6. Use the file with the results in project 2.

What's next

  • Create Project 2 to search for similar items in an online store.