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

Описание

Создает версию Amazon Q в Connect AI Guardrail.

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

Синтаксис

  create-ai-guardrail-version
--assistant-id <value>
--ai-guardrail-id <value>
[--modified-time <value>]
[--client-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]

Параметры

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

Идентификатор помощника Amazon Q в Connect. Может быть либо ID, либо ARN. URL-адреса не могут содержать ARN.

--ai-guardrail-id (строка)

Идентификатор Amazon Q в Connect AI Guardrail.

--modified-time (метка времени)

Время последнего изменения AI Guardrail.

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

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы обеспечить идемпотентность запроса. Если не указано, Amazon Web Services SDK заполняет это поле. Дополнительную информацию об идемпотентности см. в разделе Обеспечение безопасности повторных попыток с помощью идемпотентных API.

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

Вывод

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

Данные версии AI Guardrail.

assistantId -> (строка)

Идентификатор помощника Amazon Q в Connect. Может быть либо ID, либо ARN. URL-адреса не могут содержать ARN.

assistantArn -> (строка)

Amazon Resource Name (ARN) помощника Amazon Q в Connect.

aiGuardrailArn -> (строка)

Amazon Resource Name (ARN) AI Guardrail.

aiGuardrailId -> (строка)

Идентификатор Amazon Q в Connect AI Guardrail.

name -> (строка)

Имя AI Guardrail.

visibilityStatus -> (строка)

Статус видимости AI Guardrail.

blockedInputMessaging -> (строка)

Сообщение, возвращаемое при блокировании запроса AI Guardrail.

blockedOutputsMessaging -> (строка)

Сообщение, возвращаемое при блокировании модели AI Guardrail.

description -> (строка)

Описание AI Guardrail.

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

Содержит сведения о темах, которые AI Guardrail должен идентифицировать и блокировать.

topicsConfig -> (список)

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

(структура)

Сведения о темах, которые AI Guardrail должен идентифицировать и блокировать.

name -> (строка)

Название темы для блокирования.

definition -> (строка)

Определение темы для блокирования.

examples -> (список)

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

(строка)

Пример текста в политике темы

type -> (строка)

Указывает на блокирование темы.

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

Содержит сведения о том, как обрабатывать вредное содержимое.

filtersConfig -> (список)

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

(структура)

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

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

Фильтрация содержимого зависит от классификации уверенности входных данных пользователя и ответов FM по каждой из четырех категорий вредного содержимого. Все входные и выходные утверждения классифицируются по одному из четырех уровней уверенности (NONE, LOW, MEDIUM, HIGH) для каждой категории вредного содержимого. Например, если утверждение классифицировано как Ненависть с высокой уверенностью, то вероятность того, что это утверждение представляет ненавистное содержимое, высока. Одно утверждение может быть классифицировано по нескольким категориям с разными уровнями уверенности. Например, одно утверждение может быть классифицировано как Ненависть с высокой уверенностью, Оскорбления со средней уверенностью, Сексуальный с низкой уверенностью и Насилие со средней уверенностью.

type -> (строка)

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

inputStrength -> (строка)

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

outputStrength -> (строка)

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

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

Содержит сведения о политике слов, настроенной для AI Guardrail.

wordsConfig -> (список)

Список слов для настройки AI Guardrail.

(структура)

Слово для настройки AI Guardrail.

text -> (строка)

Текст слова, которое AI Guardrail должен заблокировать.

managedWordListsConfig -> (список)

Список управляемых списков слов для настройки AI Guardrail.

(структура)

Управляемый список слов для настройки AI Guardrail.

type -> (строка)

Тип управляемого списка слов для настройки AI Guardrail.

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

Содержит данные о сущностях PII и регулярных выражениях для настройки AI Guardrail.

piiEntitiesConfig -> (список)

Список сущностей PII для настройки AI Guardrail.

(структура)

Сущность PII для настройки AI Guardrail.

type -> (строка)

Настройка типа AI Guardrail при обнаружении сущности PII.

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

