Freigeben über


ReinforcementLearningConfiguration Klasse

Stellt die Konfiguration für Verstärkungslernläufe dar, die auf Azure Machine Learning-Computeziele abzielen.

Das ReinforcementLearningConfiguration -Objekt kapselt die informationen, die zum Übermitteln eines Verstärkungslernlaufs in einem Experiment erforderlich sind. Sie enthält Informationen zu Head, Workern und Computezielen zum Ausführen von Experimentläufen.

Konstruktor

ReinforcementLearningConfiguration(head_configuration, worker_configuration, max_run_duration_seconds=None, cluster_coordination_timeout_seconds=None, source_directory=None, _path=None, _name=None, framework=None)

Parameter

Name Beschreibung
head_configuration
Erforderlich

Die Konfiguration für Head.

worker_configuration
Erforderlich

Die Konfiguration für die Mitarbeiter.

max_run_duration_seconds
Erforderlich
int

Die maximal zulässige Zeit für die Ausführung in Sekunden. Azure ML versucht, den Auftrag automatisch abzubrechen, wenn er länger dauert als dieser Wert.

cluster_coordination_timeout_seconds
Erforderlich
int

Die maximale Zeit in Sekunden, die der Auftrag dauern kann, bis er gestartet werden kann, nachdem er den Zustand in der Warteschlange überschritten hat.

source_directory
Erforderlich
str

Das Verzeichnis, das Code oder Konfiguration für die Kopfausführung enthält.

framework
Erforderlich

Orchestrierungsframework, das im Experiment verwendet werden soll. Der Standardwert ist Ray Version 0.8.0.

Methoden

load

Laden Sie eine zuvor gespeicherte Konfigurationsdatei für verstärkungsbasiertes Lernen aus einer Datenträgerdatei.

Wenn path auf eine Datei verweist, wird die ReinforcementLearningConfiguration aus dieser Datei geladen.

Wenn path sie auf ein Verzeichnis verweist, das ein Projektverzeichnis sein soll, wird die ReinforcementLearningConfiguration aus <"path>/.azureml/name</><path>/aml_config/<name>" geladen.

save

Speichern Sie die ReinforcementLearningConfiguration auf einer Datei auf dem Datenträger.

A UserErrorException wird ausgelöst, wenn:

  • Die ReinforcementLearningConfiguration kann nicht mit dem angegebenen Namen gespeichert werden.

  • Es wurde kein name Parameter angegeben.

  • Kein path Parameter ist ungültig.

Wenn path das Format <dir_path>/<file_name> ist, in dem <dir_path> ein gültiges Verzeichnis ist, wird die ReinforcementLearningConfiguration unter <dir_path>/<file_name> gespeichert.

Wenn path sie auf ein Verzeichnis verweist, das ein Projektverzeichnis sein soll, wird die ReinforcementLearningConfiguration unter <"path>/.azureml/name</><path>/aml_config/<name>" gespeichert.

Diese Methode ist hilfreich beim manuellen Bearbeiten der Konfiguration oder beim Freigeben der Konfiguration mit der CLI.

load

Laden Sie eine zuvor gespeicherte Konfigurationsdatei für verstärkungsbasiertes Lernen aus einer Datenträgerdatei.

Wenn path auf eine Datei verweist, wird die ReinforcementLearningConfiguration aus dieser Datei geladen.

Wenn path sie auf ein Verzeichnis verweist, das ein Projektverzeichnis sein soll, wird die ReinforcementLearningConfiguration aus <"path>/.azureml/name</><path>/aml_config/<name>" geladen.

static load(path=None, name=None)

Parameter

Name Beschreibung
path
str

Ein Benutzer hat das Stammverzeichnis für Ausführungskonfigurationen ausgewählt. In der Regel ist dies das Git-Repository oder das Python-Projektstammverzeichnis. Aus Gründen der Abwärtskompatibilität wird die Konfiguration auch aus AZUREML oder aml_config Unterverzeichnis geladen. Wenn sich die Datei nicht in diesen Verzeichnissen befindet, wird die Datei aus dem angegebenen Pfad geladen. Pfad wird standardmäßig zum aktuellen Arbeitsverzeichnis verwendet, falls nicht angegeben.

Standardwert: None
name
str

Der Name der Konfigurationsdatei.

Standardwert: None

Gibt zurück

Typ Beschreibung

Das Konfigurationsobjekt für die Verstärkungslernausführung.

save

Speichern Sie die ReinforcementLearningConfiguration auf einer Datei auf dem Datenträger.

A UserErrorException wird ausgelöst, wenn:

  • Die ReinforcementLearningConfiguration kann nicht mit dem angegebenen Namen gespeichert werden.

  • Es wurde kein name Parameter angegeben.

  • Kein path Parameter ist ungültig.

Wenn path das Format <dir_path>/<file_name> ist, in dem <dir_path> ein gültiges Verzeichnis ist, wird die ReinforcementLearningConfiguration unter <dir_path>/<file_name> gespeichert.

Wenn path sie auf ein Verzeichnis verweist, das ein Projektverzeichnis sein soll, wird die ReinforcementLearningConfiguration unter <"path>/.azureml/name</><path>/aml_config/<name>" gespeichert.

Diese Methode ist hilfreich beim manuellen Bearbeiten der Konfiguration oder beim Freigeben der Konfiguration mit der CLI.

save(path=None, name=None, separate_environment_yaml=False)

Parameter

Name Beschreibung
separate_environment_yaml

Gibt an, ob die Conda-Umgebungskonfiguration gespeichert werden soll. Wenn True, wird die Conda-Umgebungskonfiguration in einer YAML-Datei namens "<type>_environment.yml" gespeichert.

Standardwert: False
path
str

Ein Benutzer hat das Stammverzeichnis für Ausführungskonfigurationen ausgewählt. In der Regel ist dies das Git-Repository oder das Python-Projektstammverzeichnis. Die Konfiguration wird in einem Unterverzeichnis namens ".azureml" gespeichert.

Standardwert: None
name
str

[Erforderlich] Der Name der Konfigurationsdatei.

Standardwert: None

Gibt zurück

Typ Beschreibung