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

Создать пул

Важно

Домен toloka.yandex.com работает в режиме deprecated. Рекомендуем переключиться на домен toloka.dev для запросов API.

Создает пул.

Созданному пулу автоматически присваивается идентификатор.

Внимание

Вы можете отправить не более 20 таких запросов в минуту и не более 100 в день.

Примечание

О создании обучающего пула читайте в разделе Создать обучение.

Запрос

POST https://toloka.dev/api/v1/pools
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
POST https://sandbox.toloka.dev/api/v1/pools
Authorization: OAuth <OAuth token>
Content-Type: application/JSON

Заголовки

Заголовок Описание
Authorization Токен для авторизации аккаунта. В качестве префикса добавьте OAuth.
Content-Type Указывает формат данных в передаваемом теле запроса.

Тело запроса

{
  "project_id": "1",
  "private_name": "My first pool",
  "private_comment": "This is my first pool",
  "public_description": "Pool's description ",
  "may_contain_adult_content": false,
  "will_expire": "2020-09-01T13:00",
  "reward_per_assignment": 0.02,
  "dynamic_pricing_config": {
    "type": "SKILL",
    "skill_id": "1289",
    "intervals": [
      {
        "from": 0,
        "to": 60,
        "reward_per_assignment": 0.03
      },
      {
        "from": 61,
        "to": 100,
        "reward_per_assignment": 0.04
      }
    ]
  },
  "assignment_max_duration_seconds": 300,
  "auto_accept_solutions": true,
  "auto_accept_period_day": 7,
  "auto_close_after_complete_delay_seconds": 60,
  "assignments_issuing_config": {
    "issue_task_suites_in_creation_order": false
  },
  "filter": {<settings for filtering users>},
  "quality_control": {
    "training_requirement": {
      "training_pool_id": "21",
      "training_passing_skill_value": 70
    },
    "captcha_frequency": "LOW",
    "configs": {<quality control rule settings>},
    "checkpoints_config": {
      "real_settings": {
        "target_overlap": 5,
        "task_distribution_function": {
          "scope": "PROJECT",
          "distribution": "UNIFORM",
          "window_days": 7,
          "intervals": [
            {
              "from": 1,
              "to": 100,
              "frequency": 5
            },
            {
              "from": 101,
              "to": 1000,
              "frequency": 25
            }
          ]
        }
      },
      "golden_settings": {
        "target_overlap": 5,
        "task_distribution_function": {
          "scope": "PROJECT",
          "distribution": "UNIFORM",
          "window_days": 7,
          "intervals": [
            {
              "from": 1,
              "to": 100,
              "frequency": 5
            },
            {
              "from": 101,
              "to": 1000,
              "frequency": 25
            }
          ]
        }
      },
      "training_settings": {
        "target_overlap": 5,
        "task_distribution_function": {
          "scope": "PROJECT",
          "distribution": "UNIFORM",
          "window_days": 7,
          "intervals": [
            {
              "from": 1,
              "to": 100,
              "frequency": 5
            },
            {
              "from": 101,
              "to": 1000,
              "frequency": 25
            }
          ]
        }
      }
    }
  },
  "speed_quality_balance": {
    "type": "TOP_PERCENTAGE_BY_QUALITY",
    "percent": 80
  },
  "dynamic_overlap_config": {
    "type": "BASIC",
    "max_overlap": 5,
    "min_confidence": 0.9,
    "answer_weight_skill_id": "1289",
    "fields": [
      {
        "name": "result"
      }
    ]
  },
  "defaults" : {
    "default_overlap_for_new_task_suites" : 3,
    "default_overlap_for_new_tasks": 3
  },
  "mixer_config": {
    "real_tasks_count": 6,
    "golden_tasks_count": 1,
    "training_tasks_count": 1,
    "min_real_tasks_count": 2,
    "min_golden_tasks_count": 0,
    "min_training_tasks_count": 0,
    "force_last_assignment": true,
    "force_last_assignment_delay_seconds": 10,
    "mix_tasks_in_creation_order": true,
    "shuffle_tasks_in_task_suite": false,
    "golden_task_distribution_function": {
      "scope": "PROJECT",
      "distribution": "UNIFORM",
      "window_days": 7 ,
      "intervals": [
        {
          "from": 1,
          "to": 25,
          "frequency": 5
        },
        {
          "from": 26,
          "to": 1000,
          "frequency": 25
        }
      ]
    },
    "training_task_distribution_function": {
      "scope": "PROJECT",
      "distribution": "UNIFORM",
      "window_days": 7,
      "intervals": [
        {
          "from": 1,
          "to": 25,
          "frequency": 5
        },
        {
          "from": 26,
          "to": 1000,
          "frequency": 25
        }
      ]
    }
  },
  "priority": 10
}

