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.

CLI für Vorlagen-Operationen

Dieses Handbuch behandelt Blueprint-Operationen, die über die AWS-Befehlszeilenschnittstelle (CLI) for Amazon Bedrock Data Automation (BDA) verfügbar sind.

Erstellen von Vorlagen

Vorlagen definieren die Struktur und Eigenschaften von Daten, die Sie aus Ihren Dokumenten, Bildern, Audio- oder Videodateien extrahieren möchten. Verwenden Sie den Befehl create-blueprint, um eine neue Vorlage zu erstellen.

Mit dem folgenden Befehl wird eine neue Vorlage erstellt, der dazu dient, Daten aus einem Passbild zu extrahieren.

Syntax

aws bedrock-data-automation create-blueprint \
      --blueprint-name "passport-blueprint" \
      --type "IMAGE" \
      --blueprint-stage "DEVELOPMENT" \
      --schema '{
        "class": "Passport",
        "description": "Blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

Vollständige Parameterreferenz

Die folgende Tabelle enthält alle Parameter, die für den create-blueprint-Befehl verfügbar sind:

Anzeigen von Vorlagen-Konfigurationen

Alle Vorlagen auflisten

Verwenden Sie den Befehl list-blueprints, um eine Liste aller Vorlagen abzurufen, die mit Ihrem Konto verknüpft sind.

Syntax

aws bedrock-data-automation list-blueprints

Vorlagen-Details anzeigen

Verwenden Sie zum Anzeigen detaillierter Informationen über eine bestimmte Vorlage, einschließlich seines Schemas und seiner Konfiguration, den Befehl get-blueprint.

Syntax

aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)"

Spezifische Version untersuchen

Wenn Sie mit versionierten Vorlagen arbeiten, verwenden Sie den Befehl get-blueprint mit der Option --blueprint-version, um eine bestimmte Version anzuzeigen.

Syntax

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-version "version-number"

Spezifische Phase untersuchen

Zum Anzeigen von Vorlagen entweder in der ENTWICKLUNGS- oder der LIVE-Phase verwenden Sie:

      aws bedrock-data-automation get-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

Bearbeiten von Vorlagen-Spezifikationen

Vorlagen-Einstellungen aktualisieren

Verwenden Sie den Befehl update-blueprint, um das Schema oder die Eigenschaften eines vorhandenen Vorlagen zu ändern.

Syntax

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --schema '{
        "class": "Passport",
        "description": "Updated blueprint for processing passport images",
        "properties": {
          "passport_number": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport identification number"
          },
          "full_name": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The full name of the passport holder"
          },
          "expiration_date": {
            "type": "string",
            "inferenceType": "explicit",
            "instruction": "The passport expiration date"
          }
        }
      }'

Hinweis: Wenn Sie eine Vorlage aktualisieren, müssen Sie das vollständige Schema angeben, auch für Felder, die Sie nicht ändern.

Zu Live hochstufen

Verwenden Sie den Befehl update-blueprint mit der Option --blueprint-stage, um eine Vorlage aus der Phase ENTWICKLUNG in die Phase LIVE hochzustufen.

Syntax

aws bedrock-data-automation update-blueprint \
      --blueprint-arn "Amazon Resource Name (ARN)" \
      --blueprint-stage "LIVE"

Versionsverwaltung von Vorlagen

Erstellen Sie eine neue Version Ihres Blueprints, um den aktuellen Status beizubehalten, bevor Sie mit dem create-blueprint-version Befehl wesentliche Änderungen vornehmen.

Syntax

aws bedrock-data-automation create-blueprint-version \
      --blueprint-arn "Amazon Resource Name (ARN)"
      

Verwalten von Vorlagen-Tags

Mithilfe von Tags können Benutzer Vorlagen organisieren und kategorisieren und so die Verwaltung vereinfachen.

Tags hinzufügen

Wenden Sie Metadaten auf Ihre Vorlage an, indem Sie Tags hinzufügen.

