Verwenden eines Fallback-Blueprints bei der Verwendung von Projekten

Wenn Sie eine benutzerdefinierte Ausgabe mit mehreren Blueprints verwenden, versucht BDA, jedes Dokument dem am besten geeigneten Blueprint zuzuordnen. Wenn kein Blueprint mit einem Dokument übereinstimmt, gibt BDA normalerweise einen Wert customOutputStatus von zurück, NO_MATCH und für dieses Dokument wird keine benutzerdefinierte Ausgabe generiert. Mit einem Fallback-Blueprint können Sie einen Blueprint angeben, der verwendet werden soll, wenn kein anderer Blueprint passt, sodass Sie trotzdem für jedes Dokument eine benutzerdefinierte Ausgabe erhalten.

So funktionieren Fallback-Blueprints

Wenn BDA ein Dokument verarbeitet und es keinem der Blueprints in Ihrem Projekt zuordnen kann, passiert Folgendes:

• Ohne einen Fallback-Blueprint — BDA kehrt zurück customOutputStatus: NO_MATCH und es gibt keine benutzerdefinierte Ausgabe für dieses Dokument.

• Mit einem Fallback-Blueprint — Wenn das Ergebnis der Fall istNO_MATCH, verwendet BDA den Fallback-Blueprint, um benutzerdefinierte Ausgaben und Rückgaben zu extrahieren. customOutputStatus: FALLBACK

Dies ist nützlich, wenn Sie spezielle Blueprints für bekannte Dokumenttypen haben, aber dennoch eine strukturierte Ausgabe für unerwartete oder verschiedene Dokumente wünschen.

Passendes Verhalten mit verschiedenen Blueprint-Konfigurationen

Das Übereinstimmungsverhalten und die Konfidenzwerte hängen davon ab, wie viele Blueprints in Ihrem Projekt enthalten sind und ob ein Fallback-Blueprint konfiguriert ist:

Konfiguration	Übereinstimmendes Verhalten	Zuverlässigkeitswert
Ein Plan, kein Fallback	BDA erzwingt eine Übereinstimmung mit dem einzelnen Blueprint, ohne den Matcher auszuführen.	Immer 1,0
Ein Plan, mit Fallback	BDA führt den Matcher anhand des einzelnen Blueprints aus. Wenn das Dokument nicht übereinstimmt, verwendet BDA den Fallback-Blueprint.	Wahres Ergebnis oder 0, wenn Fallback verwendet wird
Mehrere Blueprints, kein Fallback	BDA vergleicht den Matcher mit allen Blueprints und wählt den besten Treffer aus. Wenn kein Blueprint übereinstimmt, wird zurückgegeben. NO_MATCH	Wahres Ergebnis oder keine benutzerdefinierte Ausgabe, wenn kein Treffer gefunden wurde
Mehrere Baupläne, mit Fallback	BDA vergleicht den Matcher mit allen Blueprints und wählt den besten Treffer aus. Wenn kein Blueprint übereinstimmt, verwendet BDA den Fallback-Blueprint.	Wahres Ergebnis oder 0, wenn Fallback verwendet wird

Durch Hinzufügen eines Fallback-Blueprints wird in allen Konfigurationen eine tatsächliche Bewertung der Trefferquote ermöglicht. Im Fall eines Einzel-Blueprints ohne Fallback überspringt BDA den Matcher vollständig und erzwingt immer eine Übereinstimmung. Wenn ein Fallback konfiguriert ist, führt BDA den Matcher aus und gibt Ihnen einen Überblick darüber, wie gut Dokumente tatsächlich mit Ihren Blueprints übereinstimmen.

Konfiguration eines Fallback-Blueprints

Sie konfigurieren einen Fallback-Blueprint in der, customOutputConfiguration wenn Sie ein Projekt erstellen oder aktualisieren. Der Fallback-Blueprint ist unter dem document Feld angegeben und akzeptiert einen einzelnen Blueprint.

Im folgenden Beispiel wird ein Projekt mit zwei regulären Blueprints und einem Fallback-Blueprint erstellt. Weitere Informationen zur Fallback-Blueprint-Konfiguration finden Sie DocumentCustomOutputConfiguration in der API-Referenz.

Python-SDK

response = client.create_data_automation_project(
    projectName=project_name,
    projectDescription="Provide a project description",
    projectStage='LIVE',
    standardOutputConfiguration=output_config,
    customOutputConfiguration={
        'blueprints': [
            {
                'blueprintArn': Blueprint ARN,
                'blueprintStage': 'LIVE'
            },
            ...
        ],
        'document': {
            'fallbackBlueprints': [
                {
                    'blueprintArn': Fallback Blueprint ARN,
                    'blueprintStage': 'LIVE'
                }
            ]
        }
    }
)
  

AWS-CLI

aws bedrock-data-automation create-data-automation-project \
    --project-name project_name \
    --project-stage LIVE \
    --standard-output-configuration '{"document":{}}' \
    --custom-output-configuration '{
        "blueprints": [
            {
                "blueprintArn": "Blueprint ARN",
                "blueprintStage": "LIVE"
            }
        ],
        "document": {
            "fallbackBlueprints": [
                {
                    "blueprintArn": "Fallback Blueprint ARN",
                    "blueprintStage": "LIVE"
                }
            ]
        }
    }'
  

In diesem Beispiel versucht BDA zunächst, jedes Dokument dem Rechnungs- oder Beleg-Blueprint zuzuordnen. Wenn keiner der beiden Treffer zutrifft, verwendet BDA den allgemeinen Dokument-Blueprint als Fallback.

Anmerkung

Sie können maximal einen Fallback-Blueprint pro Projekt angeben. Fallback-Blueprints werden nur für die Dokumentmodalität unterstützt.

Grundlegendes zur Fallback-Ausgabe

Das customOutputStatus Feld in der Ausgabe gibt an, wie das Dokument verarbeitet wurde:

benutzerdefiniert OutputStatus	Description
MATCH	Das Dokument entsprach einem der regulären Pläne im Projekt.
NO_MATCH	Kein Blueprint stimmte überein und es wurde kein Fallback-Blueprint konfiguriert.
FALLBACK	Es wurde kein regulärer Blueprint gefunden, aber der Fallback-Blueprint wurde verwendet, um eine benutzerdefinierte Ausgabe zu generieren.

Im Folgenden finden Sie ein Beispiel für einen Ausgabeausschnitt aus der InvokeDataAutomationAsync API, wenn ein Fallback-Blueprint verwendet wird:

{
  "semanticModality": "DOCUMENT",
  "outputSegments": [
    {
      "customOutputStatus": "FALLBACK",
      "standardOutput": {
        ...
      },
      "customOutput": {
        "matched_blueprint": {
          "arn": "arn:aws:bedrock:us-east-1:123456789012:blueprint/general-document",
          "version": "1",
          "name": "general-document",
          "confidence": 1.0
        },
        "inference_result": {
          ...
        }
      }
    }
  ]
}