Spec-Zone.ru › AWS CLI v2

[ aws . lex-модели ]

create-intent-version

Описание

Создаёт новую версию намерения на основе версии $LATEST намерения. Если версия $LATEST намерения не изменилась с момента последнего обновления, Amazon Lex не создаёт новую версию. Возвращается последняя созданная версия.

Примечание

Вы можете обновить только версию $LATEST намерения. Вы не можете обновить пронумерованные версии, созданные операцией CreateIntentVersion.

При создании версии намерения Amazon Lex устанавливает версию в 1. Последующие версии увеличиваются на 1. Дополнительные сведения см. в разделе versioning-intro .

Для выполнения этой операции требуются разрешения на выполнение действия lex:CreateIntentVersion.

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

Синтаксис

  create-intent-version
--name <value>
[--checksum <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]

Параметры

--name (строка)

Имя намерения, для которого требуется создать новую версию. Имя чувствительно к регистру.

--checksum (строка)

Контрольная сумма версии $LATEST намерения, которая должна использоваться для создания новой версии. Если вы укажете контрольную сумму, а версия $LATEST намерения имеет другую контрольную сумму, Amazon Lex вернёт исключение PreconditionFailedException и не опубликует новую версию. Если контрольная сумма не указана, Amazon Lex публикует версию $LATEST.

--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 для вывода.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы параметров ввода CLI.

Вывод

name -> (строка)

Название интента.

description -> (строка)

Описание интента.

slots -> (список)

Массив типов слотов, определяющих информацию, необходимую для выполнения интента.

(структура)

Идентифицирует версию конкретного слота.

name -> (строка)

Имя слота.

description -> (строка)

Описание слота.

slotConstraint -> (строка)

Указывает, является ли слот обязательным или необязательным.

slotType -> (строка)

Тип слота, либо пользовательский тип слота, который вы определили, либо один из встроенных типов слотов.

slotTypeVersion -> (строка)

Версия типа слота.

valueElicitationPrompt -> (структура)

Подсказка, которую Amazon Lex использует для получения значения слота от пользователя.

messages -> (список)

Массив объектов, каждый из которых содержит строку сообщения и его тип. Вы можете указать строку сообщения в обычном тексте или в формате Speech Synthesis Markup Language (SSML).

(структура)

Объект сообщения, содержащий текст сообщения и его тип.

contentType -> (строка)

Тип содержимого строки сообщения.

content -> (строка)

Текст сообщения.

groupNumber -> (целое число)

Идентифицирует группу сообщений, к которой принадлежит сообщение. Если сообщению назначена группа, Amazon Lex возвращает одно сообщение из каждой группы в ответе.

maxAttempts -> (целое число)

Количество попыток запроса информации у пользователя.

responseCard -> (строка)

Карта ответа. Amazon Lex использует этот запрос во время выполнения в ответе API. Он подставляет атрибуты сеанса и значения слотов в заполнители в карте ответа. Дополнительную информацию см. в ex-resp-card.

priority -> (целое число)

Указывает Amazon Lex порядок извлечения значения этого слота от пользователя. Например, если у интента два слота с приоритетами 1 и 2, AWS Amazon Lex сначала извлекает значение для слота с приоритетом 1.

Если несколько слотов имеют одинаковый приоритет, порядок, в котором Amazon Lex извлекает значения, является произвольным.

sampleUtterances -> (список)

Если вы знаете определённый шаблон, в котором пользователи могут отвечать на запрос Amazon Lex о значении слота, вы можете предоставить эти высказывания для повышения точности. Это необязательно. В большинстве случаев Amazon Lex способен понимать высказывания пользователей.

(строка)

responseCard -> (строка)

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

obfuscationSetting -> (строка)

Определяет, замаскирован ли слот в журналах разговоров и сохранённых высказываниях. При маскировке слота значение заменяется именем слота в фигурных скобках ({}). Например, если имя слота — «full_name», замаскированные значения заменяются на «{full_name}». Дополнительную информацию см. в разделе Маскировка слотов.

defaultValueSpec -> (структура)

Список значений по умолчанию для слота. Значения по умолчанию используются, когда Amazon Lex не определил значение для слота. Вы можете указать значения по умолчанию из переменных контекста, атрибутов сеанса и определённых значений.

defaultValueList -> (список)

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

