Spec-Zone.ru › AWS CLI v2

[ aws . voice-id ]

evaluate-session

Описание

Оценивает указанную сессию на основе аудиоданных, собранных во время вызова Amazon Connect Voice ID.

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

Синтаксис

  evaluate-session
--domain-id <value>
--session-name-or-id <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]

Параметры

--domain-id (строка)

Идентификатор домена, в котором началась сессия.

--session-name-or-id (строка)

Идентификатор сессии или имя сессии, которую нужно оценить. В интеграции Voice ID это Contact-Id.

--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
  • текст
  • таблица
  • 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.

Вывод

AuthenticationResult -> (структура)

Подробности, полученные в результате процесса аутентификации, такие как решение об аутентификации и оценка аутентификации.

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

Метка времени окончания агрегации аудио для этого результата аутентификации.

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

Метка времени начала агрегации аудио для этого результата аутентификации.

AuthenticationResultId -> (строка)

Уникальный идентификатор этого результата аутентификации. Поскольку может быть несколько аутентификаций для данной сессии, это поле помогает определить, является ли возвращенный результат результатом предыдущей потоковой передачи или новым результатом. Обратите внимание, что при отсутствии какой-либо новой потоковой передачи, AcceptanceThreshold изменяется или SpeakerId изменяется, Voice ID всегда возвращает кэшированный результат аутентификации для этого API.

Configuration -> (структура)

AuthenticationConfiguration, использованные для генерации этого результата аутентификации.

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

Минимальный порог, необходимый для успешной аутентификации говорящего.

CustomerSpeakerId -> (строка)

Предоставленный клиентом идентификатор говорящего, для которого получен результат аутентификации. Присутствует только если для сессии предоставлен SpeakerId.

Decision -> (строка)

Решение об аутентификации, выданное Voice ID, обработанное по отношению к текущему состоянию сессии и аудиопотоку говорящего.

GeneratedSpeakerId -> (строка)

Сгенерированный службой идентификатор говорящего, для которого получен результат аутентификации.

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

Оценка аутентификации для говорящего, для которого получен результат аутентификации. Это значение присутствует только если решение об аутентификации равно ACCEPT или REJECT.

DomainId -> (строка)

Идентификатор домена, содержащего сессию.

FraudDetectionResult -> (структура)

Подробности, полученные в результате процесса выявления мошенничества, такие как решение о выявлении мошенничества и оценка риска.

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

Метка времени окончания агрегации аудио для этого результата выявления мошенничества.

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

Метка времени начала агрегации аудио для этого результата выявления мошенничества.

Configuration -> (структура)

FraudDetectionConfiguration, использованные для генерации этого результата выявления мошенничества.

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

Пороговое значение для определения того, является ли говорящий мошенником. Если обнаруженная оценка риска, рассчитанная Voice ID, выше порога, говорящий считается мошенником.

WatchlistId -> (строка)

Идентификатор списка наблюдения, по которому выполняется обнаружение мошенничества.

Decision -> (строка)

Решение о выявлении мошенничества, выданное Voice ID, обработанное по отношению к текущему состоянию сессии и аудиопотоку говорящего.

FraudDetectionResultId -> (строка)

Уникальный идентификатор этого результата выявления мошенничества. Так как может быть несколько выявления мошенничества для одной сессии, это поле помогает определить, является ли возвращенный результат результатом предыдущей потоковой передачи или новым результатом. При отсутствии какой-либо новой потоковой передачи или изменений порога риска Voice ID всегда возвращает кэшированный результат выявления мошенничества для этого API.

Reasons -> (список)

Причина, по которой система выявления мошенничества пометила говорящего. Это заполняется только если решение о выявлении мошенничества равно HIGH_RISK, и возможные значения: KNOWN_FRAUDSTER и VOICE_SPOOFING.

(строка)

RiskDetails -> (структура)

Подробности каждого анализируемого риска для этого говорящего. В настоящее время включает данные о KnownFraudsterRisk и VoiceSpoofingRisk.

KnownFraudsterRisk -> (структура)

Подробности, полученные в результате анализа «Known Fraudster Risk» для говорящего.

GeneratedFraudsterId -> (строка)

Идентификатор мошенника, наиболее точно соответствующий говорящему. Если в данном домене нет зарегистрированных мошенников или если нет мошенников с ненулевой оценкой риска, это значение равно null.

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

Оценка, указывающая вероятность того, что говорящий является известным мошенником.

VoiceSpoofingRisk -> (структура)

Подробности, полученные в результате анализа «Voice Spoofing Risk» для говорящего.

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

Оценка, указывающая вероятность того, что голос говорящего поддельный.

SessionId -> (строка)

Сгенерированный службой идентификатор сессии.

SessionName -> (строка)

Предоставленное клиентом имя сессии.

StreamingStatus -> (строка)

Текущий статус потоковой передачи аудио для данной сессии. Это поле полезно для вывода следующих шагов, когда результаты аутентификации или выявления мошенничества пусты или решение равно NOT_ENOUGH_SPEECH. В этой ситуации, если StreamingStatus равно ONGOING/PENDING_CONFIGURATION, это может означать, что клиенту следует вызвать API позже, после того как у Voice ID будет достаточно аудио для получения результата. Если решение остается NOT_ENOUGH_SPEECH даже после того, как StreamingStatus равно ENDED, это означает, что у ранее потоковой сессии не было достаточно речи для оценки, и требуется новая потоковая сессия, чтобы попробовать снова.

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

Spec-Zone.ru

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