определение-задачи-объяснимости-модели

Описание

Создает определение задачи объяснения модели.

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

Синтаксис

  create-model-explainability-job-definition
--job-definition-name <value>
[--model-explainability-baseline-config <value>]
--model-explainability-app-specification <value>
--model-explainability-job-input <value>
--model-explainability-job-output-config <value>
--job-resources <value>
[--network-config <value>]
--role-arn <value>
[--stopping-condition <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]

Параметры

--job-definition-name (строка)

Имя определения задачи объяснения модели. Имя должно быть уникальным в данной области Amazon Web Services и для учетной записи Amazon Web Services.

--model-explainability-baseline-config (структура)

Базовая конфигурация для задачи объяснения модели.

BaseliningJobName -> (строка)

Имя базовой задачи объяснения модели.

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

Ресурс ограничений для задачи мониторинга.

S3Uri -> (строка)

Amazon S3 URI для ресурса ограничений.

Краткая запись:

BaseliningJobName=string,ConstraintsResource={S3Uri=string}

Синтаксис JSON:

{
  "BaseliningJobName": "string",
  "ConstraintsResource": {
    "S3Uri": "string"
  }
}

--model-explainability-app-specification (структура)

Настраивает задачу объяснения модели для запуска указанного Docker контейнера.

ImageUri -> (строка)

Изображение контейнера, которое будет запущено задачей объяснения модели.

ConfigUri -> (строка)

Файл Amazon S3 в формате JSON, определяющий параметры объяснения. Для получения дополнительной информации об этом файле конфигурации JSON, см. Настройка параметров объяснения модели.

Environment -> (отображение)

Устанавливает переменные окружения в контейнере Docker.

key -> (строка)

value -> (строка)

Краткая запись:

ImageUri=string,ConfigUri=string,Environment={KeyName1=string,KeyName2=string}

Синтаксис JSON:

{
  "ImageUri": "string",
  "ConfigUri": "string",
  "Environment": {"string": "string"
    ...}
}

--model-explainability-job-input (структура)

Входные данные для задачи объяснения модели.

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

Объект входных данных для конечной точки

EndpointName -> (строка)

Конечная точка в учетной записи клиента, которая имеет включенную DataCaptureConfig.

LocalPath -> (строка)

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

S3InputMode -> (строка)

Метод использования данных из Amazon S3 в качестве входных данных для передачи данных для задачи мониторинга. Режим Pipe рекомендуется для больших наборов данных. Режим File полезен для небольших файлов, которые помещаются в оперативную память. По умолчанию - File.

S3DataDistributionType -> (строка)

Способ распределения входных данных в Amazon S3: полное дублирование или фрагментация по ключу Amazon S3. По умолчанию - FullyReplicated.

FeaturesAttribute -> (строка)

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

InferenceAttribute -> (строка)

Атрибут входных данных, представляющий фактическое значение метки.

ProbabilityAttribute -> (строка)

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

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

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

StartTimeOffset -> (строка)

Если указано, задачи мониторинга вычитают это время из начального времени. Для получения информации об использовании смещений для планирования задач мониторинга, см. Планирование задач мониторинга качества модели.

EndTimeOffset -> (строка)

Если указано, задачи мониторинга вычитают это время из конечного времени. Для получения информации об использовании смещений для планирования задач мониторинга, см. Планирование задач мониторинга качества модели.

ExcludeFeaturesAttribute -> (строка)

Атрибуты входных данных, которые следует исключить из анализа.

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

Объект входных данных для задачи пакетной трансформации.

DataCapturedDestinationS3Uri -> (строка)

Расположение Amazon S3 для захвата данных.

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

Формат набора данных для задачи пакетной трансформации.

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

Набор данных CSV, используемый в задаче мониторинга.

Header -> (булево)

Указывает, содержит ли данные CSV заголовок.

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

Набор данных JSON, используемый в задаче мониторинга

Line -> (булево)

Указывает, следует ли читать файл как объект JSON на каждой строке.

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

Набор данных Parquet, используемый в задаче мониторинга

LocalPath -> (строка)

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

S3InputMode -> (строка)

S3DataDistributionType -> (строка)

Способ распределения входных данных в Amazon S3: полное дублирование или фрагментация по ключу S3. По умолчанию - FullyReplicated.

FeaturesAttribute -> (строка)

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

InferenceAttribute -> (строка)

Атрибут входных данных, представляющий фактическое значение метки.

ProbabilityAttribute -> (строка)

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

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

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

StartTimeOffset -> (строка)

EndTimeOffset -> (строка)

ExcludeFeaturesAttribute -> (строка)

Атрибуты входных данных, которые следует исключить из анализа.

Синтаксис JSON:

