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

A skill is an assessment of some aspect of a Toloker'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 Toloker, use UserSkill. You can set up skill calculation in a quality control rule, or manually set the skill level for a Toloker. You can use skills to select Tolokers which are allowed to complete your 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 Tolokers:

  • True - Closed. Default behavior.
  • 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 Toloker'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 Tolokers. You can provide a name in several languages (the message will come in the Toloker's language).

public_requester_description Optional[Dict[str, str]]

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

owner Optional[Owner]

Skill owner.

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': 'Toloker annotates 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')