create-hit
Описание
Операция CreateHIT создает новую задачу человеческого интеллекта (HIT). Новая HIT становится доступной Работникам для поиска и принятия на сайте Amazon Mechanical Turk.
Эта операция позволяет вам указать новую HIT, передав значения для свойств HIT, таких как её название, вознаграждение и количество заданий. Когда вы передаёте эти значения в CreateHIT, для вас создаётся новая HIT с новым HITTypeID. HITTypeID можно использовать для создания дополнительных HIT в будущем, не указывая общие параметры, такие как заголовок, описание и вознаграждение каждый раз.
Альтернативный способ создания HIT — сначала сгенерировать HITTypeID с помощью операции CreateHITType, а затем вызвать операцию CreateHITWithHITType. Это рекомендуемая лучшая практика для Заказчиков, создающих большое количество HIT.
CreateHIT также поддерживает несколько способов предоставления данных вопроса: путём указания значения параметра Question, который полностью определяет содержимое HIT, или путём предоставления HitLayoutId и связанного HitLayoutParameters.
Примечание
Если HIT создаётся с 10 или более максимальными заданиями, взимается дополнительная плата. Для получения дополнительной информации см. Цены Amazon Mechanical Turk.См. также: Документация API AWS
Синтаксис
create-hit
[--max-assignments <value>]
[--auto-approval-delay-in-seconds <value>]
--lifetime-in-seconds <value>
--assignment-duration-in-seconds <value>
--reward <value>
--title <value>
[--keywords <value>]
--description <value>
[--question <value>]
[--requester-annotation <value>]
[--qualification-requirements <value>]
[--unique-request-token <value>]
[--assignment-review-policy <value>]
[--hit-review-policy <value>]
[--hit-layout-id <value>]
[--hit-layout-parameters <value>]
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--max-assignments (целое число)
--auto-approval-delay-in-seconds (длинное целое число)
--lifetime-in-seconds (длинное целое число)
--assignment-duration-in-seconds (длинное целое число)
--reward (строка)
--title (строка)
--keywords (строка)
--description (строка)
--question (строка)
Данные, которые использует человек, выполняющий HIT, для получения результатов.
Ограничения: Должен быть структурой данных QuestionForm, структурой данных ExternalQuestion или структурой данных HTMLQuestion. Данные вопроса XML не должны превышать 64 килобайта (65 535 байт) в размере, включая пробелы.
Должен быть предоставлен либо параметр Question, либо параметр HITLayoutId.
--requester-annotation (строка)
Произвольное поле данных. Параметр RequesterAnnotation позволяет вашему приложению прикрепить произвольные данные к HIT для отслеживания. Например, этот параметр может быть идентификатором, внутренним для приложения Заказчика, который соответствует HIT.
Параметр RequesterAnnotation для HIT виден только Заказчику, который создал HIT. Он не отображается Работнику или любому другому Заказчику.
Параметр RequesterAnnotation может отличаться для каждого HIT, который вы отправляете. Он не влияет на группировку ваших HIT.
--qualification-requirements (список)
Условия, которым должна соответствовать квалификация Работника, чтобы принять HIT. HIT может иметь от нуля до десяти требований к квалификации. Все требования должны быть выполнены, чтобы Работник мог принять HIT. Кроме того, другие действия могут быть ограничены с помощью поля ActionsGuarded в каждой структуре QualificationRequirement.
(структура)
Структура данных QualificationRequirement описывает квалификацию, которой должен обладать Работник, прежде чем Работник сможет принять HIT. Требование может необязательно указывать, что Работник должен обладать квалификацией, чтобы предварительно просмотреть HIT или увидеть HIT в результатах поиска.
QualificationTypeId -> (строка)
Comparator -> (строка)
IntegerValues -> (список)
Целое значение для сравнения со значением квалификации. IntegerValue не должен присутствовать, если Comparator равен Exists или DoesNotExist. IntegerValue может использоваться только в том случае, если тип квалификации имеет целое значение; он не может использоваться с идентификатором типа квалификации Worker_Locale. При выполнении сравнения набора с использованием компаратора In или NotIn вы можете использовать до 15 элементов IntegerValue в структуре QualificationRequirement.
(целое число)
LocaleValues -> (список)
Значение местоположения для сравнения со значением квалификации. Значение местоположения должно быть действительным кодом страны ISO 3166 или поддерживать подразделения ISO 3166-2. LocaleValue может использоваться только с идентификатором типа квалификации Worker_Locale. LocaleValue может использоваться только с компараторами EqualTo, NotEqualTo, In и NotIn. При использовании компараторов EqualTo или NotEqualTo вы можете использовать только один элемент LocaleValue. При выполнении сравнения набора с использованием компараторов In или NotIn вы можете использовать до 30 элементов LocaleValue в структуре QualificationRequirement.
(структура)
Структура данных Locale представляет географический регион или местоположение.
Country -> (строка)
Subdivision -> (строка)
RequiredToPreview -> (булево)
ActionsGuarded вместо него. Если RequiredToPreview имеет значение true, данные вопроса для HIT не будут показаны, когда Работник, чьи квалификации не соответствуют этому требованию, пытается предварительно просмотреть HIT. То есть, квалификации Работника должны соответствовать всем требованиям, для которых RequiredToPreview имеет значение true, чтобы предварительно просмотреть HIT. Если Работник удовлетворяет всем требованиям, где RequiredToPreview имеет значение true (или если таких требований нет), но не удовлетворяет всем требованиям для HIT, Работник сможет предварительно просмотреть данные вопроса HIT, но не сможет принять и выполнить HIT. Значение по умолчанию — false. Это не должно использоваться в сочетании с полем ActionsGuarded.ActionsGuarded -> (строка)
RequiredToPreview.Синтаксис сокращенной записи:
QualificationTypeId=string,Comparator=string,IntegerValues=integer,integer,LocaleValues=[{Country=string,Subdivision=string},{Country=string,Subdivision=string}],RequiredToPreview=boolean,ActionsGuarded=string ...
Синтаксис JSON:
[
{
"QualificationTypeId": "string",
"Comparator": "LessThan"|"LessThanOrEqualTo"|"GreaterThan"|"GreaterThanOrEqualTo"|"EqualTo"|"NotEqualTo"|"Exists"|"DoesNotExist"|"In"|"NotIn",
"IntegerValues": [integer, ...],
"LocaleValues": [
{
"Country": "string",
"Subdivision": "string"
}
...
],
"RequiredToPreview": true|false,
"ActionsGuarded": "Accept"|"PreviewAndAccept"|"DiscoverPreviewAndAccept"
}
...
]
--unique-request-token (строка)
Уникальный идентификатор для этого запроса, который позволяет повторить вызов при ошибке без создания дублирующих HIT. Это полезно в таких случаях, как таймауты сети, где неясно, произошел ли вызов успешно на сервере или нет. Если HIT уже существует в системе из предыдущего вызова с использованием того же UniqueRequestToken, последующие вызовы вернут ошибку AWS.MechanicalTurk.HitAlreadyExists с сообщением, содержащим HITId.
Примечание
Обратите внимание: вы несете ответственность за обеспечение уникальности маркера. Уникальный маркер истекает через 24 часа. Последующие вызовы с использованием того же UniqueRequestToken, сделанные после ограничения в 24 часа, могут создать дублирующиеся HIT.--assignment-review-policy (структура)
Политика обзора на уровне задания применяется к заданиям в рамках HIT. Вы можете указать Mechanical Turk на выполнение различных действий на основе политики.
PolicyName -> (строка)
Parameters -> (список)
Имя параметра из политики обзора.
(структура)
Имя параметра из политики обзора.
Key -> (строка)
Values -> (список)
Список значений параметра
(строка)
MapEntries -> (список)
Список объектов ParameterMapEntry.
(структура)
Эта структура данных является типом данных для параметра AnswerKey политики обзора ScoreMyKnownAnswers/2011-09-01.
Key -> (строка)
Values -> (список)
Список ответов на вопрос, указанный в элементе MapEntry Key. Работник должен сопоставить все значения, чтобы ответ был оценён правильно.
(строка)
Синтаксис JSON:
{
"PolicyName": "string",
"Parameters": [
{
"Key": "string",
"Values": ["string", ...],
"MapEntries": [
{
"Key": "string",
"Values": ["string", ...]
}
...
]
}
...
]
}
--hit-review-policy (структура)
Политика проверки HIT-уровня применяется к заданию HIT. Вы можете указать механизму Mechanical Turk выполнять различные действия на основе политики.
PolicyName -> (строка)
Parameters -> (список)
Имя параметра из политики проверки.
(структура)
Имя параметра из политики проверки.
Key -> (строка)
Values -> (список)
Список значений параметра
(строка)
MapEntries -> (список)
Список объектов ParameterMapEntry.
(структура)
Эта структура данных является типом данных для параметра AnswerKey политики проверки ScoreMyKnownAnswers/2011-09-01.
Key -> (строка)
Values -> (список)
Список ответов на вопрос, указанный в элементе Key MapEntry. Работник должен сопоставить все значения, чтобы ответ был оценен правильно.
(строка)
Синтаксис JSON:
{
"PolicyName": "string",
"Parameters": [
{
"Key": "string",
"Values": ["string", ...],
"MapEntries": [
{
"Key": "string",
"Values": ["string", ...]
}
...
]
}
...
]
}
--hit-layout-id (строка)
HITLayoutId позволяет использовать предварительно созданный макет HIT со значениями-заполнителями и создавать дополнительное задание HIT, предоставляя эти значения как HITLayoutParameters.
Ограничения: должен быть предоставлен либо параметр Question, либо параметр HITLayoutId.
--hit-layout-parameters (список)
Если предоставлен HITLayoutId, любые значения-заполнители должны быть заполнены значениями, используя структуру HITLayoutParameter. Дополнительную информацию см. в разделе HITLayout.
(структура)
Структура данных HITLayoutParameter определяет значения параметров, используемые с HITLayout. HITLayout — это многократно используемая шаблонная проектная структура Amazon Mechanical Turk, которая используется для предоставления данных вопросов для заданий человеческой интуиции (HIT) в CreateHIT.
Name -> (строка)
Value -> (строка)
Сокращенный синтаксис:
Name=string,Value=string ...
Синтаксис JSON:
[
{
"Name": "string",
"Value": "string"
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью предоставленного значения JSON, так как строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса к API. При отсутствии значения или значении input выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, при предоставлении значения yaml-input будет выведен пример входного YAML, который можно использовать с --cli-input-yaml. При предоставлении значения output выполняется проверка входных данных команды и возвращается пример выходного JSON для этой команды. Сгенерированный JSON-каркас не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-каркасе.
Глобальные параметры
--debug (булево)
Включить отладку регистрации.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (булево)
По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (булево)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- текст
- таблица
- yaml
- yaml-поток
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из вашего файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- включено
- выключено
- автоматически
--no-sign-request (булево)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет ограничено по времени. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (целое число)
Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет ограничено по времени. Значение по умолчанию — 60 секунд.
--cli-binary-format (строка)
Стиль форматирования для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как закодированная строка base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного параметра cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (булево)
Отключить кли-пагинатор для вывода.
--cli-auto-prompt (булево)
Автоматически запросить параметры входных данных CLI.
--no-cli-auto-prompt (булево)
Отключить автоматическое запроса параметров входных данных CLI.
Вывод
HIT -> (структура)
Содержит данные только что созданного HIT. Для описания структуры данных HIT в ответах см. документацию по структуре данных HIT.
HITId -> (строка)
HITTypeId -> (строка)
HITGroupId -> (строка)
HITLayoutId -> (строка)
CreationTime -> (метка времени)
Title -> (строка)
Description -> (строка)
Question -> (строка)
Keywords -> (строка)
HITStatus -> (строка)
MaxAssignments -> (целое число)
Reward -> (строка)
AutoApprovalDelayInSeconds -> (целое число большого размера)
Expiration -> (метка времени)
AssignmentDurationInSeconds -> (целое число большого размера)
RequesterAnnotation -> (строка)
QualificationRequirements -> (список)
Условие, которому должны соответствовать квалификации Работника для принятия HIT. HIT может иметь от нуля до десяти требований к квалификации. Все требования должны быть выполнены, чтобы Работник мог принять HIT. Кроме того, другие действия могут быть ограничены с помощью поля ActionsGuarded в каждой структуре QualificationRequirement.
(структура)
Структура QualificationRequirement описывает квалификацию, которой должен обладать Работник, прежде чем Работник сможет принять HIT. Требование может необязательно указать, что Работник должен обладать квалификацией для предварительного просмотра HIT или просмотра HIT в результатах поиска.
QualificationTypeId -> (строка)
Comparator -> (строка)
IntegerValues -> (список)
Целое значение для сравнения со значением квалификации. IntegerValue не должно быть указано, если Comparator — Exists или DoesNotExist. IntegerValue может быть использовано только в том случае, если тип квалификации имеет целочисленное значение; оно не может использоваться с идентификатором типа квалификации Worker_Locale. При выполнении сравнения набора с использованием оператора In или NotIn в структуре QualificationRequirement можно использовать до 15 элементов IntegerValue.
(целое число)
LocaleValues -> (список)
Значение местоположения для сравнения со значением квалификации. Значение местоположения должно быть допустимым кодом страны ISO 3166 или поддерживать подразделения ISO 3166-2. LocaleValue может быть использовано только с идентификатором типа квалификации Worker_Locale. LocaleValue может использоваться только с операторами EqualTo, NotEqualTo, In и NotIn. При использовании операторов EqualTo или NotEqualTo нужно использовать только один элемент LocaleValue. При выполнении сравнения набора с использованием операторов In или NotIn в структуре QualificationRequirement можно использовать до 30 элементов LocaleValue.
(структура)
Структура Locale представляет географический регион или местоположение.
Country -> (строка)
Subdivision -> (строка)
RequiredToPreview -> (логическое значение)
ActionsGuarded вместо этого. Если RequiredToPreview имеет значение true, данные вопроса для HIT не будут отображаться, когда Работник, чьи квалификации не соответствуют этому требованию, пытается предварительно просмотреть HIT. То есть, квалификации Работника должны соответствовать всем требованиям, для которых RequiredToPreview имеет значение true, чтобы предварительно просмотреть HIT. Если Работник соответствует всем требованиям, где RequiredToPreview имеет значение true (или если таких требований нет), но не соответствует всем требованиям для HIT, Работник сможет предварительно просмотреть данные вопроса HIT, но не сможет принять и выполнить HIT. Значение по умолчанию — false. Это не должно использоваться в сочетании с полем ActionsGuarded.ActionsGuarded -> (строка)
RequiredToPreview.HITReviewStatus -> (строка)
NumberOfAssignmentsPending -> (целое число)
NumberOfAssignmentsAvailable -> (целое число)
NumberOfAssignmentsCompleted -> (целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.