Lebenszyklus benutzerdefinierter Dokument Intelligenz-Modelle

Dieser Inhalt gilt für:v4.0 (Vorschau)v3.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. Der Modellablauf wird auf zwei Jahre ab dem Datum festgelegt, an dem das Modell erstellt wurde. Dies gilt für alle Anforderungen, die eine GA-API zum Erstellen eines Modells verwenden. Um das Modell auch nach Ablauf des Verfallsdatums weiter zu verwenden, müssen Sie das Modell mit einer aktuellen GA API-Version trainieren. 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.

Modelle, die mit der Vorschauversion der API trainiert wurden

Bei Buildanforderungen mit einer Vorschau-API-Version wird das Ablaufdatum auf drei Monate 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. Sie sollten davon ausgehen, dass Modelle, die mit einer API-Vorschauversion trainiert wurden, nicht mehr verwendet werden können, nachdem die Vorschau-API eingestellt wurde.

Vorschau-APIs werden in der Regel drei Monate nach Einführung der entsprechenden GA-API eingestellt.

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 ModellsVerfassen benutzerdefinierter Modelle