Общие
- ADDRESS Физический адрес, такой как «100 Main Street, Anytown, USA» или «Suite #12, Building 123». Адрес может включать в себя информацию, такую как улица, здание, местоположение, город, штат, страна, округ, почтовый индекс, участок и район.
- AGE Возраст человека, включая количество и единицу измерения времени. Например, в фразе «Мне 40 лет», Guarrails распознает «40 лет» как возраст.
- NAME Имя человека. Этот тип сущности не включает звания, такие как Dr., Mr., Mrs. или Miss. AI Guardrail не применяет этот тип сущности к именам, которые являются частью организаций или адресов. Например, AI Guardrail распознает «John Doe Organization» как организацию, а «Jane Doe Street» как адрес.
- EMAIL Адрес электронной почты, такой как marymajor@email.com .
- PHONE Номер телефона. Этот тип сущности также включает номера факса и пейджера.
- USERNAME Имя пользователя, которое идентифицирует учетную запись, например, имя входа, имя пользователя, никнейм или псевдоним.
- PASSWORD Символьная строка, используемая в качестве пароля, например, «very20special#pass «.
- DRIVER_ID Номер, присвоенный водительскому удостоверению, которое является официальным документом, разрешающим лицу управлять одним или несколькими моторными транспортными средствами по общественной дороге. Номер водительского удостоверения состоит из буквенно-цифровых символов.
- LICENSE_PLATE Номерной знак транспортного средства выдается штатом или страной, где зарегистрировано транспортное средство. Формат для легковых автомобилей обычно составляет от пяти до восьми цифр, состоящих из заглавных букв и цифр. Формат варьируется в зависимости от местоположения выдавшего государства или страны.
- VEHICLE_IDENTIFICATION_NUMBER Идентификационный номер транспортного средства (VIN) уникально идентифицирует транспортное средство. Содержание и формат VIN определены в спецификации ISO 3779. Каждая страна имеет собственные коды и форматы VIN.
Финансы
- CREDIT_DEBIT_CARD_CVV Трехзначный код проверки карты (CVV), присутствующий на кредитных и дебетовых картах VISA, MasterCard и Discover. Для кредитных или дебетовых карт American Express CVV представляет собой четырехзначный числовой код.
- CREDIT_DEBIT_CARD_EXPIRY Дата истечения срока действия кредитной или дебетовой карты. Это число обычно состоит из четырех цифр и часто форматируется как месяц/год или MM/ГГ . AI Guardrail распознает даты истечения, такие как 01/21 , 01/2021 и янв 2021 г.
- CREDIT_DEBIT_CARD_NUMBER Номер кредитной или дебетовой карты. Эти номера могут варьироваться от 13 до 16 цифр в длину. Тем не менее, Amazon Comprehend также распознает номера кредитных или дебетовых карт, если присутствуют только последние четыре цифры.
- PIN Четырехзначный персональный идентификационный номер (PIN), с помощью которого вы можете получить доступ к своему банковскому счету.
- INTERNATIONAL_BANK_ACCOUNT_NUMBER Международный номер банковского счета имеет определенные форматы в каждой стране. Для получения дополнительной информации посетите www.iban.com/structure .
- SWIFT_CODE SWIFT-код — это стандартный формат кода идентификатора банка (BIC), используемого для указания конкретного банка или филиала. Банки используют эти коды для денежных переводов, таких как международные денежные переводы. SWIFT-коды состоят из восьми или одиннадцати символов. 11-значные коды относятся к конкретным филиалам, а 8-значные коды (или 11-значные коды, заканчивающиеся на «XXX») относятся к головному или основному офису.
IT
- IP_ADDRESS IPv4-адрес, такой как 198.51.100.0 .
- MAC_ADDRESS Media access control (MAC) — это уникальный идентификатор, назначенный контроллеру сетевого интерфейса (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 Номер медицинского обслуживания Канады — это уникальный десятизначный идентификатор, необходимый для получения медицинских услуг.
- CA_SOCIAL_INSURANCE_NUMBER Номер социального страхования Канады (SIN) — это уникальный девятизначный идентификатор, необходимый для доступа к правительственным программам и льготам. SIN форматируется как три группы из трех цифр, например 123-456-789 . SIN можно проверить с помощью простого алгоритма проверки контрольной цифры, называемого алгоритмом Люна.
Специфические для Великобритании
- UK_NATIONAL_HEALTH_SERVICE_NUMBER Номер Национальной службы здравоохранения Великобритании — это число от 10 до 17 цифр, например 485 555 3456 . Текущая система форматирует 10-значное число с пробелами после третьей и шестой цифры. Последняя цифра — это контрольная сумма для обнаружения ошибок.
- UK_NATIONAL_INSURANCE_NUMBER Номер национального страхования Великобритании (NINO) предоставляет лицам доступ к льготам по национальному страхованию (социальному обеспечению). Он также используется для некоторых целей в британской налоговой системе. Число содержит девять цифр и начинается с двух букв, за которыми следуют шесть цифр и одна буква. NINO может быть отформатирован с пробелом или тире после двух букв и после второй, четвертой и шестой цифр.
- UK_UNIQUE_TAXPAYER_REFERENCE_NUMBER Уникальный налоговый идентификатор Великобритании (UTR) — это 10-значное число, которое идентифицирует налогоплательщика или бизнес.
Пользовательский
- Фильтр регулярных выражений - Вы можете использовать регулярные выражения для определения шаблонов, которые AI Guardrail распознает и использует, таких как серийные номера, идентификаторы бронирования и т. д..

action -> (строка)

Настройка действия AI Guardrail при обнаружении сущности PII.

regexesConfig -> (список)

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

(структура)

Регулярное выражение для настройки AI Guardrail.

name -> (строка)

Имя регулярного выражения для настройки AI Guardrail.

description -> (строка)

Описание регулярного выражения для настройки AI Guardrail.

pattern -> (строка)

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

action -> (строка)

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

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

Подробные данные о политике настройки контекстуальной привязки AI Guardrail.

filtersConfig -> (список)

Подробные данные о настройке фильтра AI Guardrail контекстуальной привязки.

(структура)

Подробные данные о настройке фильтра контекстуальной привязки AI Guardrail.

type -> (строка)

Тип фильтра контекстуальной привязки AI Guardrail.

threshold -> (вещественное число)

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

tags -> (карта)

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

key -> (строка)

value -> (строка)

status -> (строка)

Статус AI Guardrail.

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

Время последнего изменения AI Guardrail.

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

Номер версии AI Guardrail.