{
  "EndpointInput": {
    "EndpointName": "string",
    "LocalPath": "string",
    "S3InputMode": "Pipe"|"File",
    "S3DataDistributionType": "FullyReplicated"|"ShardedByS3Key",
    "FeaturesAttribute": "string",
    "InferenceAttribute": "string",
    "ProbabilityAttribute": "string",
    "ProbabilityThresholdAttribute": double,
    "StartTimeOffset": "string",
    "EndTimeOffset": "string",
    "ExcludeFeaturesAttribute": "string"
  },
  "BatchTransformInput": {
    "DataCapturedDestinationS3Uri": "string",
    "DatasetFormat": {
      "Csv": {
        "Header": true|false
      },
      "Json": {
        "Line": true|false
      },
      "Parquet": {

      }
    },
    "LocalPath": "string",
    "S3InputMode": "Pipe"|"File",
    "S3DataDistributionType": "FullyReplicated"|"ShardedByS3Key",
    "FeaturesAttribute": "string",
    "InferenceAttribute": "string",
    "ProbabilityAttribute": "string",
    "ProbabilityThresholdAttribute": double,
    "StartTimeOffset": "string",
    "EndTimeOffset": "string",
    "ExcludeFeaturesAttribute": "string"
  }
}

--model-explainability-job-output-config (структура)

Конфигурация вывода для задач мониторинга.

MonitoringOutputs -> (список)

Выходные данные мониторинга для задач мониторинга. Здесь загружаются результаты периодических задач мониторинга.

(структура)

Объект вывода для задачи мониторинга.

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

Место хранения Amazon S3, куда сохраняются результаты задачи мониторинга.

S3Uri -> (строка)

URI, определяющий расположение Amazon S3, куда Amazon SageMaker AI сохраняет результаты задачи мониторинга.

LocalPath -> (строка)

Локальный путь к расположению Amazon S3, куда Amazon SageMaker AI сохраняет результаты задачи мониторинга. LocalPath — это абсолютный путь к выходным данным.

S3UploadMode -> (строка)

Способ загрузки результатов задачи мониторинга: непрерывно или по завершении задачи.

KmsKeyId -> (строка)

Ключ Key Management Service (KMS), используемый Amazon SageMaker AI для шифрования артефактов моделей в состоянии покоя с использованием шифрования Amazon S3 на стороне сервера.

Синтаксис JSON:

{
  "MonitoringOutputs": [
    {
      "S3Output": {
        "S3Uri": "string",
        "LocalPath": "string",
        "S3UploadMode": "Continuous"|"EndOfJob"
      }
    }
    ...
  ],
  "KmsKeyId": "string"
}

--job-resources (структура)

Идентифицирует ресурсы для развертывания в задаче мониторинга.

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

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

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

Количество экземпляров вычислительных ресурсов ML, используемых в задаче мониторинга моделей. Для задач распределенной обработки укажите значение больше 1. По умолчанию 1.

InstanceType -> (строка)

Тип вычислительного экземпляра ML для задачи обработки.

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

Размер ML-хранилища в гигабайтах, которое необходимо зарезервировать. Необходимо указать достаточный объем ML-хранилища для вашего сценария.

VolumeKmsKeyId -> (строка)

Ключ Key Management Service (KMS), используемый Amazon SageMaker AI для шифрования данных на томе хранилища, подключенном к экземплярам вычислительных ресурсов ML, выполняющим задачу мониторинга моделей.

Краткая запись:

ClusterConfig={InstanceCount=integer,InstanceType=string,VolumeSizeInGB=integer,VolumeKmsKeyId=string}

Синтаксис JSON:

