Spec-Zone.ru › AWS CLI v2

[ aws . lexv2-models ]

list-session-analytics-data

Описание

Возвращает список метаданных для отдельных сеансов пользователей с вашим ботом. Поля startDateTime и endDateTime являются обязательными. Эти поля определяют временной интервал, для которого вы хотите получить результаты. Из необязательных полей вы можете организовать результаты следующим образом:

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

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

Синтаксис

  list-session-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 -> (строка)

Мера, по которой сортировать данные аналитики сеансов.

  • conversationStartTime – Дата и время начала разговора. Разговор определяется как уникальная комбинация sessionId и originatingRequestId.
  • numberOfTurns – Количество этапов в сеансе.
  • conversationDurationSeconds – Длительность разговора в секундах.

order -> (строка)

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

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

name=string,order=string

Синтаксис JSON:

{
  "name": "ConversationStartTime"|"NumberOfTurns"|"Duration",
  "order": "Ascending"|"Descending"
}

--filters (список)

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

(структура)

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

  • LocaleId EQ en – Язык «en».
  • Duration GT 200 – Длительность больше 200 секунд.

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

  • BotAlias – EQ.
  • BotVersion – EQ.
  • LocaleId – EQ.
  • Modality – EQ.
  • Channel – EQ.
  • Duration – EQ, GT, LT.
  • conversationEndState – EQ, CO.
  • SessionId – EQ.
  • OriginatingRequestId – EQ.
  • IntentPath – EQ.

name -> (строка)

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

  • BotAlias – Название псевдонима бота.
  • BotVersion – Версия бота.
  • LocaleId – Язык бота.
  • Modality – Модальность сеанса с ботом (аудио, DTMF или текст).
  • Channel – Канал, с которым интегрирован бот.
  • Duration – Длительность сеанса.
  • conversationEndState – Конечное состояние сеанса.
  • SessionId – Идентификатор сеанса с ботом.
  • OriginatingRequestId – Идентификатор первого запроса в сеансе.
  • IntentPath – Порядок намерений в сеансе.

operator -> (строка)

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

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

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

  • BotAlias – EQ.
  • BotVersion – EQ.
  • LocaleId – EQ.
  • Modality – EQ.
  • Channel – EQ.
  • Duration – EQ, GT, LT.
  • conversationEndState – EQ, CO.
  • SessionId – EQ.
  • OriginatingRequestId – EQ.
  • IntentPath – EQ.

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"|"Duration"|"ConversationEndState"|"SessionId"|"OriginatingRequestId"|"IntentPath",
    "operator": "EQ"|"GT"|"LT",
    "values": ["string", ...]
  }
  ...
]

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

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

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

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

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

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

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

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

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

Вывод

botId -> (строка)

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

nextToken -> (строка)

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

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

sessions -> (список)

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

(структура)

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

botAliasId -> (строка)

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

botVersion -> (строка)

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

localeId -> (строка)

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

channel -> (строка)

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

sessionId -> (строка)

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

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

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

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

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

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

Продолжительность разговора в секундах. Разговор определяется как уникальная комбинация sessionId и originatingRequestId .

conversationEndState -> (строка)

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

mode -> (строка)

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

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

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

Количество раундов в сеансе.

invokedIntentSamples -> (список)

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

(структура)

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

intentName -> (строка)

Имя вызванного интента.

originatingRequestId -> (строка)

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

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

Spec-Zone.ru

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