создание-защитного-барьера

Описание

Создаёт защитный барьер для блокирования тем и реализации мер безопасности для ваших генеративных приложений ИИ.

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

Фильтры контента - Настройте силу фильтров для блокирования входных запросов или ответов модели, содержащих вредный контент.
Запрещённые темы - Определите набор тем, которые нежелательны в контексте вашего приложения. Эти темы будут заблокированы, если будут обнаружены в пользовательских запросах или ответах модели.
Фильтры слов - Настройте фильтры для блокирования нежелательных слов, фраз и ненормативной лексики. Такие слова могут включать оскорбительные термины, названия конкурентов и т. д.
Фильтры конфиденциальной информации - Блокируйте или маскируйте конфиденциальную информацию, такую как персональные данные (PII) или пользовательские регулярные выражения во входных данных и ответах модели.

В дополнение к вышеуказанным политикам вы также можете настроить сообщения, которые будут возвращены пользователю, если входные данные пользователя или ответ модели нарушают политики, определённые в защитном барьере.

Для получения дополнительной информации см. Amazon Bedrock Guardrails в руководстве пользователя Amazon Bedrock.

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

Синтаксис

  create-guardrail
--name <value>
[--description <value>]
[--topic-policy-config <value>]
[--content-policy-config <value>]
[--word-policy-config <value>]
[--sensitive-information-policy-config <value>]
[--contextual-grounding-policy-config <value>]
[--cross-region-config <value>]
--blocked-input-messaging <value>
--blocked-outputs-messaging <value>
[--kms-key-id <value>]
[--tags <value>]
[--client-request-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]

Параметры

--name (строка)

Имя, которое нужно присвоить защитному барьеру.

--description (строка)

Описание защитного барьера.

--topic-policy-config (структура)

Политики тем, которые необходимо настроить для защитного барьера.

topicsConfig -> (список)

Список политик, связанных с темами, которые защитный барьер должен запретить.

(структура)

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

name -> (строка)

Название темы, которую следует запретить.

definition -> (строка)

Определение темы, которую следует запретить.

examples -> (список)

Список подсказок, каждая из которых является примером подсказки, которую можно классифицировать как относящуюся к теме.

(строка)

type -> (строка)

Указывает на запрещение темы.

inputAction -> (строка)

Указывает действие, которое нужно предпринять при обнаружении вредного контента во вводе. Допустимые значения включают:

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

outputAction -> (строка)

Указывает действие, которое нужно предпринять при обнаружении вредного контента в выводе. Допустимые значения включают:

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

inputEnabled -> (булево значение)

Указывает, следует ли включить оценку защитного барьера для входных данных. При отключении вы не оплачиваете оценку. Оценка не отображается в ответе.

outputEnabled -> (булево значение)

Указывает, следует ли включить оценку защитного барьера для выходных данных. При отключении вы не оплачиваете оценку. Оценка не отображается в ответе.

Синтаксис JSON:

{
  "topicsConfig": [
    {
      "name": "string",
      "definition": "string",
      "examples": ["string", ...],
      "type": "DENY",
      "inputAction": "BLOCK"|"NONE",
      "outputAction": "BLOCK"|"NONE",
      "inputEnabled": true|false,
      "outputEnabled": true|false
    }
    ...
  ]
}

--content-policy-config (структура)

Политики фильтрации контента, которые необходимо настроить для защитного барьера.

filtersConfig -> (список)

Содержит тип фильтра контента и то, насколько строго он должен применяться к подсказкам и ответам модели.

(структура)

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

Ненависть – Описывает язык или утверждение, которое дискриминирует, критикует, оскорбляет, осуждает или обесчеловечивает человека или группу на основе идентичности (такой как раса, этническая принадлежность, пол, религия, сексуальная ориентация, способность и национальность).
Оскорбления – Описывает язык или утверждение, которое включает унизительный, унижающий, насмешливый, оскорбительный или презрительный язык. Этот тип языка также классифицируется как издевательство.
Сексуальный – Описывает язык или утверждение, которое указывает на сексуальный интерес, активность или возбуждение, используя прямые или косвенные ссылки на части тела, физические характеристики или секс.
Насилие – Описывает язык или утверждение, которое включает восхваление или угрозы нанесения физической боли, вреда или травм человеку, группе или предмету.

