Spec-Zone.ru › AWS CLI v2

[ aws . lexv2-models ]

list-utterance-analytics-data

Описание

Примечание

Для использования этой операции API ваша роль IAM должна иметь разрешения на выполнение операции ListAggregatedUtterances, которая предоставляет доступ к аналитике, связанной с высказываниями. См. Просмотр статистики высказываний для политики IAM, которую необходимо применить к роли IAM.

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

  • startDateTime и endDateTime – Определяют временной диапазон, для которого необходимо получить результаты.

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

  • Используйте поле filters для фильтрации результатов и поле sortBy для указания значений, по которым следует отсортировать результаты.
  • Используйте поле maxResults для ограничения количества результатов, возвращаемых в одном ответе, и поле nextToken для возврата следующей группы результатов, если ответ не возвращает весь набор результатов.

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

Синтаксис

  list-utterance-analytics-data
--bot-id <value>
--start-date-time <value>
--end-date-time <value>
[--sort-by <value>]
[--filters <value>]
[--max-results <value>]
[--next-token <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-id (строка)

Идентификатор бота, для которого требуется получить аналитику высказываний.

--start-date-time (метка времени)

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

--end-date-time (метка времени)

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

--sort-by (структура)

Объект, определяющий меру и метод сортировки данных аналитики высказываний.

name -> (строка)

Метрика, по которой сортируются данные аналитики высказываний.

  • Count – Количество высказываний.
  • UtteranceTimestamp – Дата и время высказывания.

order -> (строка)

Указывает, следует ли сортировать результаты в порядке возрастания или убывания.

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

name=string,order=string

Синтаксис JSON:

{
  "name": "UtteranceTimestamp",
  "order": "Ascending"|"Descending"
}

--filters (список)

Список объектов, каждый из которых описывает условие, по которому нужно отфильтровать результаты.

(структура)

Содержит поля, описывающие условие фильтрации высказываний. Выражение может быть понято как name operator values . Например:

  • LocaleId EQ Book – Локаль — строка “en”.
  • UtteranceText CO help – Текст высказывания содержит строку “help”.

Операторы, которые поддерживает каждый фильтр, перечислены ниже:

  • BotAlias – EQ .
  • BotVersion – EQ .
  • LocaleId – EQ .
  • Modality – EQ .
  • Channel – EQ .
  • SessionId – EQ .
  • OriginatingRequestId – EQ .
  • UtteranceState – EQ .
  • UtteranceText – EQ , CO .

name -> (строка)

Категория, по которой фильтровать высказывания. Описания для каждого варианта приведены ниже:

  • BotAlias – Имя алиаса бота.
  • BotVersion – Версия бота.
  • LocaleId – Локаль бота.
  • Modality – Модальность сессии с ботом (аудио, DTMF или текст).
  • Channel – Канал, с которым интегрирован бот.
  • SessionId – Идентификатор сессии с ботом.
  • OriginatingRequestId – Идентификатор первого запроса в сессии.
  • UtteranceState – Состояние высказывания.
  • UtteranceText – Текст в высказывании.

operator -> (строка)

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

  • CO – Содержит
  • EQ – Равно
  • GT – Больше чем
  • LT – Меньше чем

Операторы, которые поддерживает каждый фильтр, перечислены ниже:

  • BotAlias – EQ .
  • BotVersion – EQ .
  • LocaleId – EQ .
  • Modality – EQ .
  • Channel – EQ .
  • SessionId – EQ .
  • OriginatingRequestId – EQ .
  • UtteranceState – EQ .
  • UtteranceText – EQ , CO .

values -> (список)

Массив, содержащий значения категории, по которым нужно применить оператор для фильтрации результатов. Вы можете указать несколько значений, если оператор равен EQ или CO . Если вы указываете несколько значений, вы фильтруете результаты, которые равны/содержат любое из значений. Например, если поля name , operator и values являются Modality , EQ и [Speech, Text] , операция фильтрует результаты, где модальность была либо Speech , либо Text .

(строка)

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

name=string,operator=string,values=string,string ...

Синтаксис JSON:

[
  {
    "name": "BotAliasId"|"BotVersion"|"LocaleId"|"Modality"|"Channel"|"SessionId"|"OriginatingRequestId"|"UtteranceState"|"UtteranceText",
    "operator": "EQ"|"GT"|"LT",
    "values": ["string", ...]
  }
  ...
]

--max-results (целое число)

Максимальное количество результатов, возвращаемых на каждой странице результатов. Если результатов меньше, чем максимальный размер страницы, возвращается только фактическое количество результатов.

--next-token (строка)

Если ответ от операции ListUtteranceAnalyticsData содержит больше результатов, чем указано в параметре maxResults, в ответе возвращается маркер.

Используйте возвращенный маркер в параметре nextToken запроса ListUtteranceAnalyticsData, чтобы получить следующую страницу результатов. Для получения полного набора результатов вызывайте операцию ListUtteranceAnalyticsData до тех пор, пока в ответе не будет возвращен null для nextToken.

--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-auto-prompt (булево)

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

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

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

Вывод

botId -> (строка)

Уникальный идентификатор бота, к которому относятся высказывания.

nextToken -> (строка)

Если ответ от операции ListUtteranceAnalyticsData содержит больше результатов, чем указано в параметре maxResults, в ответе возвращается маркер.

Используйте возвращенный маркер в параметре nextToken запроса ListUtteranceAnalyticsData, чтобы получить следующую страницу результатов. Для получения полного набора результатов вызывайте операцию ListUtteranceAnalyticsData до тех пор, пока возвращаемый в ответе nextToken не будет равен null.

utterances -> (список)

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

(структура)

Объект, содержащий информацию о конкретном высказывании.

botAliasId -> (строка)

Идентификатор псевдонима бота, к которому было произнесено высказывание.

botVersion -> (строка)

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

localeId -> (строка)

Язык бота, к которому было произнесено высказывание.

sessionId -> (строка)

Идентификатор сеанса, в котором было произнесено высказывание.

channel -> (строка)

Канал, интегрированный с ботом, к которому было произнесено высказывание.

mode -> (строка)

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

  • Speech – Сеанс состоял из устной диалогической речи.
  • Text – Сеанс состоял из письменного диалога.
  • DTMF – Сеанс состоял из нажатий кнопок на кнопочной панели (Dual Tone Multi-Frequency).
  • MultiMode – Сеанс состоял из нескольких режимов.

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

Дата и время начала разговора, в котором произошло высказывание. Разговор определяется как уникальная комбинация sessionId и originatingRequestId.

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

Дата и время окончания разговора, в котором произошло высказывание. Разговор определяется как уникальная комбинация sessionId и originatingRequestId.

utterance -> (строка)

Текст высказывания.

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

Дата и время произнесения высказывания.

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

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

utteranceUnderstood -> (булево значение)

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

inputType -> (строка)

Тип ввода высказывания. Возможные значения:

  • Формат PCM: данные аудио должны быть в порядке байтов little-endian.
    • audio/l16; rate=16000; channels=1
    • audio/x-l16; sample-rate=16000; channel-count=1
    • audio/lpcm; sample-rate=8000; sample-size-bits=16; channel-count=1; is-big-endian=false
  • Формат Opus
    • audio/x-cbr-opus-with-preamble;preamble-size=0;bit-rate=256000;frame-size-milliseconds=4
  • Текстовый формат
    • text/plain; charset=utf-8

outputType -> (строка)

Тип вывода высказывания. Возможные значения:

  • audio/mpeg
  • audio/ogg
  • audio/pcm (16 KHz)
  • audio/ (по умолчанию mpeg )
  • text/plain; charset=utf-8

associatedIntentName -> (строка)

Имя интента, к которому относится высказывание.

associatedSlotName -> (строка)

Имя слота, к которому относится высказывание.

intentState -> (строка)

Состояние интента, к которому относится высказывание.

dialogActionType -> (строка)

Тип диалогового действия, к которому относится высказывание. Дополнительную информацию см. в поле type в DialogAction.

botResponseAudioVoiceId -> (строка)

Идентификатор аудио ответа бота.

slotsFilledInSession -> (строка)

Слоты, заполненные в сеансе к моменту произнесения высказывания.

utteranceRequestId -> (строка)

Идентификатор запроса, связанного с высказыванием.

botResponses -> (список)

Список объектов, содержащих информацию о ответе бота на высказывание.

(структура)

Объект, содержащий ответ бота на высказывание.

content -> (строка)

Текст ответа бота на высказывание.

contentType -> (строка)

Тип ответа. Возможные значения:

  • PlainText – Простая текстовая строка.
  • CustomPayload – Строка ответа, которую можно настроить для включения данных или метаданных для вашего приложения.
  • SSML – Строка, содержащая Speech Synthesis Markup Language для настройки аудио ответа.
  • ImageResponseCard – Изображение с кнопками, которые может выбрать клиент. Дополнительную информацию см. в ImageResponseCard.

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

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

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

title -> (строка)

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

subtitle -> (строка)

Подзаголовок для отображения на карточке ответа. Формат подзаголовка определяется платформой, отображающей карточку ответа.

imageUrl -> (строка)

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

buttons -> (список)

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

(структура)

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

text -> (строка)

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

value -> (строка)

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

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

Spec-Zone.ru

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