Spec-Zone.ru › AWS CLI v2

[ aws . bedrock-agent-runtime ]

create-session

Описание

Создаёт сессию для временного хранения разговоров для приложений генеративного ИИ (GenAI), созданных с помощью открытых фреймворков, таких как LangGraph и LlamaIndex. Сессии позволяют сохранять состояние разговоров на контрольных точках, с дополнительной безопасностью и инфраструктурой Amazon Web Services. Для получения дополнительной информации см. Хранение и получение истории и контекста разговора с сессиями Amazon Bedrock.

По умолчанию Amazon Bedrock использует управляемые Amazon Web Services ключи для шифрования сессий, включая метаданные сессий, или вы можете использовать свой собственный ключ KMS. Для получения дополнительной информации см. Шифрование сессий Amazon Bedrock.

Примечание

Вы используете сессию для хранения состояния и истории разговоров для приложений генеративного ИИ, созданных с помощью открытых фреймворков. Для агентов Amazon Bedrock служба автоматически управляет контекстом разговора и связывает его с агентом-специфичным sessionId, который вы указываете в операции InvokeAgent API.

Связанные API:

  • ListSessions
  • GetSession
  • EndSession
  • DeleteSession

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

Синопсис

  create-session
[--encryption-key-arn <value>]
[--session-metadata <value>]
[--tags <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]

Параметры

--encryption-key-arn (строка)

Amazon Resource Name (ARN) ключа KMS, который будет использоваться для шифрования данных сессии. Пользователь или роль, создающая сессию, должны иметь разрешение на использование ключа. Для получения дополнительной информации см. Шифрование сессий Amazon Bedrock.

--session-metadata (словарь)

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

ключ -> (строка)

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

Упрощённый синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--tags (словарь)

Укажите пары ключ-значение для тегов, которые вы хотите прикрепить к сессии.

ключ -> (строка)

Ключ тега

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

Значение тега

Упрощённый синтаксис:

KeyName1=string,KeyName2=string

Синтаксис JSON:

{"string": "string"
  ...}

--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 для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запроса параметров ввода CLI.

Вывод

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

Метка времени создания сессии.

sessionArn -> (строка)

Amazon Resource Name (ARN) созданной сессии.

sessionId -> (строка)

Уникальный идентификатор сессии.

sessionStatus -> (строка)

Текущий статус сессии.

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

Spec-Zone.ru

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