Редактировать пул

PUT /pools/{id}

Вносит изменения в пул.

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

В теле запроса укажите все параметры обновляемого пула. Идентификатор пула можно узнать из списка пулов.

Ограничение

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

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

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

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

curl -X PUT 'https://tasks.yandex.ru/api/v1/pools/32267581' \
     -H 'Content-Type: application/json' \
     -H 'Authorization: OAuth PlaceYourRealOAuthToken_Here' \
     -d '{"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"}}'
import requests

url = "https://tasks.yandex.ru/api/v1/pools/32267581"
headers = {
  'Content-Type': 'application/json',
  'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
}
payload = {
  "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"
  }
}
response = requests.put(url, headers=headers, json=payload)

print(response.text)
var request = require('request');
var options = {
  'method': 'PUT',
  'url': 'https://tasks.yandex.ru/api/v1/pools/32267581',
  'qs': {},
  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'OAuth PlaceYourRealOAuthToken_Here'
  },
  'body': JSON.stringify({
    "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"
    }
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Path-параметры

Параметр

Описание

id*

string

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

Заголовки

Заголовок

Описание

Authorization

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

Content-Type

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

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

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

Ответ

Содержит обновленную информацию о пуле в формате JSON.

Пример ответа
{
  "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"
  }
}

Включает:

  • параметры, которые используются при создании пула:

    Параметр

    Описание

    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

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

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