Параметр

Описание

project_id

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

Идентификатор проекта, для которого создан пул.

private_name

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

Название пула (доступно только заказчику).

may_contain_adult_content

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

Присутствие контента для взрослых в заданиях.

will_expire

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

Дата и время по UTC, когда пул нужно закрыть (даже если не все страницы заданий выполнены). Формат даты ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

reward_per_assignment

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

Плата за страницу заданий в долларах США. Для центов используйте точку («.») в качестве разделителя. Минимальная плата составляет $0.01.

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

defaults

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

Настройки, которые применяются по умолчанию при загрузке новых страниц заданий в пул.

defaults.default_overlap_ for_new_task_suites

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

Перекрытие для страниц заданий, которые загружаются в пул (используется, если при загрузке указан параметр allow_defaults=true).

dynamic_pricing_config.type

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

Обязателен, если используется динамическое ценообразование.

Тип параметра для расчета динамического ценообразования. Значение SKILL.

dynamic_pricing_config. skill_id

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

Обязателен, если используется динамическое ценообразование.

Идентификатор навыка, по уровню которого рассчитывается плата за задание.

dynamic_pricing_config. intervals[]

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

Обязателен, если используется динамическое ценообразование.

Интервалы уровней навыка. Не должны пересекаться.

Исполнитель с уровнем навыка, не входящим ни в один интервал, получит базовую цену за страницу заданий.

dynamic_pricing_config. intervals[].from

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

Обязателен, если используется динамическое ценообразование.

Нижняя граница интервала. Может принимать значения от 0 до 100. По умолчанию 0.

dynamic_pricing_config. intervals[].to

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

Обязателен, если используется динамическое ценообразование.

Верхняя граница интервала. Может принимать значения от 0 до 100. По умолчанию 100.

dynamic_pricing_config. intervals[].reward_per_ assignment

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

Обязателен, если используется динамическое ценообразование.

Цена за страницу заданий для исполнителя с указанным уровнем навыка.

quality_control. checkpoints_config. real_settings. target_overlap

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

Обязателен, если используется выборочная проверка.

Перекрытие в заданиях с выборочной проверкой.

quality_control. checkpoints_config. real_settings. task_distribution_function

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. real_settings. task_distribution_function. scope

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

Обязателен, если используется выборочная проверка.

Подсчет заданий, выполненных исполнителем:

  • POOL — учитывать задания, выполненные в пуле.
  • PROJECT — учитывать задания, выполненные в проекте.

quality_control. checkpoints_config. real_settings. task_distribution_function. distribution

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

Обязателен, если используется выборочная проверка.

Распределение заданий с выборочной проверкой внутри интервала. У параметра одно возможное значение — UNIFORM.

quality_control. checkpoints_config. real_settings. task_distribution_function. window_days

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. real_settings. task_distribution_function. intervals[]

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

Обязателен, если используется выборочная проверка.

Границы интервалов и частота выдачи заданий с выборочной проверкой.

quality_control. checkpoints_config. real_settings. task_distribution_function. intervals[].from

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. real_settings. task_distribution_function. intervals[].to

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

Обязателен, если используется выборочная проверка.

Конец интервала (номер задания, выполненного исполнителем в проекте или пуле).

quality_control. checkpoints_config. real_settings. task_distribution_function. intervals[].frequency

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

Обязателен, если используется выборочная проверка.

Частота выдачи заданий с выборочной проверкой в интервале. Первое задание в интервале проверочное. Например, при значении frequency: 3 задания 1, 4, 7 и т. д. будут проверочными.

quality_control. checkpoints_config. golden_settings. target_overlap

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. golden_settings. task_distribution_function

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

Обязателен, если используется выборочная проверка.

Распределение контрольных заданий с выборочной проверкой.

quality_control. checkpoints_config. golden_settings. task_distribution_function. scope

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

Обязателен, если используется выборочная проверка.

Подсчет заданий, выполненных исполнителем:

  • POOL — учитывать задания, выполненные в пуле.
  • PROJECT — учитывать задания, выполненные в проекте.

quality_control. checkpoints_config. golden_settings. task_distribution_function. distribution

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

