Создать обучение
Важно
Домен toloka.yandex.com
работает в режиме deprecated. Рекомендуем переключиться на домен toloka.dev
для запросов API.
Создает обучающий пул (обучение).
Созданному обучению автоматически присваивается идентификатор.
Ограничение
Вы можете отправить не более 20 таких запросов в минуту и не более 100 в день.
Примечание
О создании обычного пула читайте в разделе Создать пул.
Запрос
POST https://toloka.dev/api/v1/trainings
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
POST https://sandbox.toloka.dev/api/v1/trainings
Authorization: OAuth <OAuth token>
Content-Type: application/JSON
Заголовки
Заголовок | Описание |
---|---|
Authorization | Токен для авторизации аккаунта. В качестве префикса добавьте OAuth. |
Content-Type | Указывает формат данных в передаваемом теле запроса. |
Тело запроса
{
"project_id": "654321",
"private_name": "Selection for a labeling task",
"inherited_instructions": false,
"public_instructions": "Unpaid selection for a project: 10 tasks, 90% threshold.",
"may_contain_adult_content": false,
"assignment_max_duration_seconds": 600,
"mix_tasks_in_creation_order": true,
"shuffle_tasks_in_task_suite": true,
"training_tasks_in_task_suite_count": 10,
"task_suites_required_to_pass": 1,
"retry_training_after_days": 7
}
Параметр |
Описание |
project_id |
string | обязательный Идентификатор проекта, для которого создан обучающий пул. |
private_name |
string | обязательный Название обучающего пула (доступно только заказчику). |
inherited_instructions |
boolean | обязательный Указывает, использовать ли инструкцию проекта. Если для обучения нужна своя инструкция, то укажите ее в По умолчанию значение |
may_contain_adult_content |
boolean | обязательный Присутствие контента для взрослых в заданиях. |
training_tasks_in_task_ suite_count |
integer | обязательный Количество обучающих заданий на одной странице. |
task_suites_required_to_ pass |
integer Количество страниц, которые нужно успешно выполнить для назначения навыка и допуска к боевым заданиям. |
public_instructions |
string Инструкция по выполнению обучающих заданий. Можно использовать любую HTML-разметку. |
assignment_max_duration_ seconds |
integer Время на выполнение страницы заданий в секундах. Рекомендуется выделять на страницу заданий не менее 60 секунд (с учетом времени на загрузку страницы и отправку ответов). |
mix_tasks_in_creation_ order |
boolean Выдаются ли обучающие задания в порядке загрузки:
|
shuffle_tasks_in_task_suite |
boolean Перемешиваются ли обучающие задания внутри каждой страницы:
По умолчанию значение |
retry_training_after_days |
integer Через сколько дней станет доступно повторное прохождение. |
Ответ
Содержит сведения о созданном обучении.
{
"id": "123456",
"project_id": "654321",
"private_name": "Selection for a labeling task",
"inherited_instructions": false,
"public_instructions": "Unpaid selection for a project: 10 tasks, 90% threshold.",
"may_contain_adult_content": false,
"assignment_max_duration_seconds": 600,
"mix_tasks_in_creation_order": true,
"shuffle_tasks_in_task_suite": true,
"training_tasks_in_task_suite_count": 10,
"task_suites_required_to_pass": 1,
"retry_training_after_days": 7,
"owner": {
"id": "ec00d2407f7241258d0faba610110d95",
"myself": true
},
"status": "CLOSED",
"created": "2021-02-24T18:12:57.962"
}
Помимо параметров, которые задаются при создании обучающего пула, включает параметры, которые присваиваются пулу автоматически:
Параметр |
Описание |
id |
string Идентификатор обучающего пула. |
owner.id |
string Идентификатор заказчика. |
owner.myself |
boolean Проверяет, кому принадлежит объект:
|
status |
string Статус обучающего пула:
|
created |
string Дата и время создания обучающего пула по UTC в формате ISO 8601: |