Документация Толоки

Сумма вознаграждения

Обратите внимание

Документация на русском языке может быть устаревшей. Самые последние изменения доступны в документации на английском языке.

Описание

Вы можете ограничить сумму вознаграждения на каждого исполнителя в пуле: при достижении установленной суммы исполнитель потеряет доступ к заданиям. Ограничение позволяет:

  • получить ответы как можно большего числа работников (в этом случае устанавливается низкий порог, например, равный стоимости одной страницы заданий);

  • обеспечить защиту от роботов (в этом случае порог должен быть выше, например, 10% от стоимости всего пула).

Задайте значения ключей в массиве quality_control.configs в настройках пула.

Тело запроса

Доступ ко всем проектам заказчика прекращается, если суточный заработок исполнителя за выполнение заданий пула достигает 20 долларов.

Вы можете заблокировать доступ на необходимое количество дней, часов, минут (по отдельности и в совокупности) или навсегда.

Блокировка на 10 дней

{
  "configs": [
    {
      "collector_config": {
        "type": "INCOME"
      },
      "rules": [
        {
          "conditions": [
            {
              "key": "income_sum_for_last_24_hours",
              "operator": "GTE",
              "value": 20
            }
          ],
          "action": {
            "type": "RESTRICTION_V2",
            "parameters": {
              "scope": "ALL_PROJECTS",
              "duration_unit": "DAYS",
              "duration": 10,
              "private_comment": "Too many tasks have been completed"
            }
          }
        }
      ]
    }
  ]
}

Чтобы задать другой период блокировки, измените значение соответствующего параметра ключа action:

{
  ...
    "action": {
      "type": "RESTRICTION_V2",
      "parameters": {
        "scope": "ALL_PROJECTS",
        "duration_unit": "HOURS",
        "duration": 12,
        "private_comment": "Too many tasks have been completed"
      }
    }
  ...
}

{
  ...
    "action": {
      "type": "RESTRICTION_V2",
      "parameters": {
        "scope": "ALL_PROJECTS",
        "duration_unit": "MINUTES",
        "duration": 30,
        "private_comment": "Too many tasks have been completed"
      }
    }
  ...
}

{
  ...
    "action": {
      "type": "RESTRICTION_V2",
      "parameters": {
        "scope": "ALL_PROJECTS",
        "duration_unit": "PERMANENT",
        "private_comment": "Too many tasks have been completed"
      }
    }
  ...
}

Параметр

Описание

configs[]

array of objects | обязательный

Массив настроек контроля качества.

configs.collector_config

object | обязательный

Параметры для сбора статистики (например, количество пропусков заданий в пуле).

configs.collector_config.type

string | обязательный

Критерий, на котором основан блок качества:

  • GOLDEN_SET — количество правильных и неправильных ответов в контрольных заданиях.
  • MAJORITY_VOTE — доля ответов, которые совпали с мнением большинства.
  • CAPTCHA — количество успешно и неуспешно введенных капч.
  • INCOME — плата за задания, выполненные исполнителем за последние 24 часа.
  • SKIPPED_IN_ROW_ASSIGNMENTS — количество пропущенных подряд страниц заданий.
  • ANSWER_COUNT — количество страниц заданий, выполненных исполнителем в пуле.
  • ASSIGNMENT_SUBMIT_TIME — количество «быстрых» ответов (минимальная скорость ответа задается в параметрах).
  • ACCEPTANCE_RATE — доля ответов исполнителя, которые были отклонены при отложенной приемке заданий.
  • ASSIGNMENTS_ASSESSMENT — количество принятых или отклоненных заданий при включенной отложенной приемке заданий.
  • USERS_ASSESSMENT — значение навыка исполнителя и его блокировка.

configs.rules.conditions

object | обязательный

Условия (например, пропуск 10 страниц заданий подряд). Несколько условий объединяются с помощью оператора «или».

configs.rules.conditions.key

string | обязательный

Значения, которые проверяются в условии:

  • income_sum_for_last_24_hours — сумма вознаграждения исполнителя за задания пула в последние 24 часа (в долларах).