Фильтрация контента зависит от классификации достоверности входных данных пользователя и ответов FM по каждой из четырёх категорий вредоносного контента. Все утверждения входных данных и выходных данных классифицируются по одному из четырёх уровней достоверности (НЕТ, НИЗКИЙ, СРЕДНИЙ, ВЫСОКИЙ) для каждой категории вредоносности. Например, если утверждение классифицируется как «Ненависть» с высокой достоверностью, то вероятность того, что это утверждение представляет ненавистнический контент, высока. Одно утверждение может быть классифицировано по нескольким категориям с различными уровнями достоверности. Например, одно утверждение может быть классифицировано как «Ненависть» с высокой достоверностью, «Оскорбления» со средним уровнем достоверности, «Сексуальный» с низким уровнем достоверности и «Насилие» со средним уровнем достоверности.

Дополнительную информацию см. в разделе «Фильтры контента Guardrails».

type -> (строка)

Категория вредоносного контента, к которой применяется фильтр контента.

inputStrength -> (строка)

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

outputStrength -> (строка)

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

inputModalities -> (список)

Выбранные входные модальноти для конфигурации фильтра контента защитного барьера.

(строка)

outputModalities -> (список)

Выбранные выходные модальноти для конфигурации фильтра контента защитного барьера.

(строка)

inputAction -> (строка)

Указывает действие, которое нужно предпринять при обнаружении вредоносного контента. Допустимые значения включают:

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

outputAction -> (строка)

Указывает действие, которое нужно предпринять при обнаружении вредоносного контента в выводе. Допустимые значения включают:

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

inputEnabled -> (булево значение)

outputEnabled -> (булево значение)

Синтаксис JSON:

{
  "filtersConfig": [
    {
      "type": "SEXUAL"|"VIOLENCE"|"HATE"|"INSULTS"|"MISCONDUCT"|"PROMPT_ATTACK",
      "inputStrength": "NONE"|"LOW"|"MEDIUM"|"HIGH",
      "outputStrength": "NONE"|"LOW"|"MEDIUM"|"HIGH",
      "inputModalities": ["TEXT"|"IMAGE", ...],
      "outputModalities": ["TEXT"|"IMAGE", ...],
      "inputAction": "BLOCK"|"NONE",
      "outputAction": "BLOCK"|"NONE",
      "inputEnabled": true|false,
      "outputEnabled": true|false
    }
    ...
  ]
}

--word-policy-config (структура)

Политика слов, которую вы настраиваете для защитного барьера.

wordsConfig -> (список)

Список слов для настройки защитного барьера.

(структура)

Слово для настройки защитного барьера.

text -> (строка)

Текст слова, которое защитный барьер настроен блокировать.

inputAction -> (строка)

Указывает действие, которое нужно предпринять при обнаружении вредоносного контента во вводе. Допустимые значения включают:

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

outputAction -> (строка)

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

inputEnabled -> (булево значение)

outputEnabled -> (булево значение)

managedWordListsConfig -> (список)

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

(структура)

Управляемый список слов для настройки защитного барьера.

type -> (строка)

Тип управляемого списка слов для настройки защитного барьера.

inputAction -> (строка)

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

outputAction -> (строка)

BLOCK – заблокировать контент и заменить его сообщением о блокировке.
NONE – не предпринимать никаких действий, но возвращать информацию об обнаружении в ответ на отслеживание.

inputEnabled -> (булево значение)

outputEnabled -> (булево значение)

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

wordsConfig=[{text=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean},{text=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean}],managedWordListsConfig=[{type=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean},{type=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean}]

