Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Opérations de plan à l’aide de la CLI

Ce guide couvre les opérations Blueprint disponibles via l'interface de ligne de commande (CLI) AWS pour l'automatisation Amazon Bedrock des données (BDA).

Création de plans

Les plans définissent la structure et les propriétés des données que vous souhaitez extraire de vos documents, images et fichiers audio ou vidéo. Définissez un nouveau plan à l’aide de la commande create-blueprint.

La commande suivante crée un plan conçu pour extraire les données d’une image de passeport.

Syntaxe

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"
          }
        }
      }'

Référence complète des paramètres

Le tableau suivant montre l’ensemble des paramètres disponibles pour la commande create-blueprint :

Affichage des configurations de plan

Établissement de la liste de tous les plans

Récupérez la liste de tous les plans associés à votre compte à l’aide de la commande list-blueprints.

Syntaxe

aws bedrock-data-automation list-blueprints

Affichage des détails du plan

Consultez des informations détaillées sur un plan spécifique, notamment son schéma et sa configuration, à l’aide de la commande get-blueprint.

Syntaxe

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

Inspection d’une version spécifique

Lorsque vous utilisez des plans versionnés, affichez une version particulière à l’aide de la commande get-blueprint avec l’option --blueprint-version.

Syntaxe

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

Inspection d’une phase spécifique

Affichez les plans en phase DÉVELOPPEMENT ou EN SERVICE à l’aide de :

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

Modification des spécifications du plan

Mise à jour des paramètres du plan

Modifiez le schéma ou les propriétés d’un plan existant à l’aide de la commande update-blueprint.

Syntaxe

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"
          }
        }
      }'

Remarque : lorsque vous mettez à jour un plan, vous devez fournir le schéma complet, même pour les champs que vous ne modifiez pas.

Promotion vers EN SERVICE

Déplacez un plan de la phase DÉVELOPPEMENT vers la phase EN SERVICE à des fins de production à l’aide de la commande update-blueprint avec l’option --blueprint-stage.

Syntaxe

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

Gestion des versions du plan

Créez une nouvelle version de votre plan afin de conserver son état actuel avant d'apporter des modifications importantes à l'aide de la create-blueprint-version commande.

Syntaxe

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

Gestion des balises de plan

Les balises aident les utilisateurs à organiser et classer les plans pour une gestion simplifiée.

Ajout de balises

Appliquez des métadonnées à votre plan en ajoutant des balises.

Syntaxe

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

Suppression de balises

Supprimez des balises spécifiques de votre plan à l’aide de la commande untag-resource.

Syntaxe

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

Affichage des balises

Répertoriez toutes les balises associées à votre plan à l'aide de la list-tags-for-resource commande.

Syntaxe

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

Suppression de plans

Suppression de l’intégralité d’un plan

Supprimez définitivement un plan et toutes ses versions à l’aide de la commande delete-blueprint.

Syntaxe

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

Attention : cette commande supprime définitivement un plan et ne peut pas le récupérer.

Important : vous ne pouvez pas supprimer un plan actuellement utilisé par un projet. Avant de supprimer un plan, assurez-vous qu’il n’est pas référencé dans la configuration de sortie personnalisée d’un projet.

Optimisation du plan

Invoquer l'optimisation du plan

Lancez une tâche d'optimisation de plan asynchrone pour améliorer les instructions du plan pour chacun de vos champs de plan et la précision des résultats.

Syntaxe

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"

Vérification de l'état d'optimisation du plan

Surveillez la progression et les résultats d'une tâche d'optimisation du plan.

Syntaxe

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

Utilisez cette commande pour suivre l'état de la tâche d'optimisation. La réponse inclut l'état actuel (Créé InProgress ServiceError, Succès ou ClientError) et les détails de la configuration de sortie une fois terminée.

Copier les étapes du plan

Copier un plan d'une étape à l'autre

Syntaxe

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

Attention : Cette commande copie l'intégralité de la configuration du Blueprint de la phase source vers la phase cible, en remplaçant toute configuration existante dans la phase cible.

Important : Assurez-vous que le plan est soigneusement testé au stade source avant de le copier vers l'étape de production (LIVE). Cette opération ne peut pas être facilement annulée.