{
  "ClusterConfig": {
    "InstanceCount": integer,
    "InstanceType": "ml.t3.medium"|"ml.t3.large"|"ml.t3.xlarge"|"ml.t3.2xlarge"|"ml.m4.xlarge"|"ml.m4.2xlarge"|"ml.m4.4xlarge"|"ml.m4.10xlarge"|"ml.m4.16xlarge"|"ml.c4.xlarge"|"ml.c4.2xlarge"|"ml.c4.4xlarge"|"ml.c4.8xlarge"|"ml.p2.xlarge"|"ml.p2.8xlarge"|"ml.p2.16xlarge"|"ml.p3.2xlarge"|"ml.p3.8xlarge"|"ml.p3.16xlarge"|"ml.c5.xlarge"|"ml.c5.2xlarge"|"ml.c5.4xlarge"|"ml.c5.9xlarge"|"ml.c5.18xlarge"|"ml.m5.large"|"ml.m5.xlarge"|"ml.m5.2xlarge"|"ml.m5.4xlarge"|"ml.m5.12xlarge"|"ml.m5.24xlarge"|"ml.r5.large"|"ml.r5.xlarge"|"ml.r5.2xlarge"|"ml.r5.4xlarge"|"ml.r5.8xlarge"|"ml.r5.12xlarge"|"ml.r5.16xlarge"|"ml.r5.24xlarge"|"ml.g4dn.xlarge"|"ml.g4dn.2xlarge"|"ml.g4dn.4xlarge"|"ml.g4dn.8xlarge"|"ml.g4dn.12xlarge"|"ml.g4dn.16xlarge"|"ml.g5.xlarge"|"ml.g5.2xlarge"|"ml.g5.4xlarge"|"ml.g5.8xlarge"|"ml.g5.16xlarge"|"ml.g5.12xlarge"|"ml.g5.24xlarge"|"ml.g5.48xlarge"|"ml.r5d.large"|"ml.r5d.xlarge"|"ml.r5d.2xlarge"|"ml.r5d.4xlarge"|"ml.r5d.8xlarge"|"ml.r5d.12xlarge"|"ml.r5d.16xlarge"|"ml.r5d.24xlarge"|"ml.g6.xlarge"|"ml.g6.2xlarge"|"ml.g6.4xlarge"|"ml.g6.8xlarge"|"ml.g6.12xlarge"|"ml.g6.16xlarge"|"ml.g6.24xlarge"|"ml.g6.48xlarge"|"ml.g6e.xlarge"|"ml.g6e.2xlarge"|"ml.g6e.4xlarge"|"ml.g6e.8xlarge"|"ml.g6e.12xlarge"|"ml.g6e.16xlarge"|"ml.g6e.24xlarge"|"ml.g6e.48xlarge"|"ml.m6i.large"|"ml.m6i.xlarge"|"ml.m6i.2xlarge"|"ml.m6i.4xlarge"|"ml.m6i.8xlarge"|"ml.m6i.12xlarge"|"ml.m6i.16xlarge"|"ml.m6i.24xlarge"|"ml.m6i.32xlarge"|"ml.c6i.xlarge"|"ml.c6i.2xlarge"|"ml.c6i.4xlarge"|"ml.c6i.8xlarge"|"ml.c6i.12xlarge"|"ml.c6i.16xlarge"|"ml.c6i.24xlarge"|"ml.c6i.32xlarge",
    "VolumeSizeInGB": integer,
    "VolumeKmsKeyId": "string"
  }
}

--network-config (структура)

Параметры сети для задачи объяснения модели.

EnableInterContainerTrafficEncryption -> (булево)

Включает шифрование всех сообщений между экземплярами, используемыми для задач мониторинга. Выберите True для шифрования сообщений. Шифрование обеспечивает большую безопасность для распределенных задач, но обработка может занять больше времени.

EnableNetworkIsolation -> (булево)

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

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

Определяет виртуальную частную сеть Amazon VPC, к которой имеют доступ ваши задачи SageMaker, размещенные модели и вычислительные ресурсы. Вы можете контролировать доступ к ресурсам, настраивая VPC. Дополнительную информацию см. в разделе Предоставление SageMaker доступа к ресурсам в вашей виртуальной частной сети Amazon VPC.

SecurityGroupIds -> (список)

ID групп безопасности VPC в формате sg-xxxxxxxx. Укажите группы безопасности для VPC, указанной в поле Subnets.

(строка)

Subnets -> (список)

ID подсетей в VPC, к которым вы хотите подключить свою задачу обучения или модель. Информацию о доступности определенных типов экземпляров см. в разделе Поддерживаемые типы экземпляров и доступные зоны.

(строка)

Краткая запись:

EnableInterContainerTrafficEncryption=boolean,EnableNetworkIsolation=boolean,VpcConfig={SecurityGroupIds=[string,string],Subnets=[string,string]}

Синтаксис JSON:

{
  "EnableInterContainerTrafficEncryption": true|false,
  "EnableNetworkIsolation": true|false,
  "VpcConfig": {
    "SecurityGroupIds": ["string", ...],
    "Subnets": ["string", ...]
  }
}

--role-arn (строка)

Amazon Resource Name (ARN) роли IAM, которую Amazon SageMaker AI может использовать для выполнения задач от вашего имени.

--stopping-condition (структура)

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

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

Максимальное время выполнения в секундах.

Примечание

Максимальное время выполнения MaxRuntimeInSeconds не может превышать частоты задачи. Для качества данных и объяснения модели это может составлять до 3600 секунд для ежечасного расписания. Для ежечасных расписаний смещения модели и качества модели это может составлять до 1800 секунд.

Краткая запись:

MaxRuntimeInSeconds=integer

Синтаксис JSON:

{
  "MaxRuntimeInSeconds": integer
}

--tags (список)

(Необязательно) Массив пар ключ-значение. Дополнительную информацию см. в руководстве пользователя Amazon Web Services по выставлению счетов и управлению затратами Amazon Web Services Billing and Cost Management User Guide.

(структура)

Объект тега, состоящий из ключа и необязательного значения, используемый для управления метаданными для ресурсов SageMaker Amazon Web Services.

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

Дополнительную информацию об добавлении метаданных к вашим ресурсам Amazon Web Services с помощью тегов см. в разделе Tagging Amazon Web Services resources . Советы по лучшим практикам управления ресурсами Amazon Web Services с помощью тегов см. в разделе Tagging Best Practices: Implement an Effective Amazon Web Services Resource Tagging Strategy .

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

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

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

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

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "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.

Вывод

JobDefinitionArn -> (строка)

Amazon Resource Name (ARN) задания модели по объяснению.