Синтаксис JSON:

{
  "wordsConfig": [
    {
      "text": "string",
      "inputAction": "BLOCK"|"NONE",
      "outputAction": "BLOCK"|"NONE",
      "inputEnabled": true|false,
      "outputEnabled": true|false
    }
    ...
  ],
  "managedWordListsConfig": [
    {
      "type": "PROFANITY",
      "inputAction": "BLOCK"|"NONE",
      "outputAction": "BLOCK"|"NONE",
      "inputEnabled": true|false,
      "outputEnabled": true|false
    }
    ...
  ]
}

--sensitive-information-policy-config (структура)

Политика конфиденциальности информации, которая должна быть настроена для ограждения.

piiEntitiesConfig -> (список)

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

(структура)

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

type -> (строка)

Настройка типа ограждения при обнаружении сущности с конфиденциальной информацией.

Следующие сущности с конфиденциальной информацией используются для блокирования или маскирования конфиденциальной информации:

Общие
- ADDRESS Физический адрес, например, «100 Main Street, Anytown, USA» или «Suite #12, Building 123». Адрес может включать информацию, такую как улица, здание, местоположение, город, штат, страна, округ, почтовый индекс, участок и район.
- AGE Возраст человека, включая количество и единицу времени. Например, в фразе «Мне 40 лет», Guardrails распознаёт «40 лет» как возраст.
- NAME Имя человека. Этот тип сущностей не включает титулы, такие как г-н, г-жа или мисс. ограждения не применяет этот тип сущностей к именам, которые являются частью организаций или адресов. Например, ограждения распознаёт «John Doe Organization» как организацию, а «Jane Doe Street» как адрес.
- EMAIL Электронный адрес, например, marymajor@email.com.
- PHONE Номер телефона. Этот тип сущностей также включает факсы и номера пейджеров.
- USERNAME Имя пользователя, которое идентифицирует учётную запись, например, имя пользователя, имя пользователя, никнейм или псевдоним.
- PASSWORD Алфавитно-цифровая строка, используемая в качестве пароля, например, «very20special#pass «.
- DRIVER_ID Номер, присвоенный водительскому удостоверению, которое является официальным документом, разрешающим лицу управлять одним или несколькими моторными транспортными средствами по общественной дороге. Номер водительского удостоверения состоит из буквенно-цифровых символов.
- LICENSE_PLATE Номерной знак транспортного средства выдаётся штатом или страной, в которой зарегистрировано транспортное средство. Формат для легковых автомобилей обычно составляет от пяти до восьми цифр, состоящих из заглавных букв и цифр. Формат варьируется в зависимости от местоположения выдавшего штата или страны.
- VEHICLE_IDENTIFICATION_NUMBER Номер VIN (Vehicle Identification Number) уникально идентифицирует транспортное средство. Содержание и формат VIN определены в спецификации ISO 3779. Каждая страна имеет собственные коды и форматы VIN.
Финансы
- CREDIT_DEBIT_CARD_CVV Трехзначный код проверки карты (CVV), который присутствует на кредитных и дебетовых картах VISA, MasterCard и Discover. Для кредитных или дебетовых карт American Express CVV является четырёхзначным цифровым кодом.
- CREDIT_DEBIT_CARD_EXPIRY Дата истечения срока действия кредитной или дебетовой карты. Это число обычно имеет четыре цифры и часто форматируется как месяц/год или MM/YY . Guardrails распознаёт даты истечения, такие как 01/21 , 01/2021 и Jan 2021 .
- CREDIT_DEBIT_CARD_NUMBER Номер кредитной или дебетовой карты. Эти номера могут иметь длину от 13 до 16 цифр. Однако Amazon Comprehend также распознаёт номера кредитных или дебетовых карт, когда присутствуют только последние четыре цифры.
- PIN Четырёхзначный персональный идентификационный номер (PIN), с помощью которого можно получить доступ к банковскому счёту.
- INTERNATIONAL_BANK_ACCOUNT_NUMBER Международный банковский номер счёта имеет определённые форматы в каждой стране. Более подробную информацию можно найти на сайте www.iban.com/structure.
- SWIFT_CODE SWIFT-код — это стандартный формат кода идентификатора банка (BIC), используемый для указания конкретного банка или филиала. Банки используют эти коды для денежных переводов, таких как международные банковские переводы. SWIFT-коды состоят из восьми или одиннадцати символов. Одиннадцатизначные коды относятся к конкретным филиалам, а восьмизначные коды (или одиннадцатизначные коды, заканчивающиеся на «XXX») относятся к головному или основному офису.
IT
- IP_ADDRESS IPv4-адрес, например, 198.51.100.0.
- MAC_ADDRESS MAC-адрес (Media Access Control) — это уникальный идентификатор, присвоенный контроллеру сетевого интерфейса (NIC).
- URL Веб-адрес, например, www.example.com.
- AWS_ACCESS_KEY Уникальный идентификатор, связанный с секретным ключом доступа; для шифрования запросов к Amazon Web Services программно вы используете идентификатор ключа доступа и секретный ключ доступа.
- AWS_SECRET_KEY Уникальный идентификатор, связанный с ключом доступа. Для шифрования запросов к Amazon Web Services программно вы используете идентификатор ключа доступа и секретный ключ доступа.
Специфичные для США
- US_BANK_ACCOUNT_NUMBER Номер банковского счёта США, длина которого обычно составляет от 10 до 12 цифр.
- US_BANK_ROUTING_NUMBER Номер маршрутизации банковского счёта США. Эти номера обычно состоят из девяти цифр.
- US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER Номер индивидуального налогоплательщика США (ITIN) — это девятизначное число, начинающееся с «9» и содержащее «7» или «8» в качестве четвёртой цифры. ITIN может форматироваться с пробелом или дефисом после третьей и четвёртой цифры.
- US_PASSPORT_NUMBER Номер паспорта США. Номера паспортов варьируются от шести до девяти буквенно-цифровых символов.
- US_SOCIAL_SECURITY_NUMBER Номер социального страхования США (SSN) — это девятизначное число, выдаваемое гражданам США, постоянным и временным жителям.
Специфичные для Канады
- CA_HEALTH_NUMBER Номер медицинского страхования Канады — это уникальный 10-значный идентификатор, необходимый для получения доступа к медицинским пособиям.
- CA_SOCIAL_INSURANCE_NUMBER Номер социального страхования Канады (SIN) — это уникальный девятизначный идентификатор, необходимый для доступа к государственным программам и пособиям. SIN форматируется как три группы из трёх цифр, например, 123-456-789 . SIN можно проверить с помощью простого алгоритма проверки контрольной цифры, известного как алгоритм Луна.
Специфичные для Великобритании
- UK_NATIONAL_HEALTH_SERVICE_NUMBER Номер Национальной службы здравоохранения Великобритании — это число от 10 до 17 цифр, например, 485 777 3456 . Текущая система форматирует 10-значное число с пробелами после третьей и шестой цифр. Последняя цифра — это контрольная цифра, определяющая ошибки.
- UK_NATIONAL_INSURANCE_NUMBER Номер национального страхования Великобритании (NINO) предоставляет лицам доступ к пособиям по национальному страхованию (социальному обеспечению). Он также используется для некоторых целей в налоговой системе Великобритании. Число состоит из девяти цифр и начинается с двух букв, за которыми следуют шесть цифр и одна буква. NINO может форматироваться с пробелом или дефисом после двух букв и после второй, четвёртой и шестой цифр.
- UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER Уникальный номер налогоплательщика Великобритании (UTR) — это 10-значное число, которое идентифицирует налогоплательщика или бизнес.
Настраиваемый
- Фильтр регулярных выражений - Вы можете использовать регулярные выражения для определения шаблонов, которые ограждение распознаёт и обрабатывает, например, серийные номера, идентификаторы бронирования и т. д..

