FormTrainingClient.StartTrainingAsync Methode

Definition

Namespace:

Azure.AI.FormRecognizer.Training

Assembly:

Azure.AI.FormRecognizer.dll

Paket:

Azure.AI.FormRecognizer v4.1.0

Quelle:

FormTrainingClient.cs

Trainiert ein Modell aus einer Sammlung benutzerdefinierter Formulare in einem Azure Blob Storage Container.

public virtual System.Threading.Tasks.Task<Azure.AI.FormRecognizer.Training.TrainingOperation> StartTrainingAsync(Uri trainingFilesUri, bool useTrainingLabels, string modelName = default, Azure.AI.FormRecognizer.Training.TrainingOptions trainingOptions = default, System.Threading.CancellationToken cancellationToken = default);

abstract member StartTrainingAsync : Uri * bool * string * Azure.AI.FormRecognizer.Training.TrainingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.AI.FormRecognizer.Training.TrainingOperation>
override this.StartTrainingAsync : Uri * bool * string * Azure.AI.FormRecognizer.Training.TrainingOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.AI.FormRecognizer.Training.TrainingOperation>

Public Overridable Function StartTrainingAsync (trainingFilesUri As Uri, useTrainingLabels As Boolean, Optional modelName As String = Nothing, Optional trainingOptions As TrainingOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TrainingOperation)

Parameter

trainingFilesUri

Uri

Ein extern zugänglicher Azure Blob Storage Container-URI, der auf den Container verweist, der Ihre Trainingsdateien enthält. Beachten Sie, dass ein Container-URI ohne SAS nur akzeptiert wird, wenn der Container öffentlich ist oder eine verwaltete Identität konfiguriert ist. Weitere Informationen zum Einrichten eines Trainingsdatasets finden Sie in diesem Artikel.

useTrainingLabels

Boolean

Wenn true, müssen entsprechende beschriftete Dateien im Blobcontainer vorhanden sein. Wenn false, wird das Modell nur aus Formularen trainiert.

modelName

String

Ein optionaler, benutzerdefinierter Name, der dem Modell zugeordnet werden soll. Diese Eigenschaft ist nur für V2_1 und neuer verfügbar.

trainingOptions

TrainingOptions

Eine Reihe von Optionen, die zum Konfigurieren der Trainingsanforderung verfügbar sind. Legen Sie beispielsweise einen Filter fest, der auf die Dokumente im Quellpfad für das Training angewendet werden soll.

cancellationToken

CancellationToken

Ein CancellationToken , der die Lebensdauer der Anforderung steuert.

Gibt zurück

Task<TrainingOperation>

Ein TrainingOperation , um auf diesen lang andauernden Vorgang zu warten. Sein Wert nach erfolgreicher Fertigstellung enthält Metadaten über das trainierte Modell.

Selbst wenn das Training fehlschlägt, wird im Formularerkennung-Konto ein Modell mit einem "ungültigen" status erstellt. Ein RequestFailedException wird ausgelöst, der die modelId enthält, um auf dieses ungültige Modell zuzugreifen.