[ aws . lexv2-models ]
list-intent-stage-metrics
Описание
Получает сводные метрики для стадий внутри интентов в вашем боте. Требуются следующие поля:
-
metrics– Список объектов AnalyticsIntentStageMetric. В каждом объекте используйте полеnameдля указания метрики для расчета, полеstatisticдля указания, нужно ли рассчитыватьSum,AverageилиMaxколичество, и полеorderдля указания, нужно ли сортировать результаты в порядкеAscendingилиDescending. -
startDateTimeиendDateTime– Определяют временной диапазон, для которого необходимо получить результаты.
Из необязательных полей вы можете организовать результаты следующим образом:
- Используйте поле
filtersдля фильтрации результатов, полеgroupByдля указания категорий для группировки результатов и полеbinByдля указания временных интервалов для группировки результатов. - Используйте поле
maxResultsдля ограничения количества результатов, возвращаемых в одном ответе, и полеnextTokenдля получения следующей порции результатов, если ответ не возвращает полный набор результатов.
Обратите внимание, что поле order существует как в binBy, так и в metrics. Вы можете указать только одно order в заданном запросе.
См. также: Документация AWS API
Синтаксис
list-intent-stage-metrics
--bot-id <value>
--start-date-time <value>
--end-date-time <value>
--metrics <value>
[--bin-by <value>]
[--group-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 (метка времени)
--metrics (список)
Список объектов, каждый из которых содержит метрику, которую нужно получить, статистику для этой метрики и способ организации результатов.
(структура)
Содержит метрику и желаемую сводную статистику, а также порядок сортировки результатов для стадий интента во всех пользовательских сессиях с ботом.
name -> (строка)
Метрика, для которой необходимо получить сводную статистику стадии интента. Смотрите раздел «Ключевые определения» для получения более подробной информации об этих метриках.
-
Count– Количество раз, когда произошла стадия интента. -
Success– Количество раз, когда стадия интента завершилась успешно. -
Failure– Количество раз, когда стадия интента завершилась неудачно. -
Dropped– Количество раз, когда пользователь отказался от стадии интента. -
Retry– Количество раз, когда бот пытался получить ответ от пользователя на этой стадии.
statistic -> (строка)
Сводная статистика для расчета.
-
Sum– Общее количество для категории, указанной вname. -
Average– Общее количество, деленное на количество стадий интента в категории, указанной вname. -
Max– Максимальное значение в категории, указанной вname.
order -> (строка)
value в ответе).Сокращенная синтаксическая запись:
name=string,statistic=string,order=string ...
Синтаксис JSON:
[
{
"name": "Count"|"Success"|"Failed"|"Dropped"|"Retry",
"statistic": "Sum"|"Avg"|"Max",
"order": "Ascending"|"Descending"
}
...
]
--bin-by (список)
Список объектов, каждый из которых содержит параметры организации результатов по времени.
(структура)
Содержит метрику времени, интервал и метод группировки данных аналитики.
name -> (строка)
interval -> (строка)
order -> (строка)
Сокращенная синтаксическая запись:
name=string,interval=string,order=string ...
Синтаксис JSON:
[
{
"name": "ConversationStartTime"|"UtteranceTimestamp",
"interval": "OneHour"|"OneDay",
"order": "Ascending"|"Descending"
}
...
]
--group-by (список)
Список объектов, каждый из которых определяет способ группировки результатов. Можно группировать по следующим критериям:
-
IntentStageName– Название стадии интента. -
SwitchedToIntent– Интент, на который была переключена беседа (если таковой был).
(структура)
Содержит категорию для группировки стадий интента.
name -> (строка)
Сокращенная синтаксическая запись:
name=string ...
Синтаксис JSON:
[
{
"name": "IntentStageName"|"SwitchedToIntent"
}
...
]
--filters (список)
Список объектов, каждый из которых описывает условие фильтрации результатов.
(структура)
Содержит поля, описывающие условие фильтрации стадий интента. Выражение можно интерпретировать как name operator values . Например:
-
IntentName CO Book– Название интента содержит строку «Book». -
BotVersion EQ 2– Версия бота равна двум.
Операторы, поддерживаемые каждым фильтром, перечислены ниже:
-
BotAlias–EQ. -
BotVersion–EQ. -
LocaleId–EQ. -
Modality–EQ. -
Channel–EQ. -
SessionId–EQ. -
OriginatingRequestId–EQ. -
IntentName–EQ,CO. -
IntentStageName–EQ,CO.
name -> (строка)
Категория для фильтрации стадий интента. Описания для каждого варианта приведены ниже:
-
BotAlias– Имя псевдонима бота. -
BotVersion– Версия бота. -
LocaleId– Локаль бота. -
Modality– Модальность сессии с ботом (аудио, DTMF или текст). -
Channel– Канал, с которым интегрирован бот. -
SessionId– Идентификатор сессии с ботом. -
OriginatingRequestId– Идентификатор первого запроса в сессии. -
IntentName– Название интента. -
IntentStageName– Стадия в интенте.
operator -> (строка)
Операция фильтрации категории. Доступны следующие операции:
-
CO– Содержит -
EQ– Равно -
GT– Больше чем -
LT– Меньше чем
Операторы, поддерживаемые каждым фильтром, перечислены ниже:
-
BotAlias–EQ. -
BotVersion–EQ. -
LocaleId–EQ. -
Modality–EQ. -
Channel–EQ. -
SessionId–EQ. -
OriginatingRequestId–EQ. -
IntentName–EQ,CO. -
IntentStageName–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"|"IntentName"|"IntentStageName",
"operator": "EQ"|"GT"|"LT",
"values": ["string", ...]
}
...
]
--max-results (целое число)
--next-token (строка)
Если операция ListIntentStageMetrics возвращает больше результатов, чем указано в параметре maxResults, в ответе возвращается маркер.
Используйте возвращенный маркер в параметре nextToken запроса ListIntentStageMetrics для получения следующей страницы результатов. Для получения всех результатов необходимо вызывать операцию ListIntentStageMetrics до тех пор, пока в ответе не будет возвращен 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 (boolean)
Включить отладку регистрации.
--endpoint-url (string)
Переопределить URL по умолчанию команды указанным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружаться, если этот аргумент предоставлен.
--ca-bundle (string)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом без таймаута. Значение по умолчанию — 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для бинарных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что бинарные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и бинарные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего бинарный блок fileb:// всегда будет обрабатываться как бинарный и использовать содержимое файла напрямую независимо от cli-binary-format настройки. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить кли-пейджер для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Вывод
botId -> (string)
results -> (list)
Результаты метрик стадии интента.
(structure)
Объект, содержащий результаты запрошенных метрик стадии интента и ячейки и/или группы, к которым они относятся, если применимо.
binKeys -> (list)
Список объектов, содержащих критерии, запрошенные для группировки результатов, и значения ячеек.
(structure)
Объект, содержащий критерий группировки результатов и значение, определяющее ячейку.
name -> (string)
value -> (long)
groupByKeys -> (list)
Список объектов, содержащих критерии, запрошенные для группировки результатов, и значения групп.
(structure)
Содержит категорию, по которой группировались показатели анализа стадии интента, и значения для этой категории.
name -> (string)
value -> (string)
metricsResults -> (list)
Список объектов, каждый из которых содержит метрику, которую нужно перечислить, статистику для метрики, которую нужно вернуть, и способ организации результатов.
(structure)
Объект, содержащий результаты запрошенной метрики стадии интента.
name -> (string)
Запрошенная метрика.
-
Count– Количество раз, когда произошла стадия интента. -
Success– Количество раз, когда стадия интента завершилась успешно. -
Failure– Количество раз, когда стадия интента завершилась неудачно. -
Dropped– Количество раз, когда пользователь отказался от стадии интента. -
Retry– Количество раз, когда бот пытался получить ответ от пользователя на этом этапе.
statistic -> (string)
Запрошенная сводная статистика.
-
Sum– Общее количество для категории, указанной вname. -
Average– Общее количество, поделённое на количество стадий интента в категории, указанной вname. -
Max– Максимальное количество в категории, указанной вname.
value -> (double)
nextToken -> (string)
Если ответ от операции ListIntentStageMetrics содержит больше результатов, чем указано в параметре maxResults, в ответе возвращается маркер.
Используйте возвращённый маркер в параметре nextToken запроса ListIntentStageMetrics для возврата следующей страницы результатов. Для получения полного набора результатов вызывайте операцию ListIntentStageMetrics до тех пор, пока возвращаемый в ответе nextToken не будет равен null.
© Copyright 2025, Amazon Web Services. Created using Sphinx.