[ 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.