create_task_suite

toloka.async_client.client.AsyncTolokaClient.create_task_suite | Source code

Creates a task suite 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.

You can send a maximum of 100,000 requests of this kind per minute and 2,000,000 requests per day. To create several task suites at once use the create_task_suites method.

Parameters description

ParametersTypeDescription
task_suiteTaskSuite

A task suite to be created.

operation_idOptional[UUID]

The UUID of the operation that conforms to the RFC4122 standard. The UUID is used if async_mode is True.

Specify UUID to avoid accidental errors like Toloka operation duplication caused by network problems. If you send several requests with the same operation_id, Toloka performs the operation only once.

async_modeOptional[bool]

Request processing mode:

  • True — Asynchronous operation is started internally.
  • False — The request is processed synchronously.

Default value: True.

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.

  • Returns:

    Created task suite.

  • Return type:

    TaskSuite

Examples:

new_task_suite = toloka.client.TaskSuite(
    pool_id='1086170',
    tasks=[toloka.client.Task(input_values={'label': 'Cats vs Dogs'})],
    overlap=2
)
toloka_client.create_task_suite(new_task_suite)

Last updated: August 28, 2023

Toloka-Kit
OverviewGetting API keyQuick start
Recipes
Reference
toloka.client
toloka.async_client
toloka.autoquality [autoquality]
toloka.metrics
toloka.streaming