Обязателен, если используется выборочная проверка.

Распределение контрольных заданий с выборочной проверкой внутри интервала. У параметра одно возможное значение — UNIFORM.

quality_control. checkpoints_config. golden_settings. task_distribution_function. window_days

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. golden_settings. task_distribution_function. intervals[]

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

Обязателен, если используется выборочная проверка.

Границы интервалов и частота выдачи контрольных заданий с выборочной проверкой.

quality_control. checkpoints_config. golden_settings. task_distribution_function. intervals[].from

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. golden_settings. task_distribution_function. intervals[].to

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

Обязателен, если используется выборочная проверка.

Конец интервала (номер задания, выполненного исполнителем в проекте или пуле).

quality_control. checkpoints_config. golden_settings. task_distribution_function. intervals[].frequency

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

Обязателен, если используется выборочная проверка.

Частота выдачи контрольных заданий с выборочной проверкой в интервале. Первое задание в интервале проверочное. Например, при значении frequency: 3 задания 1, 4, 7 и т. д. будут проверочными.

quality_control. checkpoints_config. training_settings. target_overlap

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

Обязателен, если используется выборочная проверка.

Перекрытие в обучающих заданиях с выборочной проверкой.

quality_control. checkpoints_config. training_settings. task_distribution_function

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

Обязателен, если используется выборочная проверка.

Распределение обучающих заданий с выборочной проверкой.

quality_control. checkpoints_config. training_settings. task_distribution_function. scope

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

Обязателен, если используется выборочная проверка.

Подсчет заданий, выполненных исполнителем:

  • POOL — учитывать задания, выполненные в пуле.
  • PROJECT — учитывать задания, выполненные в проекте.

quality_control. checkpoints_config. training_settings. task_distribution_function. distribution

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

Обязателен, если используется выборочная проверка.

Распределение обучающих заданий с выборочной проверкой внутри интервала. У параметра одно возможное значение — UNIFORM.

quality_control. checkpoints_config. training_settings. task_distribution_function. window_days

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. training_settings. task_distribution_function. intervals[]

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

Обязателен, если используется выборочная проверка.

Границы интервалов и частота выдачи обучающих заданий с выборочной проверкой.

quality_control. checkpoints_config. training_settings. task_distribution_function. intervals[].from

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

Обязателен, если используется выборочная проверка.

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

quality_control. checkpoints_config. training_settings. task_distribution_function. intervals[].to

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

Обязателен, если используется выборочная проверка.

Конец интервала (номер задания, выполненного исполнителем в проекте или пуле).

quality_control. checkpoints_config. training_settings. task_distribution_function. intervals[].frequency

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

Обязателен, если используется выборочная проверка.

Частота выдачи обучающих заданий с выборочной проверкой в интервале. Первое задание в интервале проверочное. Например, при значении frequency: 3 задания 1, 4, 7 и т. д. будут проверочными.

dynamic_overlap_config.type

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

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

Алгоритм динамического перекрытия.

BASIC — каждому ответу присваивается вес в зависимости от значения навыка исполнителя. Достоверность агрегированного ответа рассчитывается на основе вероятностного алгоритма. Перекрытие задания повышается до тех пор, пока не достигнет max_overlap или достоверность агрегированного ответа не превысит min_confidence.

Необходимо указать max_overlap, min_confidence, answer_weight_skill_id и fields.

dynamic_overlap_config. max_overlap

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

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

Максимальное перекрытие. Должно превышать значения в defaults. Минимум — 1. Максимум — 30000.

dynamic_overlap_config. min_confidence

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

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

Минимальная достоверность агрегированного ответа. Значения от 0 до 1.

dynamic_overlap_config. answer_weight_skill_id

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

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

Навык, который определяет вес ответа исполнителя. Для получения наилучших результатов используйте навык, значение которого вычисляется как доля правильных ответов на контрольные заданий.

dynamic_overlap_config. fields

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

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

Поля выходных данных, ответы на которые будут агрегированы. Для получения наилучших результатов каждое из этих полей должно иметь ограниченное количество вариантов ответа.

Не указывайте несколько полей, если их значения зависят друг от друга.

dynamic_overlap_config. fields.name

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

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

Имя поля выходных данных.

mixer_config

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

Обязателен, если используется «умное смешивание».

Параметры для автоматического создания страниц заданий («умное смешивание»). Подробнее о формировании страниц заданий см. в документе Руководство заказчика.

