Lebenszyklus benutzerdefinierter Dokument Intelligenz-Modelle

Dieser Inhalt gilt für:Version 4.0 (GA)Version 3.1 (GA)

Mit der 3.1 (GA)-API und später wurde für benutzerdefinierte Modelle eine expirationDateTime-Eigenschaft eingeführt, die für jedes Modell festgelegt ist, das mit der 3.1-API oder höher trainiert wurde. Benutzerdefinierte Modelle sind von der API-Version der Layout-API und der API-Version des Modellerstellungsvorgangs abhängig. Um optimale Ergebnisse zu erzielen, verwenden Sie für alle Analyseanforderungen weiterhin die API-Version, mit der das Modell trainiert wurde. Der Leitfaden gilt für alle benutzerdefinierten Dokument Intelligenz-Modelle, einschließlich Extraktions- und Klassifizierungsmodellen.

Modelle, die mit der GA-API-Version trainiert wurden

Mit der 3.1-API wurde für benutzerdefinierte Modelle eine neue Modellablaufeigenschaft eingeführt. Das Modell ist so konfiguriert, dass es zwei Jahre nach seiner Erstellung für alle Anforderungen abläuft, die eine GA-API verwenden, um es zu erstellen. Die API-Version kann das Modell sein, das ursprünglich mit oder einer höheren API-Version trainiert wurde. In der folgenden Abbildung sind die Optionen dargestellt, wenn Sie ein ablaufendes oder abgelaufenes Modell neu trainieren müssen.

Hinweis: Das Ablaufdatum des Modells für v3.1/4.0-Modelle wird nur festgelegt, wenn die Schulung nach der Veröffentlichung von v3.1/v4.0 abgeschlossen ist. Wenn die Modelle zuvor ohne Ablaufdatum erstellt wurden und nach v3.1/v4.0 nicht neu trainiert wurden, ist das Ablaufdatum null. Die Modelle mit ablaufdatumseigenschaft sind weiterhin verfügbar, bis die API eingestellt wird. Die Benachrichtigung über die Abkündigung einer bestimmten GA-API-Version erfolgt mindestens 3 Jahre vor ihrem Auslauf.

Modelle, die mit der Vorschauversion der API trainiert wurden

Bei Buildanforderungen mit einer API-Vorschauversion wird das Ablaufdatum auf zwei Jahre ab dem Erstellungsdatum des Modells festgelegt. Modelle, die mit einer Vorschau-API trainiert wurden, sollten nicht in der Produktion verwendet werden, sondern erneut trainiert werden, sobald die entsprechende GA-API-Version verfügbar ist. Zwischen Vorschauversionen einer API und den GA-API-Versionen kann nicht immer Kompatibilität gewährleistet sein. Modelle, die mit einer API-Vorschauversion trainiert werden, können nicht mehr verwendet werden, wenn die entsprechende GA-Version der API ist verfügbar.

Anzeigen des Ablaufdatums von Modellen

Die API „Modell abrufen“ gibt Details zum Modell einschließlich der expirationDateTime-Eigenschaft zurück.

GET /documentModels/{customModelId}?api-version={apiVersion}
{
  "modelId": "{customModelId}",
  "description": "{customModelDescription}",
  "createdDateTime": "2021-09-24T12:54:35Z",
  "expirationDateTime": "2023-01-01T00:00:00Z",
  "apiVersion": "2023-07-31",
  "docTypes": { ... }
}

Ein Modell neu trainieren

Um ein Modell mit einer neueren API-Version erneut zu trainieren, stellen Sie sicher, dass die Layoutergebnisse für die Dokumente in Ihrem Trainingsdataset der API-Version aus der Erstellungsanforderung für das Modell entsprechen. Wenn Sie z. B. planen, das Modell mit der API-Version v3.1:2023-07-31 zu erstellen, sollten die entsprechenden „*.ocr.json“-Dateien in Ihrem Trainingsdataset auch mit der API-Version v3.1:2023-07-31 generiert werden. Die OCR.JSON-Dateien werden durch Ausführen des Layouts für Ihr Trainingsdataset generiert. Um die Version der Layoutergebnisse zu überprüfen, überprüfen Sie die apiVersion-Eigenschaft in den analyzeResult der OCR.JSON-Dokumente.

Nächste Schritte

Erfahren Sie, wie Sie benutzerdefinierte Modelle erstellen und zusammenstellen:

Erstellen eines benutzerdefinierten ModellsEntwerfen benutzerdefinierter Modelle