Toloka documentation

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,
    id: Optional[str] = None,
    created: Optional[datetime] = None
)

A skill is an assessment of some aspect of a user's responses (a number from 0 to 100)

Skill is a general grouping entity, for example "image annotation", which is created once and then used. To set the Skill value for a specific performer, use UserSkill. You can set up skill calculation in a quality control rule, or manually set the skill level for a user. You can use skills to select users who perform pool tasks.

Parameters Description

Parameters Type Description
name Optional[str]

Skill name.

private_comment Optional[str]

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

hidden Optional[bool]

Access to information about the skill (the name and value) for users:

  • True - Closed. Default behaviour.
  • False - Opened.

skill_ttl_hours Optional[int]

The skill's "time to live" after the last update (in hours). The skill is removed from the user's profile if the skill level hasn't been updated for the specified length of time.

training Optional[bool]

Whether the skill is related to a training pool:

  • True - The skill level is calculated from training pool tasks.
  • False - The skill isn't related to a training pool.

public_name Optional[Dict[str, str]]

Skill name for other users. You can provide a name in several languages (the message will come in the user's language).

public_requester_description Optional[Dict[str, str]]

Skill description text for other users. You can provide text in several languages (the message will come in the user's language).

id Optional[str]

Skill ID. Read only field.

created Optional[datetime]

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

Examples:

How to create new skill.

segmentation_skill = toloka_client.create_skill(
    name='Area selection of road signs',
    public_requester_description={
        'EN': 'Performer is annotating road signs',
        'RU': 'Как исполнитель размечает дорожные знаки',
    },
)
print(segmentation_skill.id)

How to find skill.

segmentation_skill = next(toloka_client.get_skills(name='Area selection of road signs'), None)
if segmentation_skill:
    print(f'Segmentation skill already exists, with id {segmentation_skill.id}')
else:
    print('Create new segmentation skill here')