list-messages
Описание
Получает список сообщений, связанных с веб-опытом Amazon Q Business.
См. также: Документацию API AWS
list-messages использует значения типа документа. Типы документов следуют модели данных JSON, где допустимые значения: строки, числа, булевы значения, null, массивы и объекты. Для ввода команд, опций и вложенных параметров, помеченных типом document, необходимо предоставить JSON. Краткая синтаксическая запись не поддерживает типы документов.
list-messages — это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничный вывод, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответном значении с постраничным выводом, аргумент --query должен извлекать данные из результатов следующих выражений запроса: messages
Синтаксис
list-messages
--conversation-id <value>
--application-id <value>
[--user-id <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]
Параметры
--conversation-id (строка)
--application-id (строка)
--user-id (строка)
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределят значения, предоставленные через JSON. Передача произвольных бинарных значений через значение JSON невозможна, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания места начала постраничного вывода. Это NextToken из ранее усеченного ответа.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя командной строки AWS.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя командной строки AWS.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничный вывод, предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно вне AWS CLI.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя командной строки AWS.
--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 (строка)
Включить/отключить вывод в цвете.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл-сборник сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет ограничено по времени. Значение по умолчанию — 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 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.
Вывод
messages -> (список)
Массив информации об одном или нескольких сообщениях.
(структура)
Сообщение в веб-опыте Amazon Q Business.
messageId -> (строка)
body -> (строка)
time -> (временная метка)
type -> (строка)
HUMAN или AI.attachments -> (список)
Файл, загруженный непосредственно в чат веб-опыта Amazon Q Business.
(структура)
Подробности загруженного в ходе чата файла.
name -> (строка)
status -> (строка)
error -> (структура)
Ошибка, связанная с загруженным файлом.
errorMessage -> (строка)
errorCode -> (строка)
attachmentId -> (строка)
conversationId -> (строка)
sourceAttribution -> (список)
Исходные документы, используемые для генерации сообщения веб-опыта Amazon Q Business.
(структура)
Документы, используемые для генерации ответа веб-опыта Amazon Q Business.
title -> (строка)
snippet -> (строка)
url -> (строка)
citationNumber -> (целое число)
updatedAt -> (временная метка)
textMessageSegments -> (список)
Выдержки текста из исходного документа, используемые для указания источника.
(структура)
Предоставляет информацию о выдержке текста в ответе чата, которая может быть отнесена к исходному документу.
beginOffset -> (целое число)
endOffset -> (целое число)
snippetExcerpt -> (структура)
Соответствующий фрагмент текста из источника, который использовался для генерации фрагмента цитаты в ответе чата Amazon Q Business.
text -> (строка)
mediaId -> (строка)
mediaMimeType -> (строка)
sourceDetails -> (структура помеченных объединений)
Информация об источнике для фрагмента извлеченного текста, включая его тип.
Примечание
Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть установлен:imageSourceDetails, audioSourceDetails, videoSourceDetails.imageSourceDetails -> (структура)
Подробности, специфичные для изображений в источнике.
mediaId -> (строка)
mediaMimeType -> (строка)
audioSourceDetails -> (структура)
Подробности, специфичные для аудиоконтента в источнике.
mediaId -> (строка)
mediaMimeType -> (строка)
startTimeMilliseconds -> (длинное целое число)
endTimeMilliseconds -> (длинное целое число)
audioExtractionType -> (строка)
videoSourceDetails -> (структура)
Подробности, специфичные для видеоконтента в источнике.
mediaId -> (строка)
mediaMimeType -> (строка)
startTimeMilliseconds -> (длинное целое число)
endTimeMilliseconds -> (длинное целое число)
videoExtractionType -> (строка)
actionReview -> (структура)
Событие вывода, которое Amazon Q Business возвращает пользователю, который хочет выполнить действие плагина во время непрямого чата. Оно содержит информацию о выбранном действии со списком возможных полей ввода пользователя, некоторые из которых заполнены Amazon Q Business.
pluginId -> (строка)
pluginType -> (строка)
payload -> (карта)
Значения полей, которые конечный пользователь должен предоставить Amazon Q Business для выполнения запрошенного действия плагина.
key -> (строка)
value -> (структура)
Поле ввода пользователя в оплате обзора действия плагина.
displayName -> (строка)
displayOrder -> (целое число)
displayDescription -> (строка)
type -> (строка)
value -> (документ)
allowedValues -> (список)
Информация о значениях поля, которые конечный пользователь может использовать для предоставления Amazon Q Business, чтобы выполнить запрашиваемое действие плагина.
(структура)
Информация о значениях поля, которые конечный пользователь может использовать для предоставления Amazon Q Business, чтобы выполнить запрашиваемое действие плагина.
value -> (документ)
displayValue -> (документ)
allowedFormat -> (строка)
from и to будут иметь формат datetime.arrayItemJsonSchema -> (документ)
required -> (булево)
payloadFieldNameSeparator -> (строка)
actionExecution -> (структура)
Выполнение действия плагина Amazon Q Business во время непрямого чата.
pluginId -> (строка)
payload -> (карта)
Сопоставление имен полей со значениями полей во входных данных, предоставляемых конечным пользователем Amazon Q Business для выполнения действия плагина.
key -> (строка)
value -> (структура)
Поле ввода пользователя в оплате выполнения действия плагина.
value -> (документ)
payloadFieldNameSeparator -> (строка)
nextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.