Blueprint Operations 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, fichiers audio ou vidéo. Utilisez la commande create-blueprint pour définir un nouveau plan.

La commande suivante crée un nouveau 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 indique tous les paramètres disponibles pour la create-blueprint commande :

Paramètres pour create-blueprint

Paramètre	Obligatoire	Par défaut	Description
--blueprint-name	Oui	N/A	Nom du plan
--type	Oui	N/A	Type de contenu (IMAGE, DOCUMENT, AUDIO, VIDÉO)
--blueprint-stage	Non	EN DIRECT	Étape pour le plan directeur (DEVELOPPEMENT ou LIVE)
--schema	Oui	N/A	Schéma JSON définissant la structure du Blueprint
--client-token	Non	Généré automatiquement	Identifiant unique pour l'idempuissance de la demande

Affichage des configurations du Blueprint

Répertorier tous les plans

Utilisez la commande list-blueprints pour récupérer la liste de tous les plans associés à votre compte.

Syntaxe

aws bedrock-data-automation list-blueprints

Afficher les détails du plan

Pour consulter des informations détaillées sur un plan spécifique, notamment son schéma et sa configuration, utilisez la commande get-blueprint.

Syntaxe

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

Inspecter une version spécifique

Lorsque vous travaillez avec des Blueprints versionnés, utilisez la commande get-blueprint avec l'option --blueprint-version pour afficher une version particulière.

Syntaxe

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

Inspecter une étape spécifique

Pour afficher les Blueprints en phase DEVELOPMENT ou en phase LIVE, utilisez :

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

Modification des spécifications du Blueprint

Mettre à jour les paramètres du Blueprint

Pour modifier le schéma ou les propriétés d'un plan existant, utilisez 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 Blueprint, vous devez fournir le schéma complet, même pour les champs que vous ne modifiez pas.

Promouvez en LIVE

Pour déplacer un Blueprint du stade DEVELOPMENT au stade LIVE à des fins de production, utilisez 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"

Versionnage 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 Blueprint

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

Ajouter des tags

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

Syntaxe

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

Supprimer les tags

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

Afficher les tags

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)"

Supprimer des plans

Supprimer l'intégralité d'un Blueprint

Utilisez la commande delete-blueprint pour supprimer définitivement un Blueprint et toutes ses versions.

Syntaxe

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

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

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