mixer_config. real_tasks_count

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

Обязателен, если используется «умное смешивание».

Количество основных заданий на странице.

Максимальное количество заданий на странице, если используется golden_task_distribution_function или training_task_distribution_function.

mixer_config. golden_tasks_count

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

Обязателен, если используется «умное смешивание».

Количество контрольных заданий на странице.

mixer_config. training_tasks_count

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

Обязателен, если используется «умное смешивание».

Количество обучающих заданий на странице.

mixer_config.golden_task_ distribution_function.scope

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

Обязателен, если используется выдача контрольных заданий с неравномерной частотой.

Подсчет заданий, выполненных исполнителем:

  • POOL — учитывать задания, выполненные в пуле.
  • PROJECT — учитывать задания, выполненные в проекте.

mixer_config.golden_task_ distribution_function. distribution

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

Обязателен, если используется выдача контрольных заданий с неравномерной частотой.

Распределение контрольных заданий внутри интервала. У параметра одно возможное значение — UNIFORM.

mixer_config.golden_task_ distribution_function. window_days

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

Обязателен, если используется выдача контрольных заданий с неравномерной частотой.

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

mixer_config.golden_task_ distribution_function. intervals[]

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

Обязателен, если используется выдача контрольных заданий с неравномерной частотой.

Границы интервалов и количество контрольных заданий в интервале.

mixer_config.golden_task_ distribution_function. intervals[].from

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

Обязателен, если используется выдача контрольных заданий с неравномерной частотой.

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

mixer_config.golden_task_ distribution_function. intervals[].to

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

Обязателен, если используется выдача контрольных заданий с неравномерной частотой.

Конец интервала (номер задания, выполненного исполнителем в проекте или пуле).

mixer_config.golden_task_ distribution_function. intervals[].frequency

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

Обязателен, если используется выдача контрольных заданий с неравномерной частотой.

Частота выдачи контрольных заданий в интервале. Первое задание в интервале контрольное. Например, при значении frequency: 3 задания 1,4,7 и т. д. будут контрольными.

mixer_config.training_task_ distribution_function.scope

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

Обязателен, если используется выдача обучающих заданий с неравномерной частотой.

Подсчет заданий, выполненных исполнителем:

  • POOL — учитывать задания, выполненные в пуле.
  • PROJECT — учитывать задания, выполненные в проекте.

mixer_config.training_task_ distribution_function. distribution

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

Обязателен, если используется выдача обучающих заданий с неравномерной частотой.

Распределение обучающих заданий внутри интервала. У параметра одно возможное значение — UNIFORM.

mixer_config.training_task_ distribution_function. window_days

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

Обязателен, если используется выдача обучающих заданий с неравномерной частотой.

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

mixer_config.training_task_ distribution_function. intervals[]

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

Обязателен, если используется выдача обучающих заданий с неравномерной частотой.

Границы интервалов и количество контрольных заданий в интервале.

mixer_config.training_task_ distribution_function. intervals[].from

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

Обязателен, если используется выдача обучающих заданий с неравномерной частотой

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

Да, если используется выдача обучающих заданий с неравномерной частотой

mixer_config.training_task_ distribution_function. intervals[].to

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

Обязателен, если используется выдача обучающих заданий с неравномерной частотой.

Конец интервала (номер задания, выполненного исполнителем в проекте или пуле).

mixer_config.training_task_ distribution_function. intervals[].frequency

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

Обязателен, если используется выдача обучающих заданий с неравномерной частотой.

Частота выдачи обучающих заданий в интервале. Первое задание в интервале обучающее. Например, при значении frequency: 3 задания 1,4,7 и т. д. будут обучающими.

private_comment

string

Комментарий к пулу (доступен только заказчику).

public_description

string

Описание для исполнителей. Если заполнено, то текст будет отображаться вместо public_description проекта в списке заданий для исполнителей.

dynamic_pricing_config

object

Настройки динамического ценообразования.

auto_accept_solutions

boolean

Необходимость проверки заданий вручную:

  • true — автоматическая приемка заданий (проверка не нужна);
  • false — проверка заданий заказчиком.

По умолчанию значение true.

auto_accept_period_day

integer

Время (количество дней) проверки задания заказчиком. Если заказчик не примет или не отклонит задание за данный срок, то решение будет принято автоматически. Может принимать значение от 1 до 21.

auto_close_after_complete_ delay_seconds

integer

