# Pool

toloka.client.pool.Pool | Source code

Pool(
self,
*,
project_id: Optional[str] = None,
private_name: Optional[str] = None,
reward_per_assignment: Optional[float] = None,
assignment_max_duration_seconds: Optional[int] = None,
defaults: Optional[Defaults] = ...,
will_expire: Optional[datetime] = None,
private_comment: Optional[str] = None,
public_description: Optional[str] = None,
public_instructions: Optional[str] = None,
auto_close_after_complete_delay_seconds: Optional[int] = None,
dynamic_pricing_config: Optional[DynamicPricingConfig] = None,
auto_accept_solutions: Optional[bool] = None,
auto_accept_period_day: Optional[int] = None,
assignments_issuing_config: Optional[AssignmentsIssuingConfig] = None,
priority: Optional[int] = None,
filter: Optional[FilterCondition] = None,
quality_control: Optional[QualityControl] = ...,
speed_quality_balance: Optional[SpeedQualityBalanceConfig] = None,
dynamic_overlap_config: Optional[DynamicOverlapConfig] = None,
mixer_config: Optional[MixerConfig] = None,
training_config: Optional[TrainingConfig] = None,
owner: Optional[Owner] = None,
id: Optional[str] = None,
status: Optional[Status] = None,
last_close_reason: Optional[CloseReason] = None,
created: Optional[datetime] = None,
last_started: Optional[datetime] = None,
last_stopped: Optional[datetime] = None,
type: Optional[Type] = None
)


A set of tasks that are issued and checked according to the same rules within the project

Groups tasks by the following criteria: one-time start-up, which performers can perform tasks, quality control, price for TaskSuite's, overlap. Tasks, golden tasks and assignments are related to a pool.

## Parameters Description

Parameters Type Description
project_id Optional[str]

ID of the project that the pool was created for.

private_name Optional[str]

Name of the pool (only visible to the requester).

may_contain_adult_content Optional[bool]

reward_per_assignment Optional[float]

Payment per task suite in U.S. dollars. For cents, use the dot (".") as the separator. The minimum payment is \$0.01. Only training and control tasks can be uploaded to zero-price pools.

assignment_max_duration_seconds Optional[int]

The time allowed for completing a task suite, in seconds. Tasks not completed within this time are reassigned to other users. We recommend allowing no more than 60 seconds per task suite (including the time for page loading and sending responses).

defaults Optional[Defaults]

will_expire Optional[datetime]

The date and time in UTC when the pool should be closed (even if all the task suites haven't been completed).

private_comment Optional[str]

Comments on the pool (only visible to the requester).

public_description Optional[str]

Description for users. If it is filled in, the text will be displayed instead of the project's public_description in the list of tasks for performers.

public_instructions Optional[str]

Optional[str]

auto_close_after_complete_delay_seconds Optional[int]

Waiting time (in seconds) before automatic closure of the pool after all tasks are completed. Minimum — 0, maximum — 259200 seconds (three days). Use it if: * Your data processing is close to real time. * You need an open pool where you upload tasks. * Dynamic overlap is enabled in the pool (dynamic_overlap_config).

dynamic_pricing_config Optional[DynamicPricingConfig]

The dynamic pricing settings.

auto_accept_solutions Optional[bool]

Whether tasks must be checked manually:

• True - Automatic task acceptance (manual checking isn't necessary).
• False - The requester will check the tasks.

auto_accept_period_day Optional[int]

Optional[int]

assignments_issuing_config Optional[AssignmentsIssuingConfig]

Settings for assigning tasks in the pool.

priority Optional[int]

The priority of the pool in relation to other pools in the project with the same task price and set of filters. Users are assigned tasks with a higher priority first. Possible values: from -100 to 100. If the project has multiple pools, the order for completing them depends on the parameters:

• Pools with identical filter settings and price per task are assigned to users in the order in which they were started. The pool that was started earlier will be completed sooner. You can change the order for completing the pools.
• Pools with different filter settings and/or a different price per task are sent out for completion when the pool opens.

filter Optional[FilterCondition]

Settings for user selection filters.

quality_control Optional[QualityControl]

Settings for quality control rules and the ID of the pool with training tasks.

speed_quality_balance Optional[SpeedQualityBalanceConfig]

Settings for balance between speed and quality of pool done.

dynamic_overlap_config Optional[DynamicOverlapConfig]

Dynamic overlap setting. Allows you to change the overlap depending on how well the performers handle the task.

mixer_config Optional[MixerConfig]

Parameters for automatically creating a task suite (“smart mixing”).

training_config Optional[TrainingConfig]

Optional[TrainingConfig]

metadata Optional[Dict[str, List[str]]]

Optional[Dict[str, List[str]]]

owner Optional[Owner]

Optional[Owner]

id Optional[str]

status Optional[Status]

Status of the pool. Read only field.

last_close_reason Optional[CloseReason]

The reason for closing the pool the last time. Read only field.

created Optional[datetime]

When this pool was created. Read only field.

last_started Optional[datetime]

The date and time when the pool was last started. Read only field.

last_stopped Optional[datetime]

The date and time when the pool was last stopped. Read only field.

type Optional[Type]

Types of pool. Read only field.

Examples:

How to create a new pool in a project.

toloka_client = toloka.TolokaClient(your_token, 'PRODUCTION')
new_pool = toloka.pool.Pool(
project_id=existing_project_id,
private_name='Pool 1',
will_expire=datetime.datetime.now(datetime.timezone.utc) + datetime.timedelta(days=365),
reward_per_assignment=0.01,
assignment_max_duration_seconds=60*20,
filter=toloka.filter.Languages.in_('EN'),
)
new_pool = toloka_client.create_pool(new_pool)
print(new_pool.id)


## Methods Summary

Method Description
is_archived None
is_closed None
is_locked None
is_open None
set_assignments_issuing_config A shortcut setter for assignments_issuing_config