Spec-Zone.ru › AWS CLI v2

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

Spec-Zone.ru

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