Spec-Zone.ru › AWS CLI v2

[ aws . comprehend ]

batch-detect-targeted-sentiment

Описание

Проверяет пакет документов и возвращает анализ настроения для каждого идентифицированного сущности в документах.

Дополнительную информацию о целевом настроении см. в разделе «Целевое настроение» в Руководстве разработчика Amazon Comprehend.

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

Синтаксис

  batch-detect-targeted-sentiment
--text-list <value>
--language-code <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]

Параметры

--text-list (список)

Список, содержащий закодированный в UTF-8 текст входных документов. Список может содержать не более 25 документов. Максимальный размер каждого документа составляет 5 КБ.

(строка)

Синтаксис:

"string" "string" ...

--language-code (строка)

Язык входных документов. В настоящее время поддерживается только английский язык.

Возможные значения:

  • en
  • es
  • fr
  • de
  • it
  • pt
  • ar
  • hi
  • ja
  • ko
  • zh
  • zh-TW

--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
  • table
  • yaml
  • yaml-stream

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

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для определения настроения и каждой именованной сущности для нескольких текстов ввода

Следующий пример batch-detect-targeted-sentiment анализирует несколько текстов ввода и возвращает именованные сущности вместе с преобладающим настроением, связанным с каждой сущностью. Также выводится оценка уверенности предварительно обученной модели для каждого прогноза.

aws comprehend batch-detect-targeted-sentiment \
    --language-code en \
    --text-list "That movie was really boring, the original was way more entertaining" "The trail is extra beautiful today." "My meal was just okay."

Вывод:

{
    "ResultList": [
        {
            "Index": 0,
            "Entities": [
                {
                    "DescriptiveMentionIndex": [
                        0
                    ],
                    "Mentions": [
                        {
                            "Score": 0.9999009966850281,
                            "GroupScore": 1.0,
                            "Text": "movie",
                            "Type": "MOVIE",
                            "MentionSentiment": {
                                "Sentiment": "NEGATIVE",
                                "SentimentScore": {
                                    "Positive": 0.13887299597263336,
                                    "Negative": 0.8057460188865662,
                                    "Neutral": 0.05525200068950653,
                                    "Mixed": 0.00012799999967683107
                                }
                            },
                            "BeginOffset": 5,
                            "EndOffset": 10
                        }
                    ]
                },
                {
                    "DescriptiveMentionIndex": [
                        0
                    ],
                    "Mentions": [
                        {
                            "Score": 0.9921110272407532,
                            "GroupScore": 1.0,
                            "Text": "original",
                            "Type": "MOVIE",
                            "MentionSentiment": {
                                "Sentiment": "POSITIVE",
                                "SentimentScore": {
                                    "Positive": 0.9999989867210388,
                                    "Negative": 9.999999974752427e-07,
                                    "Neutral": 0.0,
                                    "Mixed": 0.0
                                }
                            },
                            "BeginOffset": 34,
                            "EndOffset": 42
                        }
                    ]
                }
            ]
        },
        {
            "Index": 1,
            "Entities": [
                {
                    "DescriptiveMentionIndex": [
                        0
                    ],
                    "Mentions": [
                        {
                            "Score": 0.7545599937438965,
                            "GroupScore": 1.0,
                            "Text": "trail",
                            "Type": "OTHER",
                            "MentionSentiment": {
                                "Sentiment": "POSITIVE",
                                "SentimentScore": {
                                    "Positive": 1.0,
                                    "Negative": 0.0,
                                    "Neutral": 0.0,
                                    "Mixed": 0.0
                                }
                            },
                            "BeginOffset": 4,
                            "EndOffset": 9
                        }
                    ]
                },
                {
                    "DescriptiveMentionIndex": [
                        0
                    ],
                    "Mentions": [
                        {
                            "Score": 0.9999960064888,
                            "GroupScore": 1.0,
                            "Text": "today",
                            "Type": "DATE",
                            "MentionSentiment": {
                                "Sentiment": "NEUTRAL",
                                "SentimentScore": {
                                    "Positive": 9.000000318337698e-06,
                                    "Negative": 1.9999999949504854e-06,
                                    "Neutral": 0.9999859929084778,
                                    "Mixed": 3.999999989900971e-06
                                }
                            },
                            "BeginOffset": 29,
                            "EndOffset": 34
                        }
                    ]
                }
            ]
        },
        {
            "Index": 2,
            "Entities": [
                {
                    "DescriptiveMentionIndex": [
                        0
                    ],
                    "Mentions": [
                        {
                            "Score": 0.9999880194664001,
                            "GroupScore": 1.0,
                            "Text": "My",
                            "Type": "PERSON",
                            "MentionSentiment": {
                                "Sentiment": "NEUTRAL",
                                "SentimentScore": {
                                    "Positive": 0.0,
                                    "Negative": 0.0,
                                    "Neutral": 1.0,
                                    "Mixed": 0.0
                                }
                            },
                            "BeginOffset": 0,
                            "EndOffset": 2
                        }
                    ]
                },
                {
                    "DescriptiveMentionIndex": [
                        0
                    ],
                    "Mentions": [
                        {
                            "Score": 0.9995260238647461,
                            "GroupScore": 1.0,
                            "Text": "meal",
                            "Type": "OTHER",
                            "MentionSentiment": {
                                "Sentiment": "NEUTRAL",
                                "SentimentScore": {
                                    "Positive": 0.04695599898695946,
                                    "Negative": 0.003226999891921878,
                                    "Neutral": 0.6091709733009338,
                                    "Mixed": 0.34064599871635437
                                }
                            },
                            "BeginOffset": 3,
                            "EndOffset": 7
                        }
                    ]
                }
            ]
        }
    ],
    "ErrorList": []
}

