describe-auto-ml-job-v2
Описание
Возвращает информацию о задаче AutoML, созданной с помощью вызова CreateAutoMLJobV2 или CreateAutoMLJob.
См. также: Документация API AWS
Синтаксис
describe-auto-ml-job-v2
--auto-ml-job-name <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]
Параметры
--auto-ml-job-name (строка)
--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
- таблица
- 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.
Выходные данные
AutoMLJobName -> (строка)
AutoMLJobArn -> (строка)
AutoMLJobInputDataConfig -> (список)
Возвращает массив объектов каналов, описывающих входные данные и их расположение.
(структура)
Канал — это именованный источник входных данных, которые могут потреблять алгоритмы обучения. Этот канал используется для задач AutoML V2 (задачи, созданные с помощью вызова CreateAutoMLJobV2).
ChannelType -> (строка)
Тип канала. Определяет, используются ли данные для обучения или валидации. Значение по умолчанию — training. Каналы для training и validation должны использовать один и тот же ContentType
Примечание
Тип канала по умолчанию —training для типа задачи прогнозирования временных рядов.ContentType -> (строка)
Тип содержимого данных из источника входных данных. Ниже приведены разрешенные типы содержимого для различных задач:
- Для задач с табличными типами данных:
text/csv;header=presentилиx-application/vnd.amazon+parquet. Значение по умолчанию —text/csv;header=present. - Для задач классификации изображений:
image/png,image/jpegилиimage/*. Значение по умолчанию —image/*. - Для задач классификации текста:
text/csv;header=presentилиx-application/vnd.amazon+parquet. Значение по умолчанию —text/csv;header=present. - Для задач прогнозирования временных рядов:
text/csv;header=presentилиx-application/vnd.amazon+parquet. Значение по умолчанию —text/csv;header=present. - Для задач генерации текста (тонкая настройка ЛМ):
text/csv;header=presentилиx-application/vnd.amazon+parquet. Значение по умолчанию —text/csv;header=present.
CompressionType -> (строка)
Gzip для входных данных S3Prefix только для табличных данных. Для всех остальных входных данных тип сжатия должен быть None. Если тип сжатия не указан, мы используем значение по умолчанию — None.DataSource -> (структура)
Источник данных для канала AutoML (обязательно).
S3DataSource -> (структура)
Расположение входных данных в Amazon S3.
S3DataType -> (строка)
Тип данных.
- Если вы выберете
S3Prefix,S3Uriопределяет префикс имени ключа. SageMaker AI использует все объекты, соответствующие указанному префиксу имени ключа, для обучения модели.S3Prefixдолжен иметь следующий формат:s3://DOC-EXAMPLE-BUCKET/DOC-EXAMPLE-FOLDER-OR-FILE - Если вы выберете
ManifestFile,S3Uriопределяет объект, который является файлом манифеста, содержащим список ключей объектов, которые вы хотите использовать для обучения модели SageMaker AI. ФайлManifestFileдолжен иметь формат, показанный ниже:[ {"prefix": "s3://DOC-EXAMPLE-BUCKET/DOC-EXAMPLE-FOLDER/DOC-EXAMPLE-PREFIX/"},"DOC-EXAMPLE-RELATIVE-PATH/DOC-EXAMPLE-FOLDER/DATA-1","DOC-EXAMPLE-RELATIVE-PATH/DOC-EXAMPLE-FOLDER/DATA-2",... "DOC-EXAMPLE-RELATIVE-PATH/DOC-EXAMPLE-FOLDER/DATA-N" ] - Если вы выберете
AugmentedManifestFile,S3Uriопределяет объект, который является расширенным файлом манифеста в формате JSON-строк. Этот файл содержит данные, которые вы хотите использовать для обучения модели.AugmentedManifestFileдоступен только для задач API V2 (например, для задач, созданных с помощью вызоваCreateAutoMLJobV2). Вот минимальный пример одного запися в форматеAugmentedManifestFile:{"source-ref": "s3://DOC-EXAMPLE-BUCKET/DOC-EXAMPLE-FOLDER/cats/cat.jpg","label-metadata": {"class-name": "cat"} Для получения дополнительной информации оAugmentedManifestFile, см. Provide Dataset Metadata to Training Jobs with an Augmented Manifest File.
S3Uri -> (строка)
OutputDataConfig -> (структура)
Возвращает конфигурацию выходных данных задачи.
KmsKeyId -> (строка)
S3OutputPath -> (строка)
RoleArn -> (строка)
AutoMLJobObjective -> (структура)
Возвращает цель задачи.
MetricName -> (строка)
Имя метрики цели, используемой для измерения качества прогнозирования системы машинного обучения. Во время обучения параметры модели обновляются итеративно для оптимизации ее производительности на основе обратной связи, предоставленной метрикой цели при оценке модели на наборе валидации.
Список доступных метрик, поддерживаемых Autopilot, и метрика по умолчанию, применяемая, если вы не укажете имя метрики явно, зависят от типа задачи.
-
Для задач с табличными типами данных:
- Список доступных метрик:
- Регрессия:
MAE,MSE,R2,RMSE - Бинарная классификация:
Accuracy,AUC,BalancedAccuracy,F1,Precision,Recall - Многоклассовая классификация:
Accuracy,BalancedAccuracy,F1macro,PrecisionMacro,RecallMacro
- Регрессия:
Описание каждой метрики см. в Autopilot metrics for classification and regression.
- Метрики цели по умолчанию:
- Регрессия:
MSE. - Бинарная классификация:
F1. - Многоклассовая классификация:
Accuracy.
- Регрессия:
- Список доступных метрик:
-
Для задач классификации изображений или текста:
- Список доступных метрик:
Accuracy. Описание каждой метрики см. в Autopilot metrics for text and image classification. - Метрики цели по умолчанию:
Accuracy
- Список доступных метрик:
-
Для задач прогнозирования временных рядов:
- Список доступных метрик:
RMSE,wQL,Average wQL,MASE,MAPE,WAPE. Описание каждой метрики см. в Autopilot metrics for time-series forecasting. - Метрики цели по умолчанию:
AverageWeightedQuantileLoss
- Список доступных метрик:
-
Для задач генерации текста (тонкая настройка ЛМ): Для тонкой настройки языковых моделей в Autopilot не требуется устанавливать поле
AutoMLJobObjective. Autopilot производит тонкую настройку ЛМ без необходимости обучения и оценки нескольких кандидатов. Вместо этого, используя ваш набор данных, Autopilot напрямую производит тонкую настройку вашей целевой модели для повышения метрики цели по умолчанию — кросс-энтропийной потери. После тонкой настройки языковой модели вы можете оценить качество сгенерированного текста с помощью различных метрик. Список доступных метрик см. в Metrics for fine-tuning LLMs in Autopilot.
AutoMLProblemTypeConfig -> (структура помеченного объединения)
Возвращает настройки конфигурации типа задачи, установленные для задачи AutoML V2.
Примечание
Это структура помеченного объединения. Можно установить только один из следующих ключей верхнего уровня:ImageClassificationJobConfig, TextClassificationJobConfig, TimeSeriesForecastingJobConfig, TabularJobConfig, TextGenerationJobConfig.ImageClassificationJobConfig -> (структура)
Настройки для конфигурации задачи AutoML V2 для типа задачи классификации изображений.
CompletionCriteria -> (структура)
Время выполнения задачи или количество кандидатов, которые разрешено сгенерировать.
MaxCandidates -> (целое число)
Максимальное количество запусков задачи обучения.
Для задач классификации текста и изображений, прогнозирования временных рядов и генерации текста (тонкая настройка ЛМ) поддерживается значение 1. Для задач с табличными типами данных максимальное значение составляет 750.
MaxRuntimePerTrainingJobInSeconds -> (целое число)
Максимальное время (в секундах) каждого запуска обучения, выполняемого внутри настройки гиперпараметров, разрешенное для запуска в рамках задачи настройки гиперпараметров. Подробнее см. StoppingCondition, используемый действием CreateHyperParameterTuningJob.
Для задач V2 (задачи, созданные с помощью вызова CreateAutoMLJobV2), это поле управляет временем выполнения кандидата задачи.
Для типов задач TextGenerationJobConfig максимальное время по умолчанию составляет 72 часа (259200 секунд).
MaxAutoMLJobRuntimeInSeconds -> (целое число)
Максимальное время выполнения задачи AutoML (в секундах).
Если задача AutoML превышает максимальное время выполнения, задача автоматически останавливается, и ее обработка завершается без ошибок. Задача AutoML определяет лучшую модель, обучение которой было завершено, и помечает ее как лучшую модель. Любые незавершенные этапы задачи, такие как автоматическое развертывание модели Autopilot одним щелчком мыши, не завершаются.
TextClassificationJobConfig -> (структура)
Настройки для конфигурации задачи AutoML V2 для типа задачи классификации текста.
CompletionCriteria -> (структура)
Время выполнения задачи или количество кандидатов, которые разрешено сгенерировать.
MaxCandidates -> (целое число)
Максимальное количество запусков задачи обучения.
Для задач классификации текста и изображений, прогнозирования временных рядов и генерации текста (тонкая настройка ЛМ) поддерживается значение 1. Для задач с табличными типами данных максимальное значение составляет 750.
MaxRuntimePerTrainingJobInSeconds -> (целое число)
Максимальное время (в секундах) каждого запуска обучения, выполняемого внутри настройки гиперпараметров, разрешенное для запуска в рамках задачи настройки гиперпараметров. Подробнее см. StoppingCondition, используемый действием CreateHyperParameterTuningJob.
Для задач V2 (задачи, созданные с помощью вызова CreateAutoMLJobV2), это поле управляет временем выполнения кандидата задачи.
Для типов задач TextGenerationJobConfig максимальное время по умолчанию составляет 72 часа (259200 секунд).
MaxAutoMLJobRuntimeInSeconds -> (целое число)
Максимальное время выполнения задачи AutoML (в секундах).
Если задача AutoML превышает максимальное время выполнения, задача автоматически останавливается, и ее обработка завершается без ошибок. Задача AutoML определяет лучшую модель, обучение которой было завершено, и помечает ее как лучшую модель. Любые незавершенные этапы задачи, такие как автоматическое развертывание модели Autopilot одним щелчком мыши, не завершаются.
ContentColumn -> (строка)
TargetLabelColumn -> (строка)
TimeSeriesForecastingJobConfig -> (структура)
Настройки для конфигурации задания AutoML V2 для типа задачи прогнозирования временных рядов.
FeatureSpecificationS3Uri -> (строка)
URL к источнику данных Amazon S3, содержащему дополнительные выбранные признаки, которые дополняют целевой признак, itemID, отметку времени и сгруппированные столбцы, заданные в TimeSeriesConfig. Если не указано, задание AutoML V2 включает все столбцы из исходного набора данных, которые еще не объявлены в TimeSeriesConfig. Если указано, задание AutoML V2 учитывает только эти дополнительные столбцы как дополнение к столбцам, объявленным в TimeSeriesConfig.
Вы можете ввести FeatureAttributeNames (необязательно) в формате JSON, как показано ниже:
{ "FeatureAttributeNames":["col1", "col2", ...] }.Вы также можете указать тип данных признака (необязательно) в формате, показанном ниже:
{ "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }Autopilot поддерживает следующие типы данных: numeric, categorical, text и datetime.
Примечание
Ключи этих столбцов не должны включать столбцы, заданные вTimeSeriesConfig.CompletionCriteria -> (структура)
Сколько времени разрешено работать заданию или сколько кандидатов разрешено сгенерировать заданию.
MaxCandidates -> (целое число)
Максимальное количество запусков задания обучения.
Для задач классификации текста и изображений, прогнозирования временных рядов, а также генерации текста (тонкой настройки LLMs) поддерживается значение 1. Для табличных задач максимальное значение равно 750.
MaxRuntimePerTrainingJobInSeconds -> (целое число)
Максимальное время (в секундах), которое может работать каждое задание обучения, выполняемое внутри настройки гиперпараметров, как часть задания настройки гиперпараметров. Дополнительную информацию см. в разделе StoppingCondition, используемом действием CreateHyperParameterTuningJob.
Для заданий V2 (задания, созданные путем вызова CreateAutoMLJobV2), этот параметр управляет временем работы кандидата задания.
Для типов заданий TextGenerationJobConfig максимальное время по умолчанию составляет 72 часа (259200 секунд).
MaxAutoMLJobRuntimeInSeconds -> (целое число)
Максимальное время выполнения (в секундах) задания AutoML.
Если задание AutoML превышает максимальное время выполнения, задание автоматически останавливается, и его обработка завершается плавно. Задание AutoML определяет лучшую модель, обучение которой было завершено, и помечает ее как лучшую модель по производительности. Любые незавершенные шаги задания, такие как автоматическое развертывание модели Autopilot одним щелчком мыши, не выполняются.
ForecastFrequency -> (строка)
Частота прогнозов в прогнозе.
Допустимые интервалы — целое число, за которым следуют Y (год), M (месяц), W (неделя), D (день), H (час) и мин (минута). Например, 1D означает каждый день, а 15min — каждые 15 минут. Значение частоты не должно перекрываться со следующей более крупной частотой. Например, вы должны использовать частоту 1H вместо 60min.
Допустимые значения для каждой частоты приведены ниже:
- Минута - 1-59
- Час - 1-23
- День - 1-6
- Неделя - 1-4
- Месяц - 1-11
- Год - 1
ForecastHorizon -> (целое число)
ForecastQuantiles -> (список)
Квантили, используемые для обучения модели для прогнозов в заданном квантиле. Вы можете указать квантили от 0.01 (p1) до 0.99 (p99) с шагом 0,01 или больше. Можно указать до пяти квантилей прогноза. Если ForecastQuantiles не указано, задание AutoML использует квантили p10, p50 и p90 по умолчанию.
(строка)
Transformations -> (структура)
Преобразования, изменяющие определенные атрибуты временного ряда, такие как стратегии заполнения пропущенных значений.
Filling -> (отображение)
Пара ключ-значение, определяющая метод заполнения для столбца, где ключ — имя столбца, а значение — объект, определяющий логику заполнения. Вы можете указать несколько методов заполнения для одного столбца.
Поддерживаемые методы заполнения и их соответствующие параметры:
-
frontfill:none(Поддерживается только для целевого столбца) -
middlefill:zero,value,median,mean,min,max -
backfill:zero,value,median,mean,min,max -
futurefill:zero,value,median,mean,min,max
Чтобы установить метод заполнения для определенного значения, установите параметр fill в выбранное значение метода заполнения (например, "backfill" : "value") и определите значение заполнения в дополнительном параметре, начинающемся с «_value». Например, чтобы установить backfill в значение 2, вы должны включить два параметра: "backfill": "value" и "backfill_value":"2".
key -> (строка)
value -> (отображение)
key -> (строка)
value -> (строка)
Aggregation -> (отображение)
Пара ключ-значение, определяющая метод агрегации для столбца, где ключ — имя столбца, а значение — метод агрегации.
Поддерживаемые методы агрегации: sum (по умолчанию), avg, first, min, max.
Примечание
Агрегация поддерживается только для целевого столбца.key -> (строка)
value -> (строка)
TimeSeriesConfig -> (структура)
Набор компонентов, определяющих временной ряд.
TargetAttributeName -> (строка)
TimestampAttributeName -> (строка)
ItemIdentifierAttributeName -> (строка)
GroupingAttributeNames -> (список)
Набор имен столбцов, которые можно сгруппировать со столбцом идентификатора элементов, чтобы создать составной ключ, для которого предсказывается целевое значение.
(строка)
HolidayConfig -> (список)
Набор атрибутов праздничной обработки данных, используемых для включения информации о национальных праздниках в вашу модель прогнозирования.
(структура)
Хранит атрибуты праздничной обработки данных, применимые к каждому элементу наборов данных временных рядов во время обучения модели прогнозирования. Это позволяет модели определять закономерности, связанные с определенными праздниками.
CountryCode -> (строка)
Код страны для праздничного календаря.
Список общедоступных календарей выходных дней, поддерживаемых заданием AutoML V2, см. в разделе Коды стран. Используйте код страны, соответствующий вашей стране.
CandidateGenerationConfig -> (структура)
Хранит конфигурационную информацию о том, как генерируются кандидаты моделей с помощью задания AutoML V2.
AlgorithmsConfig -> (список)
Ваше задание Autopilot обучает стандартный набор алгоритмов на вашем наборе данных. Для табличных и временных рядов вы можете настроить список алгоритмов, выбрав подмножество алгоритмов для вашего типа задачи.
AlgorithmsConfig хранит настроенный выбор алгоритмов для обучения на ваших данных.-
Для типа задачи табличных данных ``TabularJobConfig`` , список доступных алгоритмов для выбора зависит от режима обучения, установленного в `
AutoMLJobConfig.Modehttps://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AutoMLJobConfig.html`__ .-
AlgorithmsConfigне должен быть задан, когда режим обученияAutoMLJobConfig.Modeустановлен наAUTO. - Когда
AlgorithmsConfigпредоставлен, одинAutoMLAlgorithmsатрибут должен быть установлен и только один. Если список алгоритмов, предоставленных в качестве значений дляAutoMLAlgorithms, пустой,CandidateGenerationConfigиспользует полный набор алгоритмов для данного режима обучения. - Когда
AlgorithmsConfigне предоставлен,CandidateGenerationConfigиспользует полный набор алгоритмов для данного режима обучения.
-
Список всех алгоритмов по каждому режиму обучения см. в AlgorithmConfig.
Дополнительную информацию о каждом алгоритме см. в разделе Поддержка алгоритмов в руководстве разработчика Autopilot.
-
Для типа задачи прогнозирования временных рядов ``TimeSeriesForecastingJobConfig`` , выбирайте свои алгоритмы из списка, предоставленного в AlgorithmConfig. Дополнительную информацию о каждом алгоритме см. в разделе Поддержка алгоритмов для прогнозирования временных рядов в руководстве разработчика Autopilot.
- Когда
AlgorithmsConfigпредоставлен, одинAutoMLAlgorithmsатрибут должен быть установлен и только один. Если список алгоритмов, предоставленных в качестве значений дляAutoMLAlgorithms, пустой,CandidateGenerationConfigиспользует полный набор алгоритмов для прогнозирования временных рядов. - Когда
AlgorithmsConfigне предоставлен,CandidateGenerationConfigиспользует полный набор алгоритмов для прогнозирования временных рядов.
- Когда
(структура)
Выбор алгоритмов, обученных на вашем наборе данных для генерации кандидатов моделей для задания Autopilot.
AutoMLAlgorithms -> (список)
Выбор алгоритмов, обученных на вашем наборе данных для генерации кандидатов моделей для задания Autopilot.
- Для типа задачи табличных данных ``TabularJobConfig`` :
Примечание
ENSEMBLING или HYPERPARAMETER_TUNING ). Выберите как минимум 1 алгоритм.- В режиме
ENSEMBLING:- “catboost”
- “extra-trees”
- “fastai”
- “lightgbm”
- “linear-learner”
- “nn-torch”
- “randomforest”
- “xgboost”
- В режиме
HYPERPARAMETER_TUNING:- “linear-learner”
- “mlp”
- “xgboost”
-
Для типа задачи прогнозирования временных рядов ``TimeSeriesForecastingJobConfig`` :
- Выберите свои алгоритмы из этого списка.
- “cnn-qr”
- “deepar”
- “prophet”
- “arima”
- “npts”
- “ets”
- Выберите свои алгоритмы из этого списка.
(строка)
TabularJobConfig -> (структура)
Настройки для конфигурации задания AutoML V2 для типа задачи табличных данных (регрессия, классификация).
CandidateGenerationConfig -> (структура)
Конфигурация информации о том, как генерируются кандидаты моделей.
AlgorithmsConfig -> (список)
Ваше задание Autopilot обучает набор стандартных алгоритмов на вашем наборе данных. Для табличных и временных рядов вы можете настроить список алгоритмов, выбрав подмножество алгоритмов для вашего типа задачи.
AlgorithmsConfig хранит настроенный выбор алгоритмов для обучения на ваших данных.-
Для типа задачи табличных данных ``TabularJobConfig`` , список доступных алгоритмов зависит от режима обучения, установленного в `
AutoMLJobConfig.Modehttps://docs.aws.amazon.com/sagemaker/latest/APIReference/API_AutoMLJobConfig.html`__ .-
AlgorithmsConfigне должен быть установлен, когда режим обученияAutoMLJobConfig.Modeустановлен наAUTO. - Если
AlgorithmsConfigпредоставлен, должен быть установлен один и только один атрибутAutoMLAlgorithms. Если список алгоритмов, предоставленных в качестве значений дляAutoMLAlgorithms, пустой,CandidateGenerationConfigиспользует полный набор алгоритмов для данного режима обучения. - Если
AlgorithmsConfigне предоставлен,CandidateGenerationConfigиспользует полный набор алгоритмов для данного режима обучения.
-
Список всех алгоритмов для каждого режима обучения см. в AlgorithmConfig.
Дополнительную информацию об каждом алгоритме см. в разделе Поддержка алгоритмов в руководстве разработчика Autopilot.
-
Для типа задачи прогнозирования временных рядов ``TimeSeriesForecastingJobConfig`` , выберите свои алгоритмы из списка, предоставленного в AlgorithmConfig. Дополнительную информацию об каждом алгоритме см. в разделе Поддержка алгоритмов для прогнозирования временных рядов в руководстве разработчика Autopilot.
- Если
AlgorithmsConfigпредоставлен, должен быть установлен один и только один атрибутAutoMLAlgorithms. Если список алгоритмов, предоставленных в качестве значений дляAutoMLAlgorithms, пустой,CandidateGenerationConfigиспользует полный набор алгоритмов для прогнозирования временных рядов. - Если
AlgorithmsConfigне предоставлен,CandidateGenerationConfigиспользует полный набор алгоритмов для прогнозирования временных рядов.
- Если
(структура)
Выбор алгоритмов, обученных на вашем наборе данных для генерации кандидатов моделей для задания Autopilot.
AutoMLAlgorithms -> (список)
Выбор алгоритмов, обученных на вашем наборе данных, для генерации кандидатов моделей для задания Autopilot.
- Для типа задачи табличных данных ``TabularJobConfig`` :
Примечание
ENSEMBLING или HYPERPARAMETER_TUNING ). Выберите не менее 1 алгоритма.- В режиме
ENSEMBLING:- “catboost”
- “extra-trees”
- “fastai”
- “lightgbm”
- “linear-learner”
- “nn-torch”
- “randomforest”
- “xgboost”
- В режиме
HYPERPARAMETER_TUNING:- “linear-learner”
- “mlp”
- “xgboost”
-
Для типа задачи прогнозирования временных рядов ``TimeSeriesForecastingJobConfig`` :
- Выберите свои алгоритмы из этого списка.
- “cnn-qr”
- “deepar”
- “prophet”
- “arima”
- “npts”
- “ets”
- Выберите свои алгоритмы из этого списка.
(строка)
CompletionCriteria -> (структура)
Сколько времени разрешено работать заданию или сколько кандидатов разрешено сгенерировать заданию.
MaxCandidates -> (целое число)
Максимальное количество раз, которое разрешено запускать задание обучения.
Для типов задач текстовой и изобразительной классификации, прогнозирования временных рядов, а также генерации текста (тонкая настройка LLMs) поддерживается значение 1. Для типов задач табличных данных максимальное значение составляет 750.
MaxRuntimePerTrainingJobInSeconds -> (целое число)
Максимальное время в секундах, которое разрешено работать каждому заданию обучения, выполненному в рамках настройки гиперпараметров, как части задания настройки гиперпараметров. Дополнительную информацию см. в поле StoppingCondition, используемом в действии CreateHyperParameterTuningJob.
Для заданий V2 (задания, созданные с помощью вызова CreateAutoMLJobV2 ), это поле контролирует время работы кандидата задания.
Для типов задач TextGenerationJobConfig максимальное время по умолчанию составляет 72 часа (259200 секунд).
MaxAutoMLJobRuntimeInSeconds -> (целое число)
Максимальное время выполнения задания AutoML в секундах.
Если задание AutoML превышает максимальное время выполнения, задание автоматически останавливается, и его обработка завершается плавно. Задание AutoML определяет лучшую модель, обучение которой было завершено, и помечает ее как лучшую модель. Любые незавершенные шаги задания, такие как автоматическое развертывание модели Autopilot одним щелчком мыши, не выполняются.
FeatureSpecificationS3Uri -> (строка)
URL источника данных Amazon S3, содержащий выбранные признаки из входного источника данных для запуска задания Autopilot V2. Вы можете ввести FeatureAttributeNames (необязательно) в формате JSON, как показано ниже:
{ "FeatureAttributeNames":["col1", "col2", ...] } .Вы также можете указать тип данных признака (необязательно) в формате, показанном ниже:
{ "FeatureDataTypes":{"col1":"numeric", "col2":"categorical" ... } }Примечание
Эти ключи столбцов могут не включать целевой столбец.В режиме ансамблирования Autopilot поддерживает только следующие типы данных: numeric , categorical , text и datetime . В режиме HPO Autopilot может поддерживать numeric , categorical , text , datetime и sequence .
Если предоставлен только FeatureDataTypes , ключи столбцов (col1 , col2 ,..) должны быть подмножеством имен столбцов во входных данных.
Если предоставлены как FeatureDataTypes , так и FeatureAttributeNames , то ключи столбцов должны быть подмножеством имен столбцов, предоставленных в FeatureAttributeNames .
Имя ключа FeatureAttributeNames фиксировано. Значения, перечисленные в ["col1", "col2", ...] , чувствительны к регистру и должны быть списком строк, содержащих уникальные значения, являющиеся подмножеством имен столбцов во входных данных. Список предоставленных столбцов не должен включать целевой столбец.
Mode -> (строка)
Метод, используемый Autopilot для обучения данных. Вы можете указать режим вручную или позволить Autopilot выбрать его за вас на основе размера набора данных, выбрав AUTO . В режиме AUTO Autopilot выбирает ENSEMBLING для наборов данных меньше 100 МБ и HYPERPARAMETER_TUNING для больших.
Режим ENSEMBLING использует многоуровневую ансамблевую модель для прогнозирования задач классификации и регрессии непосредственно из вашего набора данных. Эта модель машинного обучения объединяет несколько базовых моделей для создания оптимальной предсказательной модели. Затем она использует метод ансамблирования стекинга для объединения прогнозов входящих членов. Многоуровневая ансамблевая модель может обеспечить лучшую производительность по сравнению с одной моделью, объединяя предсказательные возможности нескольких моделей. Список алгоритмов, поддерживаемых режимом ENSEMBLING, см. в разделе Поддержка алгоритмов Autopilot.
Режим HYPERPARAMETER_TUNING (HPO) использует лучшие гиперпараметры для обучения лучшей версии модели. HPO автоматически выбирает алгоритм для типа задачи, которую вы хотите решить. Затем HPO находит лучшие гиперпараметры в соответствии с вашим целевым метрическим показателем. Список алгоритмов, поддерживаемых режимом HYPERPARAMETER_TUNING, см. в разделе Поддержка алгоритмов Autopilot.
GenerateCandidateDefinitionsOnly -> (булево)
ProblemType -> (строка)
Тип задачи обучения с учителем, доступный для кандидатов моделей задания AutoML V2. Дополнительную информацию см. в разделе Типы задач SageMaker Autopilot.
Примечание
Вы должны указать тип задачи обучения с учителем вProblemType и предоставить метрику AutoMLJobObjective или не указывать ни то, ни другое.TargetAttributeName -> (строка)
SampleWeightAttributeName -> (строка)
При указании это имя столбца указывает, какой столбец набора данных следует рассматривать как веса образцов для использования метрикой задачи при обучении, оценке и выборе лучшей модели. Этот столбец не считается предсказательным признаком. Дополнительную информацию о метриках Autopilot см. в разделе Метрики и валидация.
Веса образцов должны быть числовыми, неотрицательными, причем большие значения указывают, какие строки важнее других. Точки данных, которые имеют недопустимое или нулевое значение веса, исключаются.
Поддержка весов образцов доступна только в режиме ансамблирования.
TextGenerationJobConfig -> (структура)
Настройки, используемые для конфигурации задачи AutoML V2 для типа задачи генерации текста (тонкая настройка LLMs).
Примечание
В настоящее время модели генерации текста, поддерживающие настройку параметров в Autopilot, доступны только в регионах, поддерживаемых Canvas. Обратитесь к документации Canvas для получения полного списка поддерживаемых регионов.CompletionCriteria -> (структура)
Сколько времени разрешено выполняться задаче тонкой настройки. Для типов задач TextGenerationJobConfig атрибут MaxRuntimePerTrainingJobInSeconds в AutoMLJobCompletionCriteria по умолчанию равен 72 ч (259200 с).
MaxCandidates -> (целое число)
Максимальное количество раз, которое разрешено запускать задачу обучения.
Для типов задач классификации текста и изображений, прогнозирования временных рядов, а также тонкой настройки LLMs для генерации текста поддерживается значение 1. Для типов задач с таблицами максимальное значение равно 750.
MaxRuntimePerTrainingJobInSeconds -> (целое число)
Максимальное время в секундах, которое может выполняться каждая задача обучения внутри настройки гиперпараметров в рамках задачи настройки гиперпараметров. Дополнительные сведения см. в разделе StoppingCondition, используемой действием CreateHyperParameterTuningJob.
Для задач V2 (задачи, созданные с помощью вызова CreateAutoMLJobV2 ), это поле управляет временем работы кандидата задачи.
Для типов задач TextGenerationJobConfig максимальное время по умолчанию равно 72 часам (259200 секундам).
MaxAutoMLJobRuntimeInSeconds -> (целое число)
Максимальное время в секундах, которое требуется задаче AutoML для завершения.
Если задача AutoML превышает максимальное время выполнения, она останавливается автоматически, и ее обработка завершается плавно. Задача AutoML определяет лучшую модель, обучение которой было завершено, и отмечает ее как лучшую модель по производительности. Любые незавершенные этапы задачи, такие как автоматическое развертывание модели Autopilot одним щелчком мыши, не завершаются.
BaseModelName -> (строка)
BaseModelName не предоставлено, используемая по умолчанию модель — Falcon7BInstruct.TextGenerationHyperParameters -> (карта)
Гиперпараметры, используемые для конфигурации и оптимизации процесса обучения базовой модели. Для всех базовых моделей можно задать любое сочетание следующих гиперпараметров. Дополнительные сведения о каждом поддерживаемом гиперпараметре см. в разделе Оптимизация процесса обучения ваших моделей генерации текста с помощью гиперпараметров.
-
"epochCount": Количество раз, когда модель проходит через весь набор данных обучения. Его значение должно быть строкой, содержащей целое число в диапазоне от «1» до «10». -
"batchSize": Количество образцов данных, используемых в каждом цикле обучения. Его значение должно быть строкой, содержащей целое число в диапазоне от «1» до «64». -
"learningRate": Шаг, с которым обновляются параметры модели во время обучения. Его значение должно быть строкой, содержащей значение с плавающей точкой в диапазоне от «0» до «1». -
"learningRateWarmupSteps": Количество шагов обучения, во время которых скорость обучения постепенно увеличивается, прежде чем достичь целевого или максимального значения. Его значение должно быть строкой, содержащей целое число в диапазоне от «0» до «250».
Вот пример, где все четыре гиперпараметра настроены.
{ "epochCount":"5", "learningRate":"0.5", "batchSize": "32", "learningRateWarmupSteps": "10" }ключ -> (строка)
значение -> (строка)
ModelAccessConfig -> (структура)
Файл конфигурации доступа для управления доступом к модели ML. Вы можете явно принять соглашение об использовании модели конечным пользователем (EULA) в ModelAccessConfig.
- Если вы пользователь Jumpstart, см. раздел Соглашения об использовании модели конечным пользователем для получения дополнительной информации о принятии соглашения об использовании модели конечным пользователем.
- Если вы пользователь AutoML, см. раздел «Дополнительные параметры» в разделе «Создание задачи AutoML для тонкой настройки моделей генерации текста с помощью API» для получения информации о том, как установить принятие соглашения об использовании модели конечным пользователем при настройке модели с помощью API AutoML.
AcceptEula -> (булево)
AcceptEula должно быть явно определено как True, чтобы принять EULA, требуемую этой моделью. Вы несете ответственность за ознакомление и соблюдение любых применимых лицензионных условий и убедитесь, что они подходят для вашего случая использования, прежде чем загружать или использовать модель.AutoMLProblemTypeConfigName -> (строка)
CreationTime -> (метка времени)
EndTime -> (метка времени)
LastModifiedTime -> (метка времени)
FailureReason -> (строка)
PartialFailureReasons -> (список)
Возвращает список причин частичных сбоев в задаче AutoML V2.
(структура)
Причина частичного сбоя задачи AutoML.
PartialFailureMessage -> (строка)
BestCandidate -> (структура)
Информация о кандидате, созданном задачей обучения AutoML V2, включая ее состояние, этапы и другие свойства.
CandidateName -> (строка)
FinalAutoMLJobObjectiveMetric -> (структура)
Результат лучшего кандидата из задачи обучения AutoML.
Type -> (строка)
MetricName -> (строка)
Value -> (число с плавающей точкой)
StandardMetricName -> (строка)
ObjectiveStatus -> (строка)
CandidateSteps -> (список)
Информация об этапах кандидата.
(структура)
Информация об этапах кандидата и о том, над каким этапом он работает.
CandidateStepType -> (строка)
CandidateStepArn -> (строка)
CandidateStepName -> (строка)
CandidateStatus -> (строка)
InferenceContainers -> (список)
Информация о рекомендуемых определениях контейнеров для вывода.
(структура)
Список определений контейнеров, описывающих различные контейнеры, составляющие кандидата AutoML. Дополнительные сведения см. в ContainerDefinition.
Image -> (строка)
ModelDataUrl -> (строка)
Environment -> (карта)
Переменные среды, которые необходимо установить в контейнере. Дополнительные сведения см. в ContainerDefinition.
ключ -> (строка)
значение -> (строка)
CreationTime -> (метка времени)
EndTime -> (метка времени)
LastModifiedTime -> (метка времени)
FailureReason -> (строка)
CandidateProperties -> (структура)
Свойства задачи кандидата AutoML.
CandidateArtifactLocations -> (структура)
Префикс Amazon S3 к артефактам, сгенерированным для кандидата AutoML.
Explainability -> (строка)
ModelInsights -> (строка)
BacktestResults -> (строка)
CandidateMetrics -> (список)
Информация о метриках кандидата для задачи AutoML.
(структура)
Информация о метрике для кандидата, созданного задачей AutoML.
MetricName -> (строка)
StandardMetricName -> (строка)
Имя стандартной метрики.
Примечание
Определения стандартных метрик см. в `Autopilot candidate metrics https://docs.aws.amazon.com/sagemaker/latest/dg/autopilot-model-support-validation.html#autopilot-metrics`__ .Value -> (число с плавающей точкой)
Set -> (строка)
InferenceContainerDefinitions -> (карта)
Сопоставление всех поддерживаемых процессорных единиц (CPU, GPU и т. д.) с определениями контейнеров для вывода для кандидата. Это поле заполняется для задач AutoML V2 (например, для задач, созданных с помощью вызова CreateAutoMLJobV2 ) только для типов задач классификации изображений или текста.
ключ -> (строка)
CPU или GPU.значение -> (список)
Информация о рекомендуемых определениях контейнеров для вывода.
(структура)
Список определений контейнеров, описывающих различные контейнеры, составляющие кандидата AutoML. Дополнительные сведения см. в ContainerDefinition.
Image -> (строка)
ModelDataUrl -> (строка)
Environment -> (карта)
Переменные среды, которые необходимо установить в контейнере. Дополнительные сведения см. в ContainerDefinition.
ключ -> (строка)
значение -> (строка)
AutoMLJobStatus -> (строка)
AutoMLJobSecondaryStatus -> (строка)
AutoMLJobArtifacts -> (структура)
Артефакты, созданные во время задачи AutoML.
CandidateDefinitionNotebookLocation -> (строка)
DataExplorationNotebookLocation -> (строка)
ResolvedAttributes -> (структура)
Возвращает разрешённые атрибуты, используемые задачей AutoML v2.
AutoMLJobObjective -> (структура)
Определяет метрику для минимизации или максимизации как цель задачи AutoML.
MetricName -> (строка)
Имя целевой метрики, используемой для измерения качества предсказательной модели машинного обучения. Во время обучения параметры модели итеративно обновляются для оптимизации производительности на основе обратной связи, предоставляемой целевой метрикой при оценке модели на проверочном наборе данных.
Список доступных метрик, поддерживаемых Autopilot, и значение метрики по умолчанию, если вы не указываете имя метрики явно, зависят от типа задачи.
-
Для задач с табличными данными:
- Список доступных метрик:
- Регрессия:
MAE,MSE,R2,RMSE - Бинарная классификация:
Accuracy,AUC,BalancedAccuracy,F1,Precision,Recall - Мультикатегориальная классификация:
Accuracy,BalancedAccuracy,F1macro,PrecisionMacro,RecallMacro
- Регрессия:
Описание каждой метрики см. в разделе Метрики Autopilot для классификации и регрессии.
- Метрики по умолчанию:
- Регрессия:
MSE. - Бинарная классификация:
F1. - Мультикатегориальная классификация:
Accuracy.
- Регрессия:
- Список доступных метрик:
-
Для задач классификации изображений или текста:
- Список доступных метрик:
Accuracy. Описание каждой метрики см. в разделе Метрики Autopilot для классификации текста и изображений. - Метрики по умолчанию:
Accuracy
- Список доступных метрик:
-
Для задач прогнозирования временных рядов:
- Список доступных метрик:
RMSE,wQL,Average wQL,MASE,MAPE,WAPE. Описание каждой метрики см. в разделе Метрики Autopilot для прогнозирования временных рядов. - Метрики по умолчанию:
AverageWeightedQuantileLoss
- Список доступных метрик:
-
Для задач генерации текста (тонкая настройка моделей LLMs): Тонкая настройка языковых моделей в Autopilot не требует задания поля
AutoMLJobObjective. Autopilot выполняет тонкую настройку LLMs без необходимости обучения и оценки нескольких кандидатов. Вместо этого, используя ваш набор данных, Autopilot напрямую настраивает целевую модель для улучшения значения метрики по умолчанию — кросс-энтропии. После тонкой настройки языковой модели вы можете оценить качество сгенерированного текста с использованием различных метрик. Список доступных метрик см. в разделе Метрики для тонкой настройки LLMs в Autopilot.
CompletionCriteria -> (структура)
Устанавливает время работы задачи или количество генерируемых кандидатов.
MaxCandidates -> (целое число)
Максимальное количество запусков задачи обучения.
Для задач классификации текста и изображений, прогнозирования временных рядов, а также генерации текста (тонкая настройка моделей LLMs) поддерживается значение 1. Для задач с табличными данными максимальное значение равно 750.
MaxRuntimePerTrainingJobInSeconds -> (целое число)
Максимальное время (в секундах) работы каждой задачи обучения, выполняемой в рамках задачи настройки гиперпараметров. Дополнительную информацию см. в разделе StoppingCondition, используемой действием CreateHyperParameterTuningJob.
Для задач v2 (задачи, созданные с помощью вызова CreateAutoMLJobV2), это поле контролирует время работы кандидата задачи.
Для задач TextGenerationJobConfig максимальное время по умолчанию составляет 72 часа (259200 секунд).
MaxAutoMLJobRuntimeInSeconds -> (целое число)
Максимальное время (в секундах) работы задачи AutoML.
Если задача AutoML превышает максимальное время работы, задача останавливается автоматически, и её обработка завершается корректно. Задача AutoML определяет лучшую модель, обучение которой было завершено, и помечает её как лучшую модель. Любые незавершенные этапы работы, такие как автоматическое развертывание модели Autopilot одним щелчком мыши, не завершаются.
AutoMLProblemTypeResolvedAttributes -> (структура помеченного объединения)
Определяет разрешённые атрибуты, специфичные для типа задачи.
Примечание
Это структура помеченного объединения. Только один из следующих верхнеуровневых ключей может быть установлен:TabularResolvedAttributes, TextGenerationResolvedAttributes.TabularResolvedAttributes -> (структура)
Разрешённые атрибуты для задач с табличными данными.
ProblemType -> (строка)
TextGenerationResolvedAttributes -> (структура)
Разрешённые атрибуты для задач генерации текста.
BaseModelName -> (строка)
ModelDeployConfig -> (структура)
Указывает, была ли модель автоматически развернута на конечной точке и имя этой конечной точки, если она была развернута автоматически.
AutoGenerateEndpointName -> (булево)
Установите в значение True, чтобы автоматически сгенерировать имя конечной точки для развертывания модели Autopilot одним щелчком мыши; установите в значение False в противном случае. Значение по умолчанию — False.
Примечание
Если вы установитеAutoGenerateEndpointName в значение True, не указывайте EndpointName; в противном случае будет возвращена ошибка 400.EndpointName -> (строка)
Указывает имя конечной точки для использования при развертывании модели Autopilot одним щелчком мыши, если имя конечной точки не генерируется автоматически.
Примечание
УкажитеEndpointName только в том случае, если вы установите AutoGenerateEndpointName в значение False; в противном случае будет возвращена ошибка 400.ModelDeployResult -> (структура)
Предоставляет информацию о конечной точке для развертывания модели.
EndpointName -> (строка)
Имя конечной точки, на которую развернута модель.
Примечание
Если развертывание модели завершается ошибкой, это поле опускается из ответа.DataSplitConfig -> (структура)
Возвращает параметры настройки разделения данных на обучающий и проверочный наборы данных.
ValidationFraction -> (вещественное число)
SecurityConfig -> (структура)
Возвращает настройки безопасности для шифрования трафика или параметров Amazon VPC.
VolumeKmsKeyId -> (строка)
EnableInterContainerTrafficEncryption -> (булево)
VpcConfig -> (структура)
Настройки VPC.
SecurityGroupIds -> (список)
Идентификаторы групп безопасности VPC в формате sg-xxxxxxxx . Укажите группы безопасности для VPC, указанной в поле Subnets.
(строка)
Subnets -> (список)
Идентификатор подсетей в VPC, к которому вы хотите подключить задачу обучения или модель. Сведения о доступности определённых типов экземпляров см. в разделе Поддерживаемые типы экземпляров и доступные зоны.
(строка)
AutoMLComputeConfig -> (структура)
Настройки вычислений, используемые для задачи AutoML v2.
EmrServerlessComputeConfig -> (структура)
Настройки для использования EMR Serverless для выполнения задачи AutoML v2.
Чтобы ваша задача AutoML v2 могла автоматически инициировать удалённую задачу на EMR Serverless при необходимости дополнительных вычислительных ресурсов для обработки больших наборов данных, вам необходимо предоставить объект EmrServerlessComputeConfig, который включает атрибут ExecutionRoleARN, в запрос ввода задачи AutoML v2.
Благодаря плавному переходу на EMR Serverless при необходимости задача AutoML может обрабатывать наборы данных, которые в противном случае превышают первоначально предоставленные ресурсы, без вашего вмешательства.
EMR Serverless доступен для задач с табличными и временными рядами. Рекомендуется использовать этот вариант для наборов данных с табличными данными, большими чем 5 ГБ, и наборов данных временных рядов, большими чем 30 ГБ.
ExecutionRoleARN -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.