Страницы заданий
Страница заданий — это задания, размещенные на одной веб-странице. Чтобы создать страницу заданий, в Толоку нужно загрузить JSON, который содержит:
входные данные заданий (например, текст, URL картинок);
правильные ответы (для контрольных заданий);
подсказки (для тренировочных заданий);
параметры распределения заданий.
Пример страницы заданий в формате JSON и описание ключей представлены ниже.
Вы можете выполнять следующие операции со страницей заданий с помощью API:
Пример страницы заданий в JSON
{
"id": "63614047-38c3-4ad4-8a86-99c5c651a9b8",
"pool_id": "1",
"tasks": [
{"id": "49a333ea-2728-4c1c-ab1f-8ab1bfe4ee7e",
"origin_task_id": "e3da7fe1-828d-4d9c-b49d-42c0eb5fcfde",
"input_values": {
"image_url": "www.image1.ru"
},
"known_solutions": [
{
"correctness_weight": 0.95,
"output_values": {
"colour": "black"
}
},
{
"correctness_weight": 0.7,
"output_values": {
"colour": "gray"
}
}
],
"message_on_unknown_solution": "Слон черный"
},
{
"input_values": {
"image_url": "www.image2.ru"
},
"known_solutions": [
{
"correctness_weight": 1,
"output_values": {
"colour": "white"
}
}
],
"message_on_unknown_solution": "Слон белый"
}
],
"overlap": 5,
"infinite_overlap": false,
"remaining_overlap": 3,
"reserved_for": [],
"unavailable_for": [],
"issuing_order_override": 3,
"mixed": true,
"automerged": false,
"created": "2016-04-18T12:43:04.988"
}
Ключи
Ключ | Значение | Тип данных | Обязательный при создании |
---|---|---|---|
| Идентификатор страницы заданий. | Строка | Не используется |
| Идентификатор пула, в который загружаются задания. | Строка | Да |
| Данные заданий. | Массив | Да |
| Идентификатор задания, если страница сформирована автоматически с помощью опции «умное смешивание» (см. подробнее в документе Толока. Руководство заказчика). | Строка | Не используется |
| Идентификатор задания из другого пула, с которого было скопировано это задание, для проверки мнением большинства. | Строка | Не используется |
| Входные данные для задания. Список пар: | JSON | Да |
| Ответы и подсказки для контрольных и тренировочных заданий. | JSON | Нет |
| Правильные ответы в задании (для контрольных заданий). Если есть несколько правильных вариантов ответа, для каждого варианта нужно определить | JSON | Нет |
| Вес правильного ответа. Позволяет задать несколько вариантов правильных ответов и ранжировать их по правильности. Например, при весе правильного ответа 0.5 пользователю засчитывается половина ошибки. Чем правильнее ответ в | Число с плавающей точкой | Нет |
| Подсказка к заданию (для тренировочных заданий). | Строка | Нет |
| Перекрытие страницы заданий. | Число | Нет, если при создании страницы заданий используется параметр и перекрытие указано в параметрах пула (ключ defaults.default_overlap_for_new_task_suites). |
| Выдача страницы заданий с бесконечным перекрытием. Используется, например, для страниц обучающих заданий, чтобы выдать их всем пользователям:
По умолчанию значение | Булев | Нет |
| Оставшееся перекрытие для каждого задания. Например, если для задания установлено перекрытие Если задание ожидает приемки или активно, ключ принимает значение | Число | Не используется |
| Идентификаторы пользователей, которым будет доступна страница. | Массив | Нет |
| Идентификаторы пользователей, для которых страница должна быть недоступна. | Массив | Нет |
| Приоритет страницы заданий среди других страниц в пуле. Определяет порядок выдачи страниц исполнителям. Чем больше значение параметра, тем выше приоритет. Параметр можно использовать, если в пуле Возможные значения: от По умолчанию значение | Число с плавающей точкой | Нет |
| Долгота точки на карте для страницы заданий. | Число с плавающей точкой | Да, если задания выбираются на карте. Иначе не используется. |
| Широта точки на карте для страницы заданий. | Число с плавающей точкой | Да, если задания выбираются на карте. Иначе не используется. |
| Способ создания страницы заданий:
| Булев | Нет |
| Флаг страницы заданий, созданной после слияния заданий. Значение:
| Булев | Не используется |
| Дата и время создания страницы заданий по UTC в формате ISO 8601 YYYY-MM-DDThh:mm:ss[.sss]. | Строка | Не используется |
Ключ | Значение | Тип данных | Обязательный при создании |
---|---|---|---|
| Идентификатор страницы заданий. | Строка | Не используется |
| Идентификатор пула, в который загружаются задания. | Строка | Да |
| Данные заданий. | Массив | Да |
| Идентификатор задания, если страница сформирована автоматически с помощью опции «умное смешивание» (см. подробнее в документе Толока. Руководство заказчика). | Строка | Не используется |
| Идентификатор задания из другого пула, с которого было скопировано это задание, для проверки мнением большинства. | Строка | Не используется |
| Входные данные для задания. Список пар: | JSON | Да |
| Ответы и подсказки для контрольных и тренировочных заданий. | JSON | Нет |
| Правильные ответы в задании (для контрольных заданий). Если есть несколько правильных вариантов ответа, для каждого варианта нужно определить | JSON | Нет |
| Вес правильного ответа. Позволяет задать несколько вариантов правильных ответов и ранжировать их по правильности. Например, при весе правильного ответа 0.5 пользователю засчитывается половина ошибки. Чем правильнее ответ в | Число с плавающей точкой | Нет |
| Подсказка к заданию (для тренировочных заданий). | Строка | Нет |
| Перекрытие страницы заданий. | Число | Нет, если при создании страницы заданий используется параметр и перекрытие указано в параметрах пула (ключ defaults.default_overlap_for_new_task_suites). |
| Выдача страницы заданий с бесконечным перекрытием. Используется, например, для страниц обучающих заданий, чтобы выдать их всем пользователям:
По умолчанию значение | Булев | Нет |
| Оставшееся перекрытие для каждого задания. Например, если для задания установлено перекрытие Если задание ожидает приемки или активно, ключ принимает значение | Число | Не используется |
| Идентификаторы пользователей, которым будет доступна страница. | Массив | Нет |
| Идентификаторы пользователей, для которых страница должна быть недоступна. | Массив | Нет |
| Приоритет страницы заданий среди других страниц в пуле. Определяет порядок выдачи страниц исполнителям. Чем больше значение параметра, тем выше приоритет. Параметр можно использовать, если в пуле Возможные значения: от По умолчанию значение | Число с плавающей точкой | Нет |
| Долгота точки на карте для страницы заданий. | Число с плавающей точкой | Да, если задания выбираются на карте. Иначе не используется. |
| Широта точки на карте для страницы заданий. | Число с плавающей точкой | Да, если задания выбираются на карте. Иначе не используется. |
| Способ создания страницы заданий:
| Булев | Нет |
| Флаг страницы заданий, созданной после слияния заданий. Значение:
| Булев | Не используется |
| Дата и время создания страницы заданий по UTC в формате ISO 8601 YYYY-MM-DDThh:mm:ss[.sss]. | Строка | Не используется |