action -> (строка)

Настройка действия ограждения при обнаружении сущности с конфиденциальной информацией.

inputAction -> (строка)

Указывает действие, которое необходимо выполнить при обнаружении вредного контента в вводе. Доступные значения включают:

BLOCK — Заблокировать контент и заменить его сообщением о блокировке.
ANONYMIZE — Замаскировать контент и заменить его метками идентификатора.
NONE — Не выполнять никаких действий, но вернуть информацию об обнаружении в ответ с отслеживанием.

outputAction -> (строка)

Указывает действие, которое необходимо выполнить при обнаружении вредного контента на выходе. Доступные значения включают:

BLOCK — Заблокировать контент и заменить его сообщением о блокировке.
ANONYMIZE — Замаскировать контент и заменить его метками идентификатора.
NONE — Не выполнять никаких действий, но вернуть информацию об обнаружении в ответ с отслеживанием.

inputEnabled -> (булево)

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

outputEnabled -> (булево)

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

regexesConfig -> (список)

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

(структура)

Регулярное выражение, которое должно быть настроено для ограждения.

name -> (строка)

Имя регулярного выражения, которое должно быть настроено для ограждения.

description -> (строка)

Описание регулярного выражения, которое должно быть настроено для ограждения.

pattern -> (строка)

Шаблон регулярного выражения, который должен быть настроен для ограждения.

