create_task_suites

toloka.client.TolokaClient.create_task_suites | Source code

Creates several task suites in Toloka.

Usually, you don't need to create a task suite manually, because Toloka can group tasks into suites automatically.

Use this method if you need to group specific tasks together or to set different parameters in different task suites. Task suites can be created in different pools. You can create general and control tasks or task suites in different pools with a single method call.

By default, create_task_suites starts asynchronous operation internally and waits for the completion of it. Do not change async_mode to False, if you do not understand clearly why you need it.

You can send a maximum of 100,000 requests of this kind per minute and 2,000,000 requests per day. It is recommended that you create no more than 10,000 task suites in a single request if the async_mode parameter is True.

Parameters Description

ParametersTypeDescription
task_suitesList[TaskSuite]

A list of task suites to be created.

operation_idOptional[UUID]

The ID of the operation conforming to the RFC4122 standard. Use it if the async_mode is set to True.

skip_invalid_itemsOptional[bool]

Task suite validation option:

  • True — All valid task suites are added. If a task suite does not pass validation, then it is not added to Toloka.
  • False — If any task suite does not pass validation, then operation is cancelled and no task suites are added to Toloka.

Default value: False.

allow_defaultsOptional[bool]

Active overlap setting:

  • True — Use the overlap that is set in the defaults.default_overlap_for_new_task_suites pool parameter.
  • False — Use the overlap that is set in the overlap task suite parameter.

Default value: False.

open_poolOptional[bool]

Open the pool immediately after creating a task suite, if the pool is closed.

async_modeOptional[bool]

Request processing mode:

  • True — Asynchronous operation is started internally.
  • False — The request is processed synchronously. A maximum of 5000 task suites can be added in a single request in this mode.

Default value: True.

Examples:

task_suites = [
toloka.client.TaskSuite(
pool_id=1,
overlap=1,
tasks=[
toloka.client.Task(input_values={
'question': 'Choose a random number'
})
]
)
]
task_suites = toloka_client.create_task_suites(task_suites)
Toloka-Kit
OverviewGetting OAuth tokenQuick start
Recipes
Reference
toloka.client
toloka.async_client
toloka.autoquality [autoquality]
toloka.metrics
toloka.streaming