Spec-Zone.ru › AWS CLI v2

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

put-slot-type

Описание

Создаёт пользовательский тип слота или заменяет существующий пользовательский тип слота.

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

Если вы укажете имя существующего типа слота, поля в запросе заменят существующие значения в версии $LATEST типа слота. Amazon Lex удаляет поля, которые вы не предоставили в запросе. Если вы не укажете необходимые поля, Amazon Lex выведет исключение. При обновлении версии $LATEST типа слота, если бот использует версию $LATEST интента, содержащего тип слота, поле status бота устанавливается в значение NOT_BUILT.

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

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

Синтаксис

  put-slot-type
--name <value>
[--description <value>]
[--enumeration-values <value>]
[--checksum <value>]
[--value-selection-strategy <value>]
[--create-version | --no-create-version]
[--parent-slot-type-signature <value>]
[--slot-type-configurations <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 (строка)

Имя типа слота. Регистр не учитывается.

Имя не может совпадать с именем встроенного типа слота или именем встроенного типа слота с удалённым "AMAZON". Например, поскольку существует встроенный тип слота под названием AMAZON.DATE, вы не можете создать пользовательский тип слота под названием DATE.

Список встроенных типов слотов см. в Справочнике по типам слотов в Alexa Skills Kit.

--description (строка)

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

--enumeration-values (список)

Список объектов EnumerationValue, определяющих значения, которые может принимать тип слота. Каждое значение может иметь список synonyms, представляющих дополнительные значения, которые помогают обучить модель машинного обучения значениям, которые она определяет для слота.

Для типа слота с регулярным выражением значения перечисления не требуются. Все остальные типы слотов требуют список значений перечисления.

Когда Amazon Lex определяет значение слота, он генерирует список решений, содержащий до пяти возможных значений для слота. Если вы используете функцию Lambda, этот список решений передаётся в функцию. Если вы не используете функцию Lambda, вы можете выбрать возвращать значение, введённое пользователем, или первое значение в списке решений в качестве значения слота. Поле valueSelectionStrategy указывает на выбор.

(структура)

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

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

  • толстый
  • тонкий
  • начиненный

value -> (строка)

Значение типа слота.

synonyms -> (список)

Дополнительные значения, относящиеся к значению типа слота.

(строка)

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

value=string,synonyms=string,string ...

Синтаксис JSON:

[
  {
    "value": "string",
    "synonyms": ["string", ...]
  }
  ...
]

--checksum (строка)

Идентифицирует конкретный пересмотр версии $LATEST.

При создании нового типа слота оставьте поле checksum пустым. Если вы укажете контрольную сумму, получите исключение BadRequestException.

При обновлении типа слота установите поле checksum в контрольную сумму последнего пересмотра версии $LATEST. Если вы не укажете поле checksum или контрольная сумма не соответствует версии $LATEST, получите исключение PreconditionFailedException.

--value-selection-strategy (строка)

Определяет стратегию разрешения слотов, которую Amazon Lex использует для возврата значений типов слотов. Поле можно установить на одно из следующих значений:

  • ORIGINAL_VALUE - Возвращает значение, введённое пользователем, если пользовательское значение похоже на значение слота.
  • TOP_RESOLUTION - Если для слота есть список решений, возвращает первое значение в списке решений в качестве значения типа слота. Если список решений отсутствует, возвращается null.

Если вы не укажете valueSelectionStrategy, значение по умолчанию - ORIGINAL_VALUE.

Возможные значения:

  • ORIGINAL_VALUE
  • TOP_RESOLUTION

--create-version | --no-create-version (булево)

При установке в значение true создаётся новая пронумерованная версия типа слота. Это то же самое, что и вызов операции CreateSlotTypeVersion. Если вы не укажете createVersion, значение по умолчанию - false.

--parent-slot-type-signature (строка)

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

Поддерживается только AMAZON.AlphaNumeric.

--slot-type-configurations (список)

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

(структура)

Предоставляет сведения о конфигурации для типа слота.

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

Регулярное выражение, используемое для проверки значения слота.

pattern -> (строка)

Регулярное выражение, используемое для проверки значения слота.

Используйте стандартное регулярное выражение. Amazon Lex поддерживает следующие символы в регулярном выражении:

  • A-Z, a-z
  • 0-9
  • Unicode-символы (”u<Unicode>”)

Представьте Unicode-символы четырьмя цифрами, например, “u0041” или “u005A”.

Следующие операторы регулярных выражений не поддерживаются:

  • Бесконечные повторители: *, +, или {x,} без верхнего предела.
  • Подстановочный символ (.)

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

regexConfiguration={pattern=string} ...

Синтаксис JSON:

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

Вывод

name -> (строка)

Название типа слота.

description -> (строка)

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

enumerationValues -> (список)

Список объектов EnumerationValue, определяющих значения, которые может принимать тип слота.

(структура)

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

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

  • толстая
  • тонкая
  • начиненная

value -> (строка)

Значение типа слота.

synonyms -> (список)

Дополнительные значения, относящиеся к значению типа слота.

(строка)

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

Дата последнего обновления типа слота. При создании типа слота дата создания и последнего обновления совпадают.

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

Дата создания типа слота.

version -> (строка)

Версия типа слота. Для нового типа слота версия всегда $LATEST .

checksum -> (строка)

Контрольная сумма версии $LATEST типа слота.

valueSelectionStrategy -> (строка)

Стратегия разрешения слота, которую Amazon Lex использует для определения значения слота. Дополнительную информацию см. в разделе PutSlotType .

createVersion -> (логическое значение)

True, если была создана новая версия типа слота. Если поле createVersion не было указано в запросе, поле createVersion в ответе устанавливается в значение false.

parentSlotTypeSignature -> (строка)

Встроенный тип слота, используемый в качестве родителя типа слота.

slotTypeConfigurations -> (список)

Конфигурационная информация, которая расширяет встроенный родительский тип слота.

(структура)

Предоставляет конфигурационную информацию для типа слота.

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

Регулярное выражение, используемое для проверки значения слота.

pattern -> (строка)

Регулярное выражение, используемое для проверки значения слота.

Используйте стандартное регулярное выражение. Amazon Lex поддерживает следующие символы в регулярном выражении:

  • A-Z, a-z
  • 0-9
  • Символы Unicode (”u<Unicode>”)

Представляйте символы Unicode четырьмя цифрами, например, “u0041” или “u005A”.

Следующие операторы регулярных выражений не поддерживаются:

  • Бесконечные повторители: *, +, или {x,} без верхней границы.
  • Подстановка (.)

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

Spec-Zone.ru

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