configs.rules.conditions. operator

string | обязательный

Оператор сравнения (данные key сравниваются с пороговым значением из value):

  • EQ («Equal») — равно.
  • NE («Not equal to») — не равно.
  • GT («Greater than») — больше чем.
  • LT («Less than») — меньше чем.
  • GTE («Greater than equal to») — больше или равно.
  • LTE («Less than equal to») — меньше или равно.

configs.rules.conditions. value

integer | обязательный

Пороговое значение переменной, указанной в key.

configs.rules.action

object | обязательный

Действие в случае выполнения условий (например, закрыть доступ к проекту).

configs.rules.action.type

string | обязательный

Тип действия:

  • RESTRICTION_V2 — заблокировать доступ к проектам или пулам.

  • SET_SKILL_FROM_OUTPUT_FIELD — присвоить навыку значение «доля правильных ответов» (используется в блоках Контрольный набор и Мнение большинства).

    Значение навыка можно использовать для отбора исполнителей.

  • CHANGE_OVERLAP — изменить перекрытие. Например, чтобы повторно отправить страницу заданий на выполнение другим исполнителям или отменить повторное выполнение уже принятых заданий.

  • REJECT_ALL_ASSIGNMENTS — отклонить все ответы исполнителя. Например, спустя несколько ответов исполнителя стало понятно, что он некачественно выполняет задания.

  • APPROVE_ALL_ASSIGNMENTS — принять все ответы исполнителя. Например, если исполнитель выполняет большинство заданий качественно и вас устраивает такой результат.

  • SET_SKILL — присвоить навыку указанное константное значение.

configs.rules.action. parameters

object | обязательный

Параметры действия.

configs.rules.action. parameters.scope

string | обязательный

Уровень ограничения:

  • POOL — пул. Не влияет на рейтинг исполнителя.
  • PROJECT — проект. Влияет на рейтинг исполнителя.
  • ALL_PROJECTS — все проекты заказчика.

configs.collector_config. parameters

object | обязательный при условии

Обязательный, если configs.collector_config.type=``GOLDEN_SET, MAJORITY_VOTE, CAPTCHA, ASSIGNMENT_SUBMIT_TIME.

Параметры для сбора данных (зависят от блока контроля качества, указанного в ключе type).

configs.rules.action. parameters.skill_id

string | обязательный при условии

Обязателен, если type=SET_SKILL_FROM_OUTPUT_FIELD.

Идентификатор навыка, который необходимо обновлять по мере выполнения заданий.

configs.rules.action. parameters.from_field

string | обязательный при условии

Обязателен, если type=SET_SKILL_FROM_OUTPUT_FIELD.

Значение, которое нужно присвоить навыку:

  • correct_answers_rate — доля правильных ответов;
  • wrong_answers_rate — доля неправильных ответов.

configs.rules.action. parameters.skill_value

integer | обязательный при условии

Обязателен, если type=SET_SKILL_FROM_OUTPUT_FIELD.

Фиксированное значение, которое нужно присвоить навыку (число от 0 до 100).

configs.rules.action. parameters.delta

integer | обязательный при условии

Обязателен, если type=CHANGE_OVERLAP.

Значение определяет, на сколько изменить перекрытие.

configs.rules.action. parameters.public_comment

string | обязательный при условии

Обязателен, если type=REJECT_ALL_ASSIGNMENTS. Комментарий (причина отклонения ответов). Доступен заказчику и исполнителю.

configs.rules.action. parameters.open_pool

boolean

Определяет, нужно ли открыть закрытый пул:

  • true — открыть пул после изменения, если он закрыт.
  • false — не открывать пул после изменения, если он закрыт.

configs.rules.action. parameters.duration_unit

string

Единица измерения длительности блокировки:

  • MINUTES — минуты;
  • HOURS — часы;
  • DAYS — дни;
  • PERMANENT — навсегда.

configs.rules.action. parameters.duration

integer

Длительность блокировки.

configs.rules. action.parameters. private_comment

string

Комментарий (причина блокировки). Доступен только заказчику.
В этой статье: