[ aws . lexv2-models ]
list-utterance-metrics
Описание
Примечание
Для использования этой операции API вашей роли IAM необходимо предоставить разрешения на выполнение операции ListAggregatedUtterances, предоставляющей доступ к аналитике, связанной с высказываниями. См. Просмотр статистики высказываний для политики IAM, которую необходимо применить к роли IAM.Возвращает сводные метрики для высказываний в вашем боте. Требуются следующие поля:
-
metrics– Список объектов AnalyticsUtteranceMetric. В каждом объекте используйте полеnameдля указания метрики для расчета, полеstatisticдля указания, нужно ли рассчитыватьSum,AverageилиMaxчисло, и полеorderдля указания, нужно ли сортировать результаты в порядкеAscendingилиDescending. -
startDateTimeиendDateTime– Определяют временной диапазон, для которого требуется получить результаты.
Из необязательных полей вы можете организовать результаты следующим образом:
- Используйте поле
filtersдля фильтрации результатов, полеgroupByдля указания категорий, по которым сгруппировать результаты, и полеbinByдля указания временных интервалов, по которым сгруппировать результаты. - Используйте поле
maxResultsдля ограничения количества результатов, возвращаемых в одном ответе, и полеnextTokenдля возвращения следующей партии результатов, если ответ не возвращает полный набор результатов.
Обратите внимание, что поле order существует как в binBy, так и в metrics. В настоящее время вы можете указать его в любом поле, но не в обоих.
См. также: Документация AWS API
Синопсис
list-utterance-metrics
--bot-id <value>
--start-date-time <value>
--end-date-time <value>
--metrics <value>
[--bin-by <value>]
[--group-by <value>]
[--attributes <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– Количество фраз. -
Missed– Количество фраз, которые Amazon Lex не смог распознать. -
Detected– Количество фраз, которые Amazon Lex смог распознать. -
UtteranceTimestamp– Дата и время фразы.
statistic -> (строка)
Сводная статистика для вычисления.
-
Sum– Общее количество для категории, указанной вname. -
Average– Общее количество, разделенное на количество фраз в категории, указанной вname. -
Max– Максимальное количество в категории, указанной вname.
order -> (строка)
Сокращенная синтаксическая запись:
name=string,statistic=string,order=string ...
Синтаксис JSON:
[
{
"name": "Count"|"Missed"|"Detected"|"UtteranceTimestamp",
"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 (список)
Список объектов, каждый из которых определяет, как сгруппировать результаты. Вы можете сгруппировать по следующим критериям:
-
UtteranceText– Транскрипция фразы. -
UtteranceState– Состояние фразы. Возможные состояния подробно описаны в разделе "Определения ключевых понятий" в руководстве пользователя.
(структура)
Содержит категорию для группировки фраз.
name -> (строка)
Сокращенная синтаксическая запись:
name=string ...
Синтаксис JSON:
[
{
"name": "UtteranceText"|"UtteranceState"
}
...
]
--attributes (список)
Список атрибутов, относящихся к фразе, которые должны быть возвращены в ответе. Возможны следующие атрибуты:
-
LastUsedIntent– Последний использованный интент на момент произнесения фразы.
(структура)
Объект, определяющий последний использованный интент на момент произнесения фразы как атрибут для возврата.
name -> (строка)
Сокращенная синтаксическая запись:
name=string ...
Синтаксис JSON:
[
{
"name": "LastUsedIntent"
}
...
]
--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 (строка)
Если операция ListUtteranceMetrics возвращает больше результатов, чем указано в параметре maxResults, в ответе возвращается маркер.
Используйте возвращенный маркер в параметре nextToken запроса ListUtteranceMetrics, чтобы получить следующую страницу результатов. Для получения полного набора результатов вызывайте операцию ListUtteranceMetrics, пока в ответе не вернется 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 V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую, независимо от настроек cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для заданного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить вывод с помощью пейджера CLI.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
botId -> (string)
results -> (list)
Результаты для метрик фраз.
(структура)
Объект, содержащий результаты для запрашиваемых метрик фраз и ячейки и/или группы(ы), к которым они относятся, если применимо.
binKeys -> (list)
Список объектов, содержащих критерии, заданные для группировки результатов в ячейки, и значения ячеек.
(структура)
Объект, содержащий критерий группировки результатов в ячейки и значение, определяющее эту ячейку.
name -> (string)
value -> (long)
groupByKeys -> (list)
Список объектов, содержащих критерии, заданные для группировки результатов, и значения ячеек.
(структура)
Содержит категорию, по которой группировались аналитические данные фраз, и значения для этой категории.
name -> (string)
value -> (string)
metricsResults -> (list)
Список объектов, каждый из которых содержит метрику, которую вы хотите отобразить, статистику для метрики, которую вы хотите получить, и способ организации результатов.
(структура)
Объект, содержащий результаты запрошенной метрики фраз.
name -> (string)
Запрошенная метрика.
-
Count– Количество фраз. -
Missed– Количество фраз, которые Amazon Lex не смог распознать. -
Detected– Количество фраз, которые Amazon Lex смог распознать. -
UtteranceTimestamp– Дата и время фразы.
statistic -> (string)
Запрошенная статистическая сводка.
-
Sum– Общее количество для категории, предоставленной вname. -
Average– Общее количество, деленное на количество фраз в категории, предоставленной вname. -
Max– Максимальное количество в категории, предоставленной вname.
value -> (double)
attributeResults -> (list)
Список объектов, содержащих информацию о последнем использованном намерении в момент произнесения фразы.
(структура)
Объект, содержащий намерение, к которому бот сопоставил фразу.
lastUsedIntent -> (string)
nextToken -> (string)
Если ответ от операции ListUtteranceMetrics содержит больше результатов, чем указано в параметре maxResults, в ответе возвращается маркер.
Используйте возвращенный маркер в параметре nextToken запроса ListUtteranceMetrics, чтобы получить следующую страницу результатов. Для получения полного набора результатов вызывайте операцию ListUtteranceMetrics, пока в ответе не вернется null в параметре nextToken.
© Copyright 2025, Amazon Web Services. Created using Sphinx.