action -> (строка)

Действие ограждения, которое должно быть настроено при обнаружении совпадения с регулярным выражением.

inputAction -> (строка)

BLOCK — Заблокировать контент и заменить его сообщением о блокировке.
NONE — Не выполнять никаких действий, но вернуть информацию об обнаружении в ответ с отслеживанием.

outputAction -> (строка)

BLOCK — Заблокировать контент и заменить его сообщением о блокировке.
NONE — Не выполнять никаких действий, но вернуть информацию об обнаружении в ответ с отслеживанием.

inputEnabled -> (булево)

outputEnabled -> (булево)

Сокращенная синтаксическая запись:

piiEntitiesConfig=[{type=string,action=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean},{type=string,action=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean}],regexesConfig=[{name=string,description=string,pattern=string,action=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean},{name=string,description=string,pattern=string,action=string,inputAction=string,outputAction=string,inputEnabled=boolean,outputEnabled=boolean}]

Синтаксис JSON:

{
  "piiEntitiesConfig": [
    {
      "type": "ADDRESS"|"AGE"|"AWS_ACCESS_KEY"|"AWS_SECRET_KEY"|"CA_HEALTH_NUMBER"|"CA_SOCIAL_INSURANCE_NUMBER"|"CREDIT_DEBIT_CARD_CVV"|"CREDIT_DEBIT_CARD_EXPIRY"|"CREDIT_DEBIT_CARD_NUMBER"|"DRIVER_ID"|"EMAIL"|"INTERNATIONAL_BANK_ACCOUNT_NUMBER"|"IP_ADDRESS"|"LICENSE_PLATE"|"MAC_ADDRESS"|"NAME"|"PASSWORD"|"PHONE"|"PIN"|"SWIFT_CODE"|"UK_NATIONAL_HEALTH_SERVICE_NUMBER"|"UK_NATIONAL_INSURANCE_NUMBER"|"UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER"|"URL"|"USERNAME"|"US_BANK_ACCOUNT_NUMBER"|"US_BANK_ROUTING_NUMBER"|"US_INDIVIDUAL_TAX_IDENTIFICATION_NUMBER"|"US_PASSPORT_NUMBER"|"US_SOCIAL_SECURITY_NUMBER"|"VEHICLE_IDENTIFICATION_NUMBER",
      "action": "BLOCK"|"ANONYMIZE"|"NONE",
      "inputAction": "BLOCK"|"ANONYMIZE"|"NONE",
      "outputAction": "BLOCK"|"ANONYMIZE"|"NONE",
      "inputEnabled": true|false,
      "outputEnabled": true|false
    }
    ...
  ],
  "regexesConfig": [
    {
      "name": "string",
      "description": "string",
      "pattern": "string",
      "action": "BLOCK"|"ANONYMIZE"|"NONE",
      "inputAction": "BLOCK"|"ANONYMIZE"|"NONE",
      "outputAction": "BLOCK"|"ANONYMIZE"|"NONE",
      "inputEnabled": true|false,
      "outputEnabled": true|false
    }
    ...
  ]
}

