[ aws . personalize ]
create-batch-inference-job
Описание
Генерирует пакетные рекомендации на основе списка элементов или пользователей, хранящихся в Amazon S3, и экспортирует рекомендации в ведро Amazon S3.
Для генерации пакетных рекомендаций укажите ARN версии решения и URI Amazon S3 для входных и выходных данных. Для персонализации пользователей, популярных элементов и решений персонализированного ранжирования пакетная задача вывода генерирует список рекомендуемых элементов для каждого идентификатора пользователя во входном файле. Для решений связанных элементов задача генерирует список рекомендуемых элементов для каждого идентификатора элемента во входном файле.
Дополнительную информацию см. в разделе Создание задачи пакетного вывода .
Если вы используете рецепт Similar-Items, Amazon Personalize может добавить описательные темы к пакетным рекомендациям. Для генерации тем установите режим работы задачи в THEME_GENERATION и укажите имя поля, содержащего имена элементов во входных данных.
Дополнительную информацию о генерации тем см. в разделе Пакетные рекомендации с темами от генератора контента .
Вы не можете получить пакетные рекомендации с рецептами Trending-Now или Next-Best-Action.
См. также: Документация AWS API
Синтаксис
create-batch-inference-job
--job-name <value>
--solution-version-arn <value>
[--filter-arn <value>]
[--num-results <value>]
--job-input <value>
--job-output <value>
--role-arn <value>
[--batch-inference-job-config <value>]
[--tags <value>]
[--batch-inference-job-mode <value>]
[--theme-generation-config <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]
Параметры
--job-name (строка)
--solution-version-arn (строка)
--filter-arn (строка)
--num-results (целое число)
--job-input (структура)
Путь Amazon S3, ведущий к входному файлу, на основе которого будут формироваться рекомендации. Входные данные должны быть в формате JSON.
s3DataSource -> (структура)
URI расположения Amazon S3, содержащего входные данные. Ведро Amazon S3 должно находиться в той же области, что и вызываемый API-точку.
path -> (строка)
kmsKeyArn -> (строка)
Сокращенный синтаксис:
s3DataSource={path=string,kmsKeyArn=string}
Синтаксис JSON:
{
"s3DataSource": {
"path": "string",
"kmsKeyArn": "string"
}
}
--job-output (структура)
Путь к ведру Amazon S3, где будут храниться выходные данные задачи.
s3DataDestination -> (структура)
Информация о ведре Amazon S3, в котором хранятся выходные данные задачи пакетного вывода.
path -> (строка)
kmsKeyArn -> (строка)
Сокращенный синтаксис:
s3DataDestination={path=string,kmsKeyArn=string}
Синтаксис JSON:
{
"s3DataDestination": {
"path": "string",
"kmsKeyArn": "string"
}
}
--role-arn (строка)
--batch-inference-job-config (структура)
Подробные данные конфигурации задачи пакетного вывода.
itemExplorationConfig -> (словарь)
Словарь строка-строка, определяющий параметры гиперпараметров конфигурации исследования, включая explorationWeight и explorationItemAgeCutOff, которые вы хотите использовать для настройки объема исследования элементов Amazon Personalize при рекомендации элементов. См. Персонализация пользователей .
key -> (строка)
value -> (строка)
Сокращенный синтаксис:
itemExplorationConfig={KeyName1=string,KeyName2=string}
Синтаксис JSON:
{
"itemExplorationConfig": {"string": "string"
...}
}
--tags (список)
Список тегов для применения к задаче пакетного вывода.
(структура)
Дополнительные метаданные, которые вы применяете к ресурсам, чтобы помочь в их категоризации и организации. Каждый тег состоит из ключа и необязательного значения, которые вы определяете. Дополнительную информацию см. в разделе Присвоение тегов ресурсам Amazon Personalize .
tagKey -> (строка)
tagValue -> (строка)
Сокращенный синтаксис:
tagKey=string,tagValue=string ...
Синтаксис JSON:
[
{
"tagKey": "string",
"tagValue": "string"
}
...
]
--batch-inference-job-mode (строка)
Режим работы задачи пакетного вывода. Для генерации описательных тем для групп похожих элементов установите режим работы задачи в THEME_GENERATION . Если вы не хотите генерировать темы, используйте значение по умолчанию BATCH_INFERENCE .
При получении пакетных рекомендаций с темами у вас возникнут дополнительные расходы. Дополнительную информацию см. в разделе Цены на Amazon Personalize .
Возможные значения:
BATCH_INFERENCETHEME_GENERATION
--theme-generation-config (структура)
Для задач генерации тем укажите имя столбца в наборе данных «Элементы», который содержит имя каждого элемента.
fieldsForThemeGeneration -> (структура)
Поля, используемые для генерации описательных тем для задачи пакетного вывода.
itemName -> (строка)
Сокращенный синтаксис:
fieldsForThemeGeneration={itemName=string}
Синтаксис JSON:
{
"fieldsForThemeGeneration": {
"itemName": "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
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать конкретный профиль из файла учетных данных.
--region (строка)
Область, которую следует использовать. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить вывод цвета.
- on
- off
- auto
--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.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров ввода CLI.
Вывод
batchInferenceJobArn -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.