Время ожидания (в секундах) перед автоматическим закрытием пула, после того как все задания выполнены. Минимум — 0, максимум — 259 200 секунд (трое суток). По умолчанию значение 0.

Используйте, если:

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

assignments_issuing_config

object Настройки выдачи заданий в пуле.

assignments_issuing_config. issue_task_suites_in_ creation_order

boolean

Для пулов, которые не используют «умное смешивание» .

Выдача страниц заданий в порядке, в котором они были загружены. Например, для пула с перекрытием 5 сначала будет выдана первая страница заданий пяти исполнителям, затем вторая и так далее. Параметр можно использовать, если в проекте "assignments_issuing_type": "AUTOMATED".

priority

integer

Приоритет пула среди других пулов проекта с такой же стоимостью заданий и набором фильтров. Сначала исполнителям выдаются задания с большим приоритетом.

Возможные значения: от 0 до 100.

По умолчанию значение 0.

filter

object

Настройки фильтров для отбора исполнителей.

quality_control

object

Настройки блоков контроля качества и идентификатор пула с обучающими заданиями.

quality_control. training_requirement

object

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

quality_control. training_requirement. training_pool_id

string

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

quality_control. training_requirement. training_passing_skill_value

integer

Доля правильных ответов в обучающих заданиях (от 0 до 100), необходимая для допуска к основным заданиям. Для подсчета используются первые ответы исполнителя в заданиях.

quality_control. captcha_frequency

string

Частота показа капчи:

  • LOW — показывать каждые 20 заданий.
  • MEDIUM, HIGH — показывать каждые 10 заданий.

По умолчанию капча не показывается.

quality_control.configs

object

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

quality_control. checkpoints_config

object

Выборочная проверка заданий. Если вы хотите, чтобы проверка происходила методом мнение большинства, укажите MAJORITY_VOTE в параметре quality_control. Некоторые задания выдаются с высоким перекрытием (например, «5») и проходят проверку. Остальные задания выдаются с перекрытием, установленным в настройках пула (например, «1») и остаются без проверки. Выборочная проверка позволяет улучшить качество выполнение пула.

Вы можете сокращать частоту проверок со временем.

Пример настроек: в первых 100 заданиях, выполненных исполнителем в пуле, выдавать каждое пятое задание с перекрытием «5», чтобы сверить ответы. В последующих заданиях выдавать каждое 25 задание с перекрытием «5».

quality_control. checkpoints_config. real_settings

object

Выборочная проверка обычных заданий. Чтобы выборочная проверка работала, не забудьте настроить показ заданий в mixer_config.

quality_control. checkpoints_config. golden_settings

object

Выборочная проверка контрольных заданий. Чтобы выборочная проверка работала, не забудьте настроить показ этого типа заданий в mixer_config.

quality_control. checkpoints_config. training_settings

object

Выборочная проверка обучающих заданий. Чтобы выборочная проверка работала, не забудьте настроить показ этого типа заданий в mixer_config.

speed_quality_balance

object

Соотношение скорости и качества.

speed_quality_balance. type

string

Тип соотношения. Может принимать значения:

  • TOP_PERCENTAGE_BY_QUALITY — исполнители с лучшим качеством выполнения заданий;
  • BEST_CONCURRENT_USERS_BY_QUALITY — активные исполнители, которым доступно задание.

speed_quality_balance. percent

integer

Процент исполнителей с лучшим качеством выполнения заданий. Поле появляется, если указан тип соотношения TOP_PERCENTAGE_BY_QUALITY. Может принимать значения 10, 20, 30, 40...100.

speed_quality_balance. count

integer

Количество активных исполнителей, которым доступно задание. Поле появляется, если указан тип соотношения BEST_CONCURRENT_USERS_BY_QUALITY. Может принимать значения от 1 до 100.

dynamic_overlap_config

object

Настройка динамического перекрытия (incremental relabeling, IRL). Позволяет изменять перекрытие в зависимости от того, насколько хорошо исполнители справляются с заданием.

Установите интервал закрытия (auto_close_after_complete_delay_seconds). Его должно быть достаточно, чтобы были выполнены задания с перекрытием, выше минимального.

Когда все задания в пуле будут выполнены, агрегируйте ответы.

defaults.default_overlap_ for_new_tasks

integer

Перекрытие для заданий, которые загружаются в пул (используется, если при загрузке указан параметр allow_defaults=true).

mixer_config. min_real_tasks_count

float

