Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden eines JSON-Schemas für Bedingungen zur Aktivierung eines Human Loops mit Amazon Textract
Bei Verwendung mit Amazon A2I unterstützt die `AnalyzeDocument`-Operation die folgenden Eingaben im `ConditionType`-Parameter:
+ `ImportantFormKeyConfidenceCheck` – Verwenden Sie diese Bedingung, um eine Human Loop zu erstellen, wenn die Zuverlässigkeit innerhalb eines angegebenen Bereichs für Dokumentformularschlüssel und Wortblöcke liegt. Ein *Form key (Formularschlüssel)* ist ein beliebiges Wort in einem Dokument, das einer Eingabe zugeordnet ist. Die Eingabe wird als *Value (Wert)* bezeichnet. Zusammen werden Formularschlüssel und Werte als *Key-Value Pairs (Schlüssel-Wert-Paare)* bezeichnet. Ein *Wortblock* bezieht sich auf die Wörter, die Amazon Textract innerhalb eines erkannten Textblocks erkennt. Weitere Informationen zu Amazon-Textract-Dokumentblöcken finden Sie unter [Dokumente und Blockobjekte](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-document-layout.html) im *Amazon-Textract-Entwicklerhandbuch*.
+ `MissingImportantFormKey` – Verwenden Sie diese Bedingung, um eine Human Loop zu erstellen, wenn Amazon Textract den Schlüssel oder seine zugehörigen Aliase innerhalb des Dokuments nicht identifiziert hat.
+ `Sampling` – Verwenden Sie diese Bedingung, um einen Prozentsatz von Formularen festzulegen, die unabhängig von Inferenz-Vertrauensbewertungen zur Überprüfung an Menschen geschickt werden sollen. Verwenden Sie diese Bedingung, um Folgendes zu tun:
+ Ihr ML-Modell zu überprüfen, indem Sie alle von Ihrem Modell analysierten Formen Stichproben unterziehen und einen bestimmten Prozentsatz zur Überprüfung an Menschen schicken.
+ Mit der `ImportantFormKeyConfidenceCheck`-Bedingung zufällige Stichproben aus einem Prozentsatz der Inferenzen zu entnehmen, die die in `ImportantFormKeyConfidenceCheck` angegebenen Bedingungen erfüllten, um eine Schleife für die Prüfung durch Menschen (Human Loop) zu starten und nur den angegebenen Prozentsatz zur Überprüfung an Menschen zu senden.
**Anmerkung**
Wenn Sie dieselbe Anfrage mehrmals an `AnalyzeDocument` senden, ändert sich das Ergebnis von `Sampling` nicht für die Inferenz dieser Eingabe. Wenn Sie beispielsweise einmal eine `AnalyzeDocument`-Anforderung erstellen und `Sampling` keinen Human Loop initiiert, initiieren nachfolgende Anforderungen an `AnalyzeDocument` mit derselben Konfiguration auch keine Human Loop.
## `ImportantFormKeyConfidenceCheck` Eingaben und Ergebnisse
`ImportantFormKeyConfidenceCheck` `ConditionType` unterstützt die folgenden `ConditionParameters`:
+ `ImportantFormKey` – Eine Zeichenfolge, die einen Schlüssel in einem Schlüssel-Wert-Paar darstellt, der von Amazon Textract erkannt wird und von menschlichen Mitarbeitern überprüft werden muss. Wenn der Wert dieses Parameters der spezielle Catch-All-Wert (\$1) ist, gelten alle Schlüssel als mit der Bedingung übereingestimmt. Sie können dies verwenden, um den Fall zu modellieren, bei dem jedes Schlüssel-Wert-Paar, das bestimmte Konfidenzschwellenwerte erfüllt, von Menschen überprüft werden muss.
+ `ImportantFormKeyAliases` – Ein Array, das alternative Schreibweisen oder logische Äquivalente für den wichtigen Formularschlüssel darstellt.
+ `KeyValueBlockConfidenceEquals`
+ `KeyValueBlockConfidenceLessThan`
+ `KeyValueBlockConfidenceLessThanEquals`
+ `KeyValueBlockConfidenceGreaterThan`
+ `KeyValueBlockConfidenceGreaterThanEquals`
+ `WordBlockConfidenceEquals`
+ `WordBlockConfidenceLessThan`
+ `WordBlockConfidenceLessThanEquals`
+ `WordBlockConfidenceGreaterThan`
+ `WordBlockConfidenceGreaterThanEquals`
Wenn Sie die `ImportantFormKeyConfidenceCheck` `ConditionType` verwenden, sendet Amazon A2I die Schlüssel-Wert-Block- und Wortblock-Inferenzen der Schlüssel-Wert-Blöcke und zugehörigen Aliase, die Sie in `ImportantFormKey` und `ImportantFormKeyAliases` zur menschlichen Überprüfung angegeben haben.
Wenn Sie bei der Erstellung einer Flow-Definition die Standardvorlage für Arbeitsaufgaben verwenden, die im Abschnitt **Workflows für menschliche Überprüfung** der Amazon SageMaker AI-Konsole bereitgestellt wird, sind Schlüsselwert- und Blockableitungen, die durch diese Aktivierungsbedingung zur Überprüfung durch einen Mitarbeiter gesendet wurden, in der Worker-Benutzeroberfläche enthalten. Wenn Sie eine benutzerdefinierte Vorlage für Auftragnehmeraufgaben verwenden, müssen Sie das Element `{{ task.input.selectedAiServiceResponse.blocks }}` zum Einfügen von Initialwert-Eingabedaten (Inferenzen) aus Amazon Textract einbinden. Ein Beispiel für eine benutzerdefinierte Vorlage, die dieses Eingabeelement verwendet, finden Sie unter [Beispiel für eine benutzerdefinierte Vorlage für Amazon Textract](a2i-custom-templates.md#a2i-custom-templates-textract-sample).
## `MissingImportantFormKey` Eingaben und Ergebnisse
`MissingImportantFormKey` `ConditionType` unterstützt die folgenden `ConditionParameters`:
+ `ImportantFormKey` – Eine Zeichenfolge, die einen Schlüssel in einem Schlüssel-Wert-Paar darstellt, der von Amazon Textract erkannt wird und von menschlichen Mitarbeitern überprüft werden muss.
+ `ImportantFormKeyAliases` – Ein Array, das alternative Schreibweisen oder logische Äquivalente für den wichtigen Formularschlüssel darstellt.
Wenn Sie den `MissingImportantFormKey` `ConditionType` verwenden und der Schlüssel in `ImportantFormKey` oder die Aliase in `ImportantFormKeyAliases` nicht in der Amazon-Textract-Inferenz enthalten sind, wird dieses Formular zur menschlichen Überprüfung gesendet und es werden keine vorausgesagten Schlüssel-Wert-Paare aufgenommen. Wenn Amazon Textract z. B. nur `Address` und `Phone` in einem Formular identifizierte, aber der `ImportantFormKey` `Name` (im `MissingImportantFormKey`-Bedingungstyp) fehlte, würde dieses Formular zur Überprüfung an Menschen geschickt werden, ohne dass einer der Formularschlüssel (`Address` und `Phone`) erkannt wird.
Wenn Sie die Standardvorlage für Arbeitsaufgaben verwenden, die in der SageMaker AI-Konsole bereitgestellt wird, wird eine Aufgabe erstellt, in der die Mitarbeiter aufgefordert werden, den Schlüssel `ImportantFormKey` und den zugehörigen Wert zu identifizieren. Wenn Sie eine benutzerdefinierte Vorlage für Auftragnehmeraufgaben verwenden, müssen Sie das benutzerdefinierte HTML-Element `` einbinden, um diese Aufgabe zu konfigurieren.
## Stichprobeneingaben und -ergebnisse
`Sampling` `ConditionType` unterstützt die `RandomSamplingPercentage` `ConditionParameters`. Die Eingabe für `RandomSamplingPercentage` muss eine reelle Zahl zwischen 0,01 und 100 sein. Diese Zahl stellt den Prozentsatz der Daten dar, die für eine menschliche Überprüfung qualifiziert sind und zur Überprüfung an einen Menschen gesendet werden. Wenn Sie die `Sampling`-Bedingung ohne weitere Bedingungen verwenden, stellt diese Zahl den Prozentsatz aller resultierenden Inferenzen dar, die von der `AnalyzeDocument`-Operation aus einer einzelnen Anforderung abgeleitet werden, die an Menschen zur Überprüfung gesendet wird.
Wenn Sie die `Sampling`-Bedingung ohne einen weiteren Bedingungstyp angeben, werden alle Schlüsselwert- und Blockinferenzen zur Überprüfung an Mitarbeiter gesendet.
Wenn Sie bei der Erstellung einer Flow-Definition die Standardvorlage für Worker-Aufgaben verwenden, die im Abschnitt **Workflows zur menschlichen Überprüfung** der SageMaker KI-Konsole bereitgestellt wird, sind alle Schlüsselwert- und Blockableitungen, die durch diese Aktivierungsbedingung zur Überprüfung durch einen Mitarbeiter gesendet wurden, in der Worker-Benutzeroberfläche enthalten. Wenn Sie eine benutzerdefinierte Vorlage für Auftragnehmeraufgaben verwenden, müssen Sie das Element `{{ task.input.selectedAiServiceResponse.blocks }}` zum Einfügen von Initialwert-Eingabedaten (Inferenzen) aus Amazon Textract einbinden. Ein Beispiel für eine benutzerdefinierte Vorlage, die dieses Eingabeelement verwendet, finden Sie unter [Beispiel für eine benutzerdefinierte Vorlage für Amazon Textract](a2i-custom-templates.md#a2i-custom-templates-textract-sample).
## Beispiele
Während nur eine Bedingung als `true` ausgewertet werden muss, um eine Human Loop zu initiieren, wertet Amazon A2I alle Bedingungen für jedes von Amazon Textract analysierte Objekt aus. Die menschlichen Prüfer werden aufgefordert, die wichtigen Formularschlüssel für alle Bedingungen zu überprüfen, die als `true` ausgewertet wurden.
**Beispiel 1: Erkennen wichtiger Formularschlüssel mit Vertrauensbewertungen in einem angegebenen Bereich, der eine Human Loop initiiert**
Das folgende Beispiel zeigt einen `HumanLoopActivationConditions`-JSON, durch das eine Human Loop initiiert wird, wenn einer der folgenden drei Bedingungen entsprochen wird:
+ Die Amazon Textract `AnalyzeDocument`-API gibt ein Schlüssel-Wert-Paar zurück, dessen Schlüssel einer von `Employee Name`, `Name` oder `EmployeeName` ist, wobei der Konfidenzwert des Schlüssel-Wert-Blocks kleiner als 60 ist und die Konfidenzwerte der einzelnen Wortblöcke, die den Schlüssel und Wert bilden, kleiner als 85 sind.
+ Die Amazon Textract `AnalyzeDocument`-API gibt ein Schlüssel-Wert-Paar zurück, dessen Schlüssel einer von `Pay Date`, `PayDate`, `DateOfPay` oder `pay-date` ist, wobei der Konfidenzwert des Schlüssel-Wert-Blocks kleiner als 65 ist und die Konfidenzwerte der einzelnen Wortblöcke, die den Schlüssel und Wert bilden, kleiner als 85 sind.
+ Die Amazon Textract `AnalyzeDocument`-API gibt ein Schlüssel-Wert-Paar zurück, dessen Schlüssel einer von `Gross Pay`, `GrossPay` oder `GrossAmount` ist, wobei der Konfidenzwert des Schlüssel-Wert-Blocks kleiner als 60 ist und die Konfidenzwerte der einzelnen Wortblöcke, die den Schlüssel und Wert bilden, kleiner als 85 sind.
```
{
"Conditions": [
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "Employee Name",
"ImportantFormKeyAliases": [
"Name",
"EmployeeName"
],
"KeyValueBlockConfidenceLessThan": 60,
"WordBlockConfidenceLessThan": 85
}
},
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "Pay Date",
"ImportantFormKeyAliases": [
"PayDate",
"DateOfPay",
"pay-date"
],
"KeyValueBlockConfidenceLessThan": 65,
"WordBlockConfidenceLessThan": 85
}
},
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "Gross Pay",
"ImportantFormKeyAliases": [
"GrossPay",
"GrossAmount"
],
"KeyValueBlockConfidenceLessThan": 60,
"WordBlockConfidenceLessThan": 85
}
}
]
}
```
**Beispiel 2: Verwenden von `ImportantFormKeyConfidenceCheck`**
Wenn im folgenden Beispiel Amazon Textract ein Schlüssel-Wert-Paar erkennt, dessen Konfidenz für den Schlüssel-Wert-Block kleiner als 60 und für alle zugrunde liegenden Wortblöcke kleiner als 90 ist, wird eine Human Loop erstellt. Die menschlichen Prüfer werden aufgefordert, alle Schlüssel-Wert-Paare zu überprüfen, die den Konfidenzwert-Vergleichen entsprechen.
```
{
"Conditions": [
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "*",
"KeyValueBlockConfidenceLessThan": 60,
"WordBlockConfidenceLessThan": 90
}
}
]
}
```
**Beispiel 3: Verwenden von Stichproben**
Im folgenden Beispiel werden 5 % der aus einer Amazon Textract `AnalyzeDocument`-Anforderung resultierenden Inferenzen an menschliche Auftragnehmer zur Überprüfung übermittelt. Alle erkannten Schlüssel-Wert-Paare, die von Amazon Textract zurückgegeben werden, werden zur Überprüfung an Mitarbeiter gesendet.
```
{
"Conditions": [
{
"ConditionType": "Sampling",
"ConditionParameters": {
"RandomSamplingPercentage": 5
}
}
]
}
```
**Beispiel 4: Verwenden von `MissingImportantFormKey`**
Wenn im folgenden Beispiel `Mailing Address` oder sein Alias `Mailing Address:`, in den von Amazon Textract erkannten Schlüsseln fehlt, wird eine menschliche Überprüfung ausgelöst. Bei Verwendung der Standardvorlage für Auftragnehmeraufgaben werden die Auftragnehmer durch die Auftragnehmer-Benutzeroberfläche aufgefordert, den Schlüssel `Mailing Address` oder `Mailing Address:` und den zugehörigen Wert zu identifizieren.
```
{
"ConditionType": "MissingImportantFormKey",
"ConditionParameters": {
"ImportantFormKey": "Mailing Address",
"ImportantFormKeyAliases": ["Mailing Address:"]
}
}
```
**Beispiel 5: Verwenden von Probenahme und `ImportantFormKeyConfidenceCheck` mit dem `And` Operator**
In diesem Beispiel werden 5 % der Schlüssel-Wert-Paare von Amazon Textract erkannt, deren Schlüssel entweder `Pay Date`, `PayDate`, `DateOfPay` oder `pay-date` ist, wobei der Konfidenzwert des Schlüssel-Wert-Blocks kleiner als 65 und die Konfidenzwerte der einzelnen Wortblöcke, aus denen der Schlüssel und der Wert bestehen, kleiner als 85 sind, zur Überprüfung an Auftragnehmer gesendet.
```
{
"Conditions": [
{
"And": [
{
"ConditionType": "Sampling",
"ConditionParameters": {
"RandomSamplingPercentage": 5
}
},
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "Pay Date",
"ImportantFormKeyAliases": [
"PayDate",
"DateOfPay",
"pay-date"
],
"KeyValueBlockConfidenceLessThan": 65,
"WordBlockConfidenceLessThan": 85
}
}
]
}
]
}
```
**Beispiel 6: Verwenden von Probenahme und `ImportantFormKeyConfidenceCheck` mit dem `And` Operator**
Verwenden Sie dieses Beispiel, um Ihren Workflow für die menschliche Überprüfung so zu konfigurieren, dass Inferenzen mit geringer Konfidenz eines angegebenen Schlüssel-Wert-Paars immer zur menschlichen Überprüfung gesendet werden und Stichproben von Inferenzen mit hoher Konfidenz eines Schlüssel-Wert-Paares mit einer bestimmten Rate entnommen werden.
Im folgenden Beispiel wird eine menschliche Überprüfung auf eine der folgenden Arten initiiert:
+ Erkannte Schlüssel-Wert-Paare, deren Schlüssel einer von `Pay Date`, `PayDate`, `DateOfPay` oder `pay-date` ist, wobei die Schlüssel-Wert- und Wortblockkonfidenzen unter 60 sind, werden zur menschlichen Überprüfung gesendet. Nur der `Pay Date`-Formularschlüssel (und seine Aliase) und die zugehörigen Werte werden an Mitarbeiter zur Prüfung gesendet.
+ 5 % der erkannten Schlüssel-Wert-Paare, deren Schlüssel entweder `Pay Date`, `PayDate`, `DateOfPay` oder `pay-date` ist, mit Schlüssel-Wert- und Wortblockkonfidenzen über 90 werden zur Prüfung durch Menschen gesendet. Nur der `Pay Date`-Formularschlüssel (und seine Aliase) und die zugehörigen Werte werden an Mitarbeiter zur Prüfung gesendet.
```
{
"Conditions": [
{
"Or": [
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "Pay Date",
"ImportantFormKeyAliases": [
"PayDate",
"DateOfPay",
"pay-date"
],
"KeyValueBlockConfidenceLessThan": 60,
"WordBlockConfidenceLessThan": 60
}
},
{
"And": [
{
"ConditionType": "Sampling",
"ConditionParameters": {
"RandomSamplingPercentage": 5
}
},
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "Pay Date",
"ImportantFormKeyAliases": [
"PayDate",
"DateOfPay",
"pay-date"
],
"KeyValueBlockConfidenceLessThan": 90
"WordBlockConfidenceGreaterThan": 90
}
}
]
}
]
}
]
}
```
**Beispiel 7: Verwenden von Probenahme und `ImportantFormKeyConfidenceCheck` mit dem `Or` Operator**
Im folgenden Beispiel gibt die Amazon Textract `AnalyzeDocument`-Operation ein Schlüssel-Wert-Paar zurück, dessen Schlüssel einer von `Pay Date`, `PayDate`, `DateOfPay` oder `pay-date` ist, wobei der Konfidenzwert des Schlüssel-Wert-Blocks unter 65 ist und die Konfidenzwerte der Wortblöcke, aus denen Schlüssel und Wert bestehen, unter 85 sind. Darüber hinaus initiieren 5 % aller anderen Formulare eine Schleife für die Prüfung durch Menschen (Human Loop). Für jedes zufällig ausgewählte Formular werden alle Schlüssel-Wert-Paare, die für dieses Formular erkannt wurden, zur Überprüfung an den Menschen gesendet.
```
{
"Conditions": [
{
"Or": [
{
"ConditionType": "Sampling",
"ConditionParameters": {
"RandomSamplingPercentage": 5
}
},
{
"ConditionType": "ImportantFormKeyConfidenceCheck",
"ConditionParameters": {
"ImportantFormKey": "Pay Date",
"ImportantFormKeyAliases": [
"PayDate",
"DateOfPay",
"pay-date"
],
"KeyValueBlockConfidenceLessThan": 65,
"WordBlockConfidenceLessThan": 85
}
}
}
]
}
]
}
```