Spec-Zone.ru › AWS CLI v2

[ aws . lex-models ]

get-utterances-view

Описание

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

Например, предположим, что вы создали бота для заказа цветов. После того, как ваши пользователи некоторое время использовали вашего бота, используйте операцию GetUtterancesView, чтобы увидеть запросы, которые они сделали, и были ли они успешными. Вы можете обнаружить, что обращение «Я хочу цветы» не распознается. Вы можете добавить это обращение к намерению OrderFlowers, чтобы ваш бот распознавал это обращение.

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

Статистические данные о обращениях генерируются один раз в день. Данные доступны за последние 15 дней. Вы можете запросить информацию о до 5 версий вашего бота в каждом запросе. Amazon Lex возвращает самые часто встречающиеся обращения, полученные ботом за последние 15 дней. Ответ содержит информацию о максимум 100 обращениях для каждой версии.

Если вы установили поле childDirected в значение true при создании бота, если вы используете обфускацию слотов с одним или несколькими слотами или если вы отказались от участия в улучшении Amazon Lex, обращения недоступны.

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

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

Синтаксис

  get-utterances-view
--bot-name <value>
--bot-versions <value>
--status-type <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]

Параметры

--bot-name (строка)

Имя бота, для которого должна быть возвращена информация об обращениях.

--bot-versions (список)

Массив версий бота, для которых должна быть возвращена информация об обращениях. Ограничение — 5 версий на запрос.

(строка)

Синтаксис:

"string" "string" ...

--status-type (строка)

Чтобы вернуть обращения, которые были распознаны и обработаны, используйте Detected. Чтобы вернуть обращения, которые не были распознаны, используйте Missed.

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

  • Detected
  • Missed

--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
  • таблица
  • 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 (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Вывод

botName -> (строка)

Имя бота, для которого была возвращена информация об обращениях.

utterances -> (список)

Массив объектов UtteranceList, каждый из которых содержит список объектов UtteranceData, описывающих обращения, которые были обработаны вашим ботом. Ответ содержит максимум 100 объектов UtteranceData для каждой версии. Amazon Lex возвращает самые часто встречающиеся обращения, полученные ботом за последние 15 дней.

(структура)

Предоставляет список обращений, которые были сделаны конкретной версии вашего бота. Список содержит максимум 100 обращений.

botVersion -> (строка)

Версия бота, которая обрабатывала список.

utterances -> (список)

Один или несколько объектов UtteranceData, которые содержат информацию об обращениях, которые были сделаны боту. Максимальное количество объектов — 100.

(структура)

Предоставляет информацию об одном обращении, сделанном вашему боту.

utteranceString -> (строка)

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

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

Количество раз, когда обращение было обработано.

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

Общее количество пользователей, использовавших обращение.

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

Дата первого обращения.

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

Дата последнего обращения.

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

Spec-Zone.ru

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