Выбранное значение по умолчанию выбирается в порядке, в котором вы их указываете в списке. Например, если вы указываете переменную контекста и фиксированное значение в этом порядке, Amazon Lex использует переменную контекста, если она доступна, в противном случае используется фиксированное значение.

(структура)

Значение по умолчанию для слота.

defaultValue -> (строка)

Значение по умолчанию для слота. Вы можете указать одно из следующих:

  • #context-name.slot-name - значение слота «slot-name» в контексте «context-name».
  • {attribute} - значение слота атрибута сеанса «attribute».
  • 'value' - дискретное значение «value».

sampleUtterances -> (список)

Массив образцов высказываний, настроенных для интента.

(строка)

confirmationPrompt -> (структура)

Если определено, подсказка, которую Amazon Lex использует для подтверждения намерения пользователя перед его выполнением.

messages -> (список)

Массив объектов, каждый из которых содержит строку сообщения и его тип. Вы можете указать строку сообщения в обычном тексте или в формате Speech Synthesis Markup Language (SSML).

(структура)

Объект сообщения, содержащий текст сообщения и его тип.

contentType -> (строка)

Тип содержимого строки сообщения.

content -> (строка)

Текст сообщения.

groupNumber -> (целое число)

Идентифицирует группу сообщений, к которой принадлежит сообщение. Если сообщению назначена группа, Amazon Lex возвращает одно сообщение из каждой группы в ответе.

maxAttempts -> (целое число)

Количество попыток запроса информации у пользователя.

responseCard -> (строка)

Карта ответа. Amazon Lex использует этот запрос во время выполнения в ответе API. Он подставляет атрибуты сеанса и значения слотов в заполнители в карте ответа. Дополнительную информацию см. в ex-resp-card.

rejectionStatement -> (структура)

Если пользователь ответит «нет» на вопрос, определённый в confirmationPrompt, Amazon Lex ответит этим утверждением, чтобы подтвердить отмену интента.

messages -> (список)

Коллекция объектов сообщения.

(структура)

Объект сообщения, содержащий текст сообщения и его тип.

contentType -> (строка)

Тип содержимого строки сообщения.

content -> (строка)

Текст сообщения.

groupNumber -> (целое число)

Идентифицирует группу сообщений, к которой принадлежит сообщение. Если сообщению назначена группа, Amazon Lex возвращает одно сообщение из каждой группы в ответе.

responseCard -> (строка)

Во время выполнения, если клиент использует API PostText, Amazon Lex включает карту ответа в ответ. Он подставляет все атрибуты сеанса и значения слотов в заполнители в карте ответа.

followUpPrompt -> (структура)

Если определено, Amazon Lex использует этот запрос, чтобы запросить дополнительную активность пользователя после выполнения интента.

prompt -> (структура)

Запрос информации у пользователя.

messages -> (список)

Массив объектов, каждый из которых содержит строку сообщения и его тип. Вы можете указать строку сообщения в обычном тексте или в формате Speech Synthesis Markup Language (SSML).

(структура)

Объект сообщения, содержащий текст сообщения и его тип.

contentType -> (строка)

Тип содержимого строки сообщения.

content -> (строка)

Текст сообщения.

groupNumber -> (целое число)

Идентифицирует группу сообщений, к которой принадлежит сообщение. Если сообщению назначена группа, Amazon Lex возвращает одно сообщение из каждой группы в ответе.

maxAttempts -> (целое число)

Количество попыток запроса информации у пользователя.

responseCard -> (строка)

Карта ответа. Amazon Lex использует этот запрос во время выполнения в ответе API. Он подставляет атрибуты сеанса и значения слотов в заполнители в карте ответа. Дополнительную информацию см. в ex-resp-card.

rejectionStatement -> (структура)

Если пользователь ответит «нет» на вопрос, определённый в поле prompt, Amazon Lex ответит этим утверждением, чтобы подтвердить отмену интента.

messages -> (список)

Коллекция объектов сообщения.

(структура)

Объект сообщения, содержащий текст сообщения и его тип.

contentType -> (строка)

Тип содержимого строки сообщения.

content -> (строка)

Текст сообщения.

groupNumber -> (целое число)

Идентифицирует группу сообщений, к которой принадлежит сообщение. Если сообщению назначена группа, Amazon Lex возвращает одно сообщение из каждой группы в ответе.