Минимальное количество основных заданий на странице (если не набирается число, указанное в mixer_config.real_tasks_count). Минимум — 0. По умолчанию значение равно указанному в mixer_config.real_tasks_count.

mixer_config. min_golden_tasks_count

integer

Минимальное количество контрольных заданий на странице (если не набирается число, указанное в mixer_config.golden_tasks_count). Минимум — 0. По умолчанию значение равно указанному в mixer_config.golden_tasks_count.

mixer_config. min_training_tasks_count

integer

Минимальное количество обучающих заданий на странице (если не набирается число, указанное в mixer_config.golden_tasks_count). Минимум — 0. По умолчанию значение равно указанному в mixer_config.training_tasks_count.

mixer_config. force_last_assignment

boolean

Настройка для последней страницы заданий в пуле, если невыполненных основных заданий осталось меньше минимума (mixer_config.min_real_tasks_count). Значения:

  • true — выдавать неполную страницу заданий.
  • false — не выдавать задания. Этот вариант удобен, если вы собираетесь добавлять задания после запуска пула.

По умолчанию значение true.

Параметр распространяется только на основные задания. Количество контрольных и обучающих заданий на последней странице должно быть полным (mixer_config.golden_tasks_count, mixer_config.training_tasks_count).

mixer_config.force_last_ assignment_ delay_seconds

integer

Время ожидания (в секундах) с момента добавления задания или увеличения перекрытия до выдачи последней страницы заданий в пуле. Минимум — 0, максимум — 86 400 секунд (одни сутки).

Параметр можно использовать, если в пуле force_last_assignment: true.

mixer_config.mix_tasks_ in_creation_ order

boolean

Порядок, в котором задания включаются в страницы:

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

По умолчанию значение false.

mixer_config. shuffle_tasks_in_task_suite

boolean

Порядок заданий внутри страницы заданий:

  • true — случайный.
  • false — порядок, в котором задания были загружены.

По умолчанию значение true.

mixer_config.golden_task_ distribution_function

object

Выдача контрольных заданий с неравномерной частотой. Позволяет изменять частоту проверки по мере выполнения заданий исполнителем.

Если заполнено, то в real_task_count укажите максимальное количество заданий на странице. Чтобы использовать опцию, установите значение параметров golden_tasks_count:0 и min_golden_tasks_count:0.

Граница интервала — номер задания в пуле. Если на странице заданий несколько интервалов, то к странице будет применена настройка первого интервала.

Пример:

На первой странице заданий (интервал от 1 до 25) каждое пятое задание будет контрольным, на последующих страницах — каждое 25-е задание.

mixer_config.training_task_ distribution_function

object

Выдача обучающих заданий с неравномерной частотой. Позволяет менять частоту обучающих заданий по мере выполнения заданий исполнителем.

Если заполнено, то в real_task_count укажите максимальное количество заданий на странице. Чтобы использовать опцию, установите значение параметров training_task_count:0 и min_training_tasks_count:0.

Пример:

На первой странице заданий (интервал от 1 до 25) каждое пятое задание будет обучающим, на последующих страницах — каждое 25-е задание.

Ответ

Содержит сведения о созданном пуле. Помимо параметров, которые задаются при создании пула, включает параметры, которые присваиваются пулу автоматически:

Параметр

Описание

id

string

Идентификатор пула.

status

string

Статус пула:

  • OPEN — открыт;
  • CLOSED — закрыт;
  • ARCHIVED — архивный.

last_close_reason

string

Причина, по которой пул был закрыт в последний раз:

  • MANUAL — закрыт заказчиком.
  • EXPIRED — истек срок, указанный в ключе will_expire.
  • COMPLETED — закрыт автоматически, так как все задания в пуле выполнены.
  • NOT_ENOUGH_BALANCE — закрыт автоматически, так как закончились деньги на счете в Толоке.
  • ASSIGNMENTS_LIMIT_EXCEEDED — закрыт автоматически, так как превышен лимит выданных страниц заданий (не более 2 млн).
  • BLOCKED — закрыт автоматически, так как аккаунт заказчика заблокирован администратором Толоки.
  • FOR_UPDATE — пул закрыт на время редактирования.

created

string

Дата и время создания пула по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

last_started

string

Дата и время последнего запуска пула по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

last_stopped

string

Дата и время последней остановки пула по UTC в формате ISO 8601: YYYY-MM-DDThh:mm:ss[.sss].

type

string

Устаревший параметр.

Тип пула. Всегда имеет значение REGULAR — обычный пул.