Skill

toloka.client.skill.Skill | Source code

Skill(
self,
*,
name: Optional[str] = None,
private_comment: Optional[str] = None,
hidden: Optional[bool] = None,
skill_ttl_hours: Optional[int] = None,
training: Optional[bool] = None,
public_name: Optional[Dict[str, str]] = None,
public_requester_description: Optional[Dict[str, str]] = None,
owner: Optional[Owner] = None,
id: Optional[str] = None,
created: Optional[datetime] = None
)

Some characteristic of a Toloker described by a number from 0 to 100.

A Skill describes some characteristic, for example the percentage of correct responses. Skills can be used to filter Tolokers.

Skill values are assigned to Tolokers by quality control rules, or manually. The values are accessed via the UserSkill class.

Learn more about the Toloker skills.

Parameters description

ParametersTypeDescription
nameOptional[str]

The skill name.

public_nameOptional[Dict[str, str]]

The skill name visible to Tolokers. The name can be provided in several languages.

public_requester_descriptionOptional[Dict[str, str]]

The skill description visible to Tolokers. The description can be provided in several languages.

private_commentOptional[str]

Comments visible to a requester.

hiddenOptional[bool]

Visibility of the skill values to Tolokers:

  • True — Tolokers don't see the information about the skill.
  • False — Tolokers see the name and the value of the assigned skill.

Default value: True.

skill_ttl_hoursOptional[int]

A lifetime in hours. If the skill value assigned to a Toloker is not updated for skill_ttl_hours, the skill is removed from a Toloker's profile.

trainingOptional[bool]

Whether the skill is related to a training pool:

  • True — The skill value is set after completing a training pool.
  • False — The skill isn't related to a training pool.
ownerOptional[Owner]

The skill owner.

idOptional[str]

The skill ID. Read-only field.

createdOptional[datetime]

The UTC date and time when the skill was created. Read-only field.

Examples:

Creating a new skill if it doesn't exist.

segmentation_skill = next(toloka_client.get_skills(name='Road signs detection'), None)
if segmentation_skill:
print(f'Skill exists. ID: {segmentation_skill.id}')
else:
segmentation_skill = toloka_client.create_skill(
name='Road signs detection',
public_requester_description={
'EN': 'The quality of selecting road signs on images',
'RU': 'Качество выделения дорожных знаков на фотографиях',
},
)
print(f'Skill created. ID: {segmentation_skill.id}')

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