Создать пул

POST /pools

Создает пул.

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

Ограничение

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

См. полный список ограничений на странице Ограничение количества запросов.

Примечание

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

Примеры запросов

curl -X POST 'https://tasks.yandex.ru/api/v1/pools' \
     -H 'Content-Type: application/json' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -d '{"project_id":"83859","private_name":"First pool","will_expire":"2030-01-01T00:00:00.000Z","reward_per_assignment":5,"assignment_max_duration_seconds":300,"auto_accept_solutions":false,"defaults":{"default_overlap_for_new_task_suites":1}}'

import requests

url = "https://tasks.yandex.ru/api/v1/pools"
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
payload = {
  "project_id": "83859",
  "private_name": "First pool",
  "will_expire": "2030-01-01T00:00:00.000Z",
  "reward_per_assignment": 5,
  "assignment_max_duration_seconds": 300,
  "auto_accept_solutions": False,
  "defaults": {
    "default_overlap_for_new_task_suites": 1
  }
}
response = requests.post(url, headers=headers, json=payload)

print(response.text)

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://tasks.yandex.ru/api/v1/pools',
  'qs': {},
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
  },
  'body': JSON.stringify({
    "project_id": "83859",
    "private_name": "First pool",
    "will_expire": "2030-01-01T00:00:00.000Z",
    "reward_per_assignment": 5,
    "assignment_max_duration_seconds": 300,
    "auto_accept_solutions": false,
    "defaults": {
      "default_overlap_for_new_task_suites": 1
    }
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Заголовки

Заголовок

Описание

Authorization

API-токен для авторизации аккаунта. В качестве префикса добавьте OAuth.

Content-Type

Указывает формат данных (application/json) в передаваемом теле запроса.

Тело и параметры запроса

Пример тела запроса
{
  "project_id": "83859",
  "private_name": "First pool",
  "will_expire": "2030-01-01T00:00:00.000Z",
  "reward_per_assignment": 5,
  "assignment_max_duration_seconds": 300,
  "auto_accept_solutions": false,
  "defaults": {
    "default_overlap_for_new_task_suites": 1
  }
}

{
  "project_id": "83859",
  "private_name": "My first pool",
  "private_comment": "This is my first pool",
  "public_description": "Pool's description ",
  "may_contain_adult_content": false,
  "will_expire": "2030-09-01T13:00",
  "reward_per_assignment": 2,
  "dynamic_pricing_config": {
    "type": "SKILL",
    "skill_id": "1289",
    "intervals": [
      {
        "from": 0,
        "to": 60,
        "reward_per_assignment": 3
      },
      {
        "from": 61,
        "to": 100,
        "reward_per_assignment": 4
      }
    ]
  },
  "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": {
    "and": [
      {
        "category": "skill",
        "key": "1124",
        "operator": "GT",
        "value": 59.7
      }
    ]
  },
  "quality_control": {
    "training_requirement": {
      "training_pool_id": "21",
      "training_passing_skill_value": 70
    },
    "captcha_frequency": "LOW",
    "configs": [
      {
        "collector_config": {
          "type": "ANSWER_COUNT"
        },
        "rules": [
          {
            "conditions": [
              {
                "key": "assignments_accepted_count",
                "operator": "GTE",
                "value": 12
              }
            ],
            "action": {
              "type": "RESTRICTION_V2",
              "parameters": {
                "scope": "POOL",
                "duration_unit": "DAYS",
                "duration": 10,
                "private_comment": "Completed 12 pages of tasks in the pool"
              }
            }
          }
        ]
      }
    ],
    "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

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

private_comment

string

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

public_description

string

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

public_instructions

string

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

may_contain_adult_content

boolean

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

will_expire*

string

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

auto_close_after_complete_delay_seconds

integer

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

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

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

reward_per_assignment*

float

Плата за страницу заданий в рублях. Для копеек используйте точку («.») в качестве разделителя. Минимальная плата составляет 0,5 ₽.

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

dynamic_pricing_config

object

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

assignment_max_duration_seconds*

integer

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

Рекомендуется выделять на страницу заданий не менее 60 секунд (с учетом времени на загрузку страницы, отправку ответов). Минимум — 5, максимум — 2 147 483 647 секунд.

auto_accept_solutions

boolean

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

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

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

auto_accept_period_day

integer

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

assignments_issuing_config

object

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

filter

object

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

quality_control

object

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

mixer_config

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

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

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

Подробнее о формировании страниц заданий см. в разделе Создание пула. Полный список параметров приведен в таблице Настройки «умного смешивания».

dynamic_overlap_config

object

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

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

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

training_config

object

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

defaults*

object

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

training

boolean

Используется ли пул в качестве обучения.

priority

integer

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

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

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

speed_quality_balance

object

Соотношение скорости и качества. Полный список параметров приведен в таблице Соотношение скорости и качества.

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

Параметр

Описание

type

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

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

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

skill_id

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

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

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

intervals[]

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

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

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

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

Максимальное количество элементов в массиве 10 000.

intervals[].from

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

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

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

intervals[].to

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

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

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

intervals[].reward_per_assignment

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

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

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

Настройки выдачи заданий ('assignments_issuing_config')

Параметр

Описание

issue_task_suites_in_creation_order

boolean

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

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

Настройки блоков контроля качества ('quality_control')

Параметр

Описание

captcha_frequency

string

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

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

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

checkpoints_config

object

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

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

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

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

configs

object

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

training_requirement

object

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

Выборочная проверка заданий ('quality_control.checkpoints_config')

Параметр

Описание

golden_settings

object

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

real_settings

object

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

training_settings

object

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

Выборочная проверка контрольных заданий ('quality_control.checkpoints_config.golden_settings')

Параметр

Описание

target_overlap

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

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

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

Минимальное значение: 1.

task_distribution_function

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

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

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

Распределение контрольных заданий с выборочной проверкой ('quality_control.checkpoints_config.golden_settings.task_distribution_function')

Параметр

Описание

scope

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

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

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

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

distribution

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

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

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

window_days

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

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

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

intervals[]

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

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

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

Максимальное количество элементов в массиве 10 000. Подробнее про интервалы

intervals[].from

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 0.

intervals[].to

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 100.

intervals[].frequency

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

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

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

Может принимать значения от 0 до 10 000 000.

Выборочная проверка обычных заданий ('quality_control.checkpoints_config.real_settings')

Параметр

Описание

target_overlap

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

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

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

Минимальное значение: 1.

task_distribution_function

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

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

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

Распределение заданий с выборочной проверкой ('quality_control.checkpoints_config.real_settings.task_distribution_function')

Параметр

Описание

scope

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

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

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

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

distribution

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

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

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

window_days

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

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

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

intervals[]

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

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

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

Максимальное количество элементов в массиве 10 000. Подробнее про интервалы

intervals[].from

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 0.

intervals[].to

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 100.

intervals[].frequency

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

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

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

Может принимать значения от 0 до 10 000 000.

Выборочная проверка обучающих заданий ('quality_control.checkpoints_config.training_settings')

Параметр

Описание

target_overlap

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

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

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

Минимальное значение: 1.

task_distribution_function

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

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

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

Распределение обучающих заданий ('quality_control.checkpoints_config.training_settings.task_distribution_function')

Параметр

Описание

scope

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

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

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

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

distribution

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

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

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

window_days

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

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

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

intervals[]

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

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

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

Максимальное количество элементов в массиве 10 000. Подробнее про интервалы

intervals[].from

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 0.

intervals[].to

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 100.

intervals[].frequency

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

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

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

Может принимать значения от 0 до 10 000 000.

Параметры привязанного обучающего пула ('quality_control.training_requirement')

Параметр

Описание

training_pool_id

string

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

training_passing_skill_value

integer

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

Настройки «умного смешивания» ('mixer_config')

Параметр

Описание

real_tasks_count

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

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

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

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

golden_tasks_count

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

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

Количество контрольных заданий на странице. Может принимать значения от 0 до 500.

training_tasks_count

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

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

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

min_real_tasks_count

float

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

min_golden_tasks_count

integer

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

min_training_tasks_count

integer

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

force_last_assignment

boolean

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

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

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

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

force_last_assignment_delay_seconds

integer

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

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

mix_tasks_in_creation_order

boolean

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

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

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

shuffle_tasks_in_task_suite

boolean

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

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

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

golden_task_distribution_function

object

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

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

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

Пример

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

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

training_task_distribution_function

object

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

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

Пример

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

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

Распределение контрольных заданий ('mixer_config.golden_task_distribution_function')

Параметр

Описание

scope

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

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

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

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

distribution

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

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

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

window_days

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

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

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

intervals[]

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

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

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

Максимальное количество элементов в массиве 10 000. Подробнее про интервалы

intervals[].from

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 0.

intervals[].to

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 100.

intervals[].frequency

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

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

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

Может принимать значения от 0 до 10 000 000.

Распределение обучающих заданий ('mixer_config.training_task_distribution_function')

Параметр

Описание

scope

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

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

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

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

distribution

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

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

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

window_days

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

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

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

intervals[]

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

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

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

Максимальное количество элементов в массиве 10 000. Подробнее про интервалы

intervals[].from

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 0.

intervals[].to

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

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

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

Может принимать значения от 0 до 1 000 000. По умолчанию 100.

intervals[].frequency

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

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

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

Может принимать значения от 0 до 10 000 000.

Настройки динамического перекрытия ('dynamic_overlap_config')

Параметр

Описание

type

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

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

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

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

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

max_overlap

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

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

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

min_confidence

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

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

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

answer_weight_skill_id

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

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

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

fields[]

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

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

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

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

fields[].name

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

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

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

Настройки связанного обучения ('training_config')

Параметр

Описание

training_skill_ttl_days

integer

Время действия навыка в днях.

Настройки загрузки по умолчанию ('defaults')

Параметр

Описание

default_overlap_for_new_task_suites*

integer

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

default_overlap_for_new_tasks

integer

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

Соотношение скорости и качества ('speed_quality_balance')

Параметр

Описание

type

string

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

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

percent

integer

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

count

integer

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

Ответ

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

Пример ответа
{
  "id": "32267581",
  "project_id": "81776",
  "private_name": "Transcript of audio recordings",
  "may_contain_adult_content": true,
  "will_expire": "2023-03-09T00:00:00",
  "auto_close_after_complete_delay_seconds": 0,
  "reward_per_assignment": 7,
  "metadata": {},
  "assignment_max_duration_seconds": 600,
  "auto_accept_solutions": true,
  "auto_accept_period_day": 21,
  "assignments_issuing_config": {
    "issue_task_suites_in_creation_order": false
  },
  "filter": {
    "and": [
      {
        "or": [
          {
            "category": "profile",
            "key": "languages",
            "operator": "IN",
            "value": "EN"
          }
        ]
      }
    ]
  },
  "quality_control": {
    "configs": [
      {
        "collector_config": {
          "type": "ASSIGNMENT_SUBMIT_TIME",
          "uuid": "38830d4b-930b-43ab-a98f-f52e992fd11a",
          "parameters": {
            "fast_submit_threshold_seconds": 15
          }
        },
        "rules": [
          {
            "conditions": [
              {
                "key": "fast_submitted_count",
                "operator": "GTE",
                "value": 2
              }
            ],
            "action": {
              "type": "RESTRICTION_V2",
              "parameters": {
                "scope": "PROJECT",
                "duration_unit": "PERMANENT"
              }
            }
          }
        ]
      }
    ]
  },
  "defaults": {
    "default_overlap_for_new_task_suites": 3
  },
  "priority": 0,
  "owner": {
    "id": "6c6e20dc86cca2ae787afcb2629de162",
    "myself": true
  },
  "type": "REGULAR",
  "status": "OPEN",
  "created": "2022-03-10T07:41:53.626",
  "speed_quality_balance": {
    "percent": 100,
    "type": "TOP_PERCENTAGE_BY_QUALITY"
  }
}

Параметр

Описание

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 — обычный пул.

Обязательный параметр

Предыдущая
Получить список пулов
Следующая
Получить сведения о пуле