Syntax

aws bedrock-data-automation tag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tags '{"Department":"Finance","Project":"PassportProcessing"}'

Tags entfernen

Entfernen Sie mit dem Befehl untag-resource bestimmte Tags aus Ihrer Vorlage.

Syntax

aws bedrock-data-automation untag-resource \
      --resource-arn "Amazon Resource Name (ARN)" \
      --tag-keys '["Department","Project"]'

Tags anzeigen

Führen Sie mithilfe des Befehls alle mit Ihrem Blueprint verknüpften Tags auf list-tags-for-resource.

Syntax

aws bedrock-data-automation list-tags-for-resource \
      --resource-arn "Amazon Resource Name (ARN)"

Löschen von Vorlagen

Gesamte Vorlage löschen

Verwenden Sie den Befehl delete-blueprint, um eine Vorlage und alle ihre Versionen dauerhaft zu entfernen.

Syntax

aws bedrock-data-automation delete-blueprint \
          --blueprint-arn "Amazon Resource Name (ARN)"
              

Achtung: Dieser Befehl löscht eine Vorlage dauerhaft und kann sie nicht wiederherstellen.

Wichtig: Sie können keine Vorlage verwenden, die aktuell von einem Projekt verwendet wird. Stellen Sie vor dem Löschen sicher, dass auf die Vorlage nicht in der benutzerdefinierten Ausgabekonfiguration eines Projekts verwiesen wird.

Blueprint-Optimierung

Blueprint-Optimierung aufrufen

Starten Sie einen asynchronen Blueprint-Optimierungsjob, um die Blueprint-Anweisungen für jedes Ihrer Blueprint-Felder und die Ergebnisgenauigkeit zu verbessern.

Syntax

aws bedrock-data-automation invoke-blueprint-optimization-async \
    --blueprint blueprintArn="arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>",stage="DEVELOPMENT" \
    --samples '[
        {
            "assetS3Object": {
                "s3Uri": "s3://my-optimization-bucket/samples/document1.pdf"
            },
            "groundTruthS3Object": {
                "s3Uri": "s3://my-optimization-bucket/ground-truth/document1-expected.json"
            }
        }
    ]' \
    --output-configuration s3Object='{s3Uri="s3://my-optimization-bucket/results/optimization-output"}' \
    --data-automation-profile-arn "Amazon Resource Name (ARN):data-automation-profile/default"

Überprüfen Sie den Status der Blueprint-Optimierung

Überwachen Sie den Fortschritt und die Ergebnisse eines Blueprint-Optimierungsjobs.

Syntax

aws bedrock-data-automation get-blueprint-optimization-status \
    --invocation-arn "arn:aws:bedrock:<region>:<account_id>:blueprint-optimization-invocation/opt-12345abcdef"

Verwenden Sie diesen Befehl, um den Status des Optimierungsauftrags zu verfolgen. Die Antwort enthält den aktuellen Status (Erstellt InProgress, Erfolgreich ServiceError, oder ClientError) und nach Abschluss Details zur Ausgabekonfiguration.

Blueprint-Stufen werden kopiert

Kopieren Sie einen Blueprint von einer Phase in eine andere

Syntax

aws bedrock-data-automation copy-blueprint-stage \
    --blueprint-arn "arn:aws:bedrock:<region>:<account_id>:blueprint/<blueprint_id>" \
    --source-stage "DEVELOPMENT" \
    --target-stage "LIVE"

Vorsicht: Mit diesem Befehl wird die gesamte Blueprint-Konfiguration von der Quellphase in die Zielphase kopiert, wobei alle vorhandenen Konfigurationen in der Zielphase überschrieben werden.

Wichtig: Stellen Sie sicher, dass der Blueprint in der Quellphase gründlich getestet wird, bevor Sie ihn in die Produktionsphase (LIVE) kopieren. Dieser Vorgang kann nur schwer rückgängig gemacht werden.