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` : **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, FICHIER AUDIO, VIDÉO) | | --blueprint-stage | Non | EN SERVICE | Phase du plan (DÉVELOPPEMENT ou EN SERVICE) | | --schema | Oui | N/A | Schéma JSON définissant la structure du plan | | --client-token | Non | Généré automatiquement | Identifiant unique pour l’idempotence de la demande | ## 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:::blueprint/",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:::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:::blueprint/" \ --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.