Spec-Zone.ru › AWS CLI v2

[ aws . personalize-runtime ]

get-personalized-ranking

Описание

Переупорядочивает список рекомендуемых элементов для данного пользователя. Первый элемент в списке считается наиболее вероятным элементом, представляющим интерес для пользователя.

Примечание

Решение, поддерживающее кампанию, должно было быть создано с помощью рецепта типа PERSONALIZED_RANKING.

См. также: Документацию API AWS

Синтаксис

  get-personalized-ranking
--campaign-arn <value>
--input-list <value>
--user-id <value>
[--context <value>]
[--filter-arn <value>]
[--filter-values <value>]
[--metadata-columns <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]

Параметры

--campaign-arn (строка)

Amazon Resource Name (ARN) кампании, используемой для генерации персонализированного рейтинга.

--input-list (список)

Список элементов (по itemId ) для ранжирования. Если элемент не был включен в обучающую выборку, он добавляется в конец переупорядоченного списка. Если вы включаете метаданные в рекомендации, максимальное количество составляет 50. В противном случае максимальное количество составляет 500.

(строка)

Синтаксис:

"string" "string" ...

--user-id (строка)

Пользователь, для которого вы хотите, чтобы кампания предоставила персонализированный рейтинг.

--context (словарь)

Контекстные метаданные, которые следует использовать при получении рекомендаций. Контекстные метаданные включают любую информацию об взаимодействии, которая может быть важной при получении рекомендаций пользователя, например, текущее местоположение или тип устройства пользователя.

ключ -> (строка)

значение -> (строка)

Сокращенный синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--filter-arn (строка)

Amazon Resource Name (ARN) фильтра, созданного для включения или исключения элементов из рекомендаций для данного пользователя. Дополнительную информацию см. в разделе Фильтрование рекомендаций .

--filter-values (словарь)

Значения, используемые при фильтрации рекомендаций. Для каждого параметра-заполнителя в вашем выражении фильтра укажите имя параметра (с совпадающим регистром) в качестве ключа и значения фильтра в качестве соответствующего значения. Разделяйте несколько значений для одного параметра запятыми.

Для выражений фильтров, использующих элемент INCLUDE для включения элементов, вы должны предоставить значения для всех параметров, определенных в выражении. Для фильтров с выражениями, использующими элемент EXCLUDE для исключения элементов, вы можете опустить filter-values . В этом случае Amazon Personalize не использует эту часть выражения для фильтрации рекомендаций.

Дополнительную информацию см. в разделе Фильтрование рекомендаций .

ключ -> (строка)

значение -> (строка)

Сокращенный синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--metadata-columns (словарь)

Если вы включили метаданные в рекомендации при создании или обновлении кампании, укажите столбцы метаданных из набора данных элементов, которые следует включить в персонализированный рейтинг. Ключ словаря — ITEMS, а значение — список имен столбцов из вашего набора данных элементов. Максимальное количество столбцов, которые вы можете предоставить, равно 10.

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

ключ -> (строка)

значение -> (список)

(строка)

Сокращенный синтаксис:

KeyName1=string,string,KeyName2=string,string

Синтаксис JSON:

{"string": ["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.

Вывод

personalizedRanking -> (список)

Список элементов в порядке убывания вероятности интереса для пользователя. Максимальное количество — 500.

(структура)

Объект, определяющий элемент.

API возвращают список PredictedItem.

itemId -> (строка)

Идентификатор рекомендованного элемента.

score -> (двойное)

Числовое представление уверенности модели в том, что элемент будет следующим выбором пользователя. Дополнительную информацию о логике оценки см. в разделе как-работают-оценки .

promotionName -> (строка)

Имя акции, включающей предсказанный элемент.

metadata -> (словарь)

Метаданные об элементе из вашего набора данных элементов.

ключ -> (строка)

значение -> (строка)

reason -> (список)

Если вы используете User-Personalization-v2, список причин включения элемента в рекомендации. Возможные причины включают:

  • Промо-элемент — указывает, что элемент был включен как часть акции, которую вы применили в запросе рекомендации.
  • Исследование — указывает, что элемент был включен в рамках исследования. При исследовании рекомендации включают элементы с меньшим количеством данных об взаимодействиях или релевантностью для пользователя. Дополнительную информацию об исследовании см. в разделе Исследование.
  • Популярный элемент — указывает, что элемент был включен в качестве заглушки популярного элемента. Если вы используете фильтр, в зависимости от того, сколько рекомендаций фильтр удаляет, Amazon Personalize может добавить заглушки популярных элементов, чтобы удовлетворить numResults вашего запроса рекомендаций. Эти элементы являются популярными элементами, основанными на данных об взаимодействиях, которые удовлетворяют вашим критериям фильтрации. Они не имеют оценки релевантности для пользователя.

(строка)

recommendationId -> (строка)

Идентификатор рекомендации.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API