Дополнительную информацию см. в разделе «Целевое настроение» в Руководстве разработчика Amazon Comprehend.

Вывод

ResultList -> (список)

Список объектов, содержащих результаты операции. Результаты отсортированы в порядке возрастания поля Index и соответствуют порядку документов в списке ввода. Если все документы содержат ошибку, ResultList пустой.

(структура)

Результаты анализа для одного из документов в пакете.

Индекс -> (целое число)

Индекс этого результата в списке ввода (нумерация с нуля).

Сущности -> (список)

Массив сущностей целевого анализа настроения.

(структура)

Информация об одной из сущностей, обнаруженных при целевом анализе настроения.

Дополнительную информацию о целевом настроении см. в разделе «Целевое настроение» в Руководстве разработчика Amazon Comprehend.

Индекс описательного упоминания -> (список)

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

(целое число)

Упоминания -> (список)

Массив упоминаний сущности в документе. Массив представляет собой группу ко-ссылок. См. пример группы ко-ссылок.

(структура)

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

Дополнительную информацию о целевом настроении см. в разделе «Целевое настроение» в Руководстве разработчика Amazon Comprehend.

Оценка -> (вещественное число)

Уверенность модели в том, что сущность актуальна. Диапазон значений — от нуля до единицы, где единица — наивысшая уверенность.

Оценка группы -> (вещественное число)

Уверенность в том, что все сущности, упомянутые в группе, относятся к одной сущности.

Текст -> (строка)

Текст в документе, который идентифицирует сущность.

Тип -> (строка)

Тип сущности. Amazon Comprehend поддерживает множество типов сущностей.

Настроение упоминания -> (структура)

Содержит настроение и оценку настроения для упоминания.

Настроение -> (строка)

Настроение упоминания.

Оценка настроения -> (структура)

Описывает уровень уверенности Amazon Comprehend в точности обнаружения настроений.

Положительный -> (вещественное число)

Уровень уверенности Amazon Comprehend в точности обнаружения настроения POSITIVE.

Отрицательный -> (вещественное число)

Уровень уверенности Amazon Comprehend в точности обнаружения настроения NEGATIVE.

Нейтральный -> (вещественное число)

Уровень уверенности Amazon Comprehend в точности обнаружения настроения NEUTRAL.

Смешанный -> (вещественное число)

Уровень уверенности Amazon Comprehend в точности обнаружения настроения MIXED.

Начальный смещение -> (целое число)

Смещение в тексте документа, где начинается упоминание.

Конечное смещение -> (целое число)

Смещение в тексте документа, где заканчивается упоминание.

Список ошибок -> (список)

Список ошибок, которые может вернуть операция.

(структура)

Описывает ошибку, возникшую при обработке документа в пакете. Операция возвращает объект BatchItemError для каждого документа, содержащего ошибку.

Индекс -> (целое число)

Индекс документа в списке ввода (нумерация с нуля).

Код ошибки -> (строка)

Числовой код ошибки.

Сообщение об ошибке -> (строка)

Текстовое описание ошибки.

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

Spec-Zone.ru

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