Training

A training pool includes unpaid task suites. Why you should use a training pool:
  • You can use successful completion of the training pool as a prerequisite for selecting performers for the main pool.
  • Performers can practice before doing the main pool and learn how to respond correctly.
The training pool must be linked to the main pool. After completing the training pool, the performer is assigned a skill equal to the percentage of correct responses. If the percentage is higher than or equal to the Level required value in the linked pool, the performer gets access to the main pool.
The training pool properties are sent in JSON format. More information below:

More details about training pools.

You can use the API for the following operations with training pools:

Example of creating a training pool in JSON

{
  "project_id": "654321",
  "private_name": "Selection for a labeling task",
  "inherited_instructions": false,
  "public_instructions": "Unpaid selection for a project: 10 tasks, 90% threshold.",
  "may_contain_adult_content": false,
  "assignment_max_duration_seconds": 600,
  "mix_tasks_in_creation_order": true,
  "shuffle_tasks_in_task_suite": true,
  "training_tasks_in_task_suite_count": 10,
  "task_suites_required_to_pass": 1,
  "retry_training_after_days": 7
}
Copied to clipboard

Keys

Key Value Data type Required during creation
id
ID of the training pool. String Not used
project_id
ID of the project that the training pool was created for. String Yes
private_name
Name of the training pool (only visible to the requester). String Yes
inherited_instructions

Indicates whether to use the project instructions. To provide separate instructions for the training, enter it in public_instructions.

The default value is false.

Boolean Yes
public_instructions
Instructions for completing a training task. You can use any HTML markup. String No
may_contain_adult_content
Whether training tasks contain adult content. Boolean Yes
assignment_max_duration_seconds
The time allowed for completing a task suite, in seconds. We recommend allowing no more than 60 seconds per task suite (including the time for loading the page and submitting assignments). Number Yes
mix_tasks_in_creation_order
Whether training tasks are issued in their upload order:
  • true — Tasks are grouped into task suites in the order of rows in the uploaded file (top-to-bottom).
  • false — Tasks are taken at random.
The default value is true.
Boolean No
shuffle_tasks_in_task_suite
Whether training tasks are shuffled within each task suite:
  • true — Yes.
  • false — No, they are listed in their upload order.
The default value is true.
Boolean No
training_tasks_in_task_suite_count
Number of training tasks per suite. Number Yes
task_suites_required_to_pass
Number of task suites the user needs to complete to get a skill and access the main tasks. Number Yes
retry_training_after_days
Number of days until retry becomes available. Number No
owner.id
Requester ID. String Not used
owner.myself
Checks who the object belongs to:
  • true — The user who made the request.
  • false — Another account (employee or owner).
Boolean Not used
status
Training pool status:
  • OPEN
  • CLOSED
  • ARCHIVED
String Not used
created
The UTC date and time when the training pool was created, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. String Not used
last_started
The date and time when the training pool was last started, in UTC in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. String Not used
last_stopped
The date and time when the pool was last stopped, in UTC in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. String Not used
last_close_reason
The reason for closing the training pool the last time:
  • MANUAL — Closed by the requester.
  • EXPIRED — Reached the date and time set in will_expire.
  • ASSIGNMENTS_LIMIT_EXCEEDED — Closed automatically because it exceeded the limit on assigned task suites (2 million maximum).
  • BLOCKED — Closed automatically because the requester's account was blocked by a Toloka administrator.
String Not used
Key Value Data type Required during creation
id
ID of the training pool. String Not used
project_id
ID of the project that the training pool was created for. String Yes
private_name
Name of the training pool (only visible to the requester). String Yes
inherited_instructions

Indicates whether to use the project instructions. To provide separate instructions for the training, enter it in public_instructions.

The default value is false.

Boolean Yes
public_instructions
Instructions for completing a training task. You can use any HTML markup. String No
may_contain_adult_content
Whether training tasks contain adult content. Boolean Yes
assignment_max_duration_seconds
The time allowed for completing a task suite, in seconds. We recommend allowing no more than 60 seconds per task suite (including the time for loading the page and submitting assignments). Number Yes
mix_tasks_in_creation_order
Whether training tasks are issued in their upload order:
  • true — Tasks are grouped into task suites in the order of rows in the uploaded file (top-to-bottom).
  • false — Tasks are taken at random.
The default value is true.
Boolean No
shuffle_tasks_in_task_suite
Whether training tasks are shuffled within each task suite:
  • true — Yes.
  • false — No, they are listed in their upload order.
The default value is true.
Boolean No
training_tasks_in_task_suite_count
Number of training tasks per suite. Number Yes
task_suites_required_to_pass
Number of task suites the user needs to complete to get a skill and access the main tasks. Number Yes
retry_training_after_days
Number of days until retry becomes available. Number No
owner.id
Requester ID. String Not used
owner.myself
Checks who the object belongs to:
  • true — The user who made the request.
  • false — Another account (employee or owner).
Boolean Not used
status
Training pool status:
  • OPEN
  • CLOSED
  • ARCHIVED
String Not used
created
The UTC date and time when the training pool was created, in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. String Not used
last_started
The date and time when the training pool was last started, in UTC in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. String Not used
last_stopped
The date and time when the pool was last stopped, in UTC in ISO 8601 format: YYYY-MM-DDThh:mm:ss[.sss]. String Not used
last_close_reason
The reason for closing the training pool the last time:
  • MANUAL — Closed by the requester.
  • EXPIRED — Reached the date and time set in will_expire.
  • ASSIGNMENTS_LIMIT_EXCEEDED — Closed automatically because it exceeded the limit on assigned task suites (2 million maximum).
  • BLOCKED — Closed automatically because the requester's account was blocked by a Toloka administrator.
String Not used