responseCard -> (строка)

Во время выполнения, если клиент использует API PostText, Amazon Lex включает карту ответа в ответ. Он подставляет все атрибуты сеанса и значения слотов в заполнители в карте ответа.

conclusionStatement -> (структура)

После того, как функция Lambda, указанная в поле fulfillmentActivity, выполнит интент, Amazon Lex передаёт это утверждение пользователю.

messages -> (список)

Коллекция объектов сообщения.

(структура)

Объект сообщения, содержащий текст сообщения и его тип.

contentType -> (строка)

Тип содержимого строки сообщения.

content -> (строка)

Текст сообщения.

groupNumber -> (целое число)

Идентифицирует группу сообщений, к которой принадлежит сообщение. Если сообщению назначена группа, Amazon Lex возвращает одно сообщение из каждой группы в ответе.

responseCard -> (строка)

Во время выполнения, если клиент использует API PostText, Amazon Lex включает карту ответа в ответ. Он подставляет все атрибуты сеанса и значения слотов в заполнители в карте ответа.

dialogCodeHook -> (структура)

Если определено, Amazon Lex вызывает эту функцию Lambda для каждого ввода пользователя.

uri -> (строка)

Amazon Resource Name (ARN) функции Lambda.

messageVersion -> (строка)

Версия запроса-ответа, которую вы хотите использовать Amazon Lex для вызова вашей функции Lambda. Дополнительную информацию см. в using-lambda.

fulfillmentActivity -> (структура)

Описание того, как выполняется интент.

type -> (строка)

Как должен быть выполнен интент, либо путём выполнения функции Lambda, либо путём возврата данных слота к приложению-клиенту.

codeHook -> (структура)

Описание функции Lambda, которая выполняется для выполнения интента.

uri -> (строка)

Amazon Resource Name (ARN) функции Lambda.

messageVersion -> (строка)

Версия запроса-ответа, которую вы хотите использовать Amazon Lex для вызова вашей функции Lambda. Дополнительную информацию см. в using-lambda.

parentIntentSignature -> (строка)

Уникальный идентификатор для встроенного интента.

lastUpdatedDate -> (временная метка)

Дата обновления интента.

createdDate -> (временная метка)

Дата создания интента.

version -> (строка)

Номер версии, назначенный новой версии интента.

checksum -> (строка)

Контрольная сумма созданной версии интента.

kendraConfiguration -> (структура)

Информация о конфигурации, если требуется, для подключения индекса Amazon Kendra к намерению AMAZON.KendraSearchIntent.

kendraIndex -> (строка)

Идентификатор ресурса Amazon (ARN) индекса Amazon Kendra, который вы хотите использовать для поиска намерения AMAZON.KendraSearchIntent. Индекс должен находиться в том же аккаунте и регионе, что и бот Amazon Lex. Если индекс Amazon Kendra не существует, при вызове операции PutIntent возникает исключение.

queryFilterString -> (строка)

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

Вы можете переопределить эту строку фильтра с новой строкой фильтра во время выполнения.

role -> (строка)

Идентификатор ресурса Amazon (ARN) роли IAM, имеющей разрешения для поиска в индексе Amazon Kendra. Роль должна находиться в том же аккаунте и регионе, что и бот Amazon Lex. Если роли не существует, при вызове операции PutIntent возникает исключение.

inputContexts -> (список)

Массив объектов InputContext, перечисляющий контексты, которые должны быть активны для того, чтобы Amazon Lex выбрал намерение в диалоге с пользователем.

(структура)

Имя контекста, который должен быть активным для выбора намерения Amazon Lex.

name -> (строка)

Имя контекста.

outputContexts -> (список)

Массив объектов OutputContext, перечисляющий контексты, которые активирует намерение при выполнении.

(структура)

Определение выходного контекста, который устанавливается при выполнении намерения.

name -> (строка)

Имя контекста.

timeToLiveInSeconds -> (целое число)

Количество секунд, в течение которых контекст должен оставаться активным после его первоначальной отправки в ответ PostContent или PostText. Вы можете установить значение от 5 до 86 400 секунд (24 часа).

turnsToLive -> (целое число)

Количество раундов диалога, в течение которых контекст должен оставаться активным. Один раунд диалога — это один запрос PostContent или PostText и соответствующий ответ от Amazon Lex.

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

Spec-Zone.ru

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