--contextual-grounding-policy-config (структура)

Конфигурация политики контекстного обоснования, используемая для создания барьера.

filtersConfig -> (список)

Подробности конфигурации фильтра для политики контекстного обоснования барьеров.

(структура)

Подробности конфигурации фильтра для фильтра контекстного обоснования барьеров.

type -> (строка)

Подробности фильтра для фильтра контекстного обоснования барьеров.

threshold -> (двойное)

Подробности порога для фильтра контекстного обоснования барьеров.

action -> (строка)

Указывает действие, которое нужно выполнить, когда содержимое не проходит оценку контекстного обоснования. Допустимые значения включают:

BLOCK – заблокировать содержимое и заменить его сообщением о блокировке.
NONE – не выполнять никаких действий, но вернуть информацию об обнаружении в ответ отслеживания.

enabled -> (булево)

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

Синтаксис сокращенного представления:

filtersConfig=[{type=string,threshold=double,action=string,enabled=boolean},{type=string,threshold=double,action=string,enabled=boolean}]

Синтаксис JSON:

{
  "filtersConfig": [
    {
      "type": "GROUNDING"|"RELEVANCE",
      "threshold": double,
      "action": "BLOCK"|"NONE",
      "enabled": true|false
    }
    ...
  ]
}

--cross-region-config (структура)

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

Для получения дополнительной информации обратитесь к Руководству пользователя Amazon Bedrock .

guardrailProfileIdentifier -> (строка)

Идентификатор или Amazon Resource Name (ARN) профиля барьера, который использует ваш барьер. Доступность профиля барьера зависит от вашего текущего региона Amazon Web Services. Для получения дополнительной информации обратитесь к Руководству пользователя Amazon Bedrock .

Синтаксис сокращенного представления:

guardrailProfileIdentifier=string

Синтаксис JSON:

{
  "guardrailProfileIdentifier": "string"
}

--blocked-input-messaging (строка)

Сообщение, которое возвращается, когда барьер блокирует запрос.

--blocked-outputs-messaging (строка)

Сообщение, которое возвращается, когда барьер блокирует ответ модели.

--kms-key-id (строка)

ARN ключа KMS, который вы используете для шифрования барьера.

--tags (список)

Теги, которые вы хотите добавить к барьеру.

(структура)

Определение пары ключ/значение для тега.

key -> (строка)

Ключ тега.

value -> (строка)

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

Синтаксис сокращенного представления:

key=string,value=string ...

Синтаксис JSON:

[
  {
    "key": "string",
    "value": "string"
  }
  ...
]

--client-request-token (строка)

Уникальный, чувствительный к регистру идентификатор для обеспечения того, что запрос API будет выполнен не более одного раза. Если этот токен совпадает с предыдущим запросом, Amazon Bedrock игнорирует запрос, но не возвращает ошибку. Для получения дополнительной информации см. Обеспечение идемпотентности в Руководстве пользователя Amazon S3 .

--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 (строка)

Включить/выключить цветной вывод.

on
off
auto

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

Вывод

guardrailId -> (строка)

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

guardrailArn -> (строка)

ARN барьера.

version -> (строка)

Версия созданного барьера. Это значение всегда будет DRAFT .

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

Время создания барьера.