Blueprint Operations CLI

Esta guía describe las operaciones de Blueprint disponibles a través de la interfaz de línea de comandos (CLI) de AWS para la automatización de Amazon Bedrock datos (BDA).

Creación de planos

Los planos definen la estructura y las propiedades de los datos que desea extraer de sus documentos, imágenes, archivos de audio o vídeo. Utilice el comando create-blueprint para definir un nuevo plano.

El siguiente comando crea un nuevo plano diseñado para extraer datos de la imagen de un pasaporte.

Sintaxis

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

Referencia completa de parámetros

En la siguiente tabla se muestran todos los parámetros disponibles para el create-blueprint comando:

Parámetros de create-blueprint

Parámetro	Obligatorio	Predeterminado/a	Descripción
--blueprint-name	Sí	N/A	Nombre del plano
--type	Sí	N/A	Tipo de contenido (IMAGEN, DOCUMENTO, AUDIO, VÍDEO)
--blueprint-stage	No	ACTIVA	Escenario para el anteproyecto (EN DESARROLLO o EN DIRECTO)
--schema	Sí	N/A	Esquema JSON que define la estructura del Blueprint
--client-token	No	Generado automáticamente	Identificador único para la idempotencia de la solicitud

Visualización de las configuraciones del plano

Enumere todos los planos

Utilice el comando list-blueprints para recuperar una lista de todos los planos asociados a su cuenta.

Sintaxis

aws bedrock-data-automation list-blueprints

Vea los detalles del plano

Para ver información detallada sobre un blueprint específico, incluidos su esquema y configuración, utilice el comando get-blueprint.

Sintaxis

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

Inspeccione una versión específica

Cuando trabaje con blueprints versionados, utilice el comando get-blueprint con la opción --blueprint-version para ver una versión concreta.

Sintaxis

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

Inspeccione una etapa específica

Para ver los planos en fase de DESARROLLO o EN DIRECTO, utilice:

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

Edición de las especificaciones del plano

Actualizar la configuración del blueprint

Para modificar el esquema o las propiedades de un blueprint existente, utilice el comando update-blueprint.

Sintaxis

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

Nota: Al actualizar un blueprint, debe proporcionar el esquema completo, incluso para los campos que no vaya a cambiar.

¡Promociona a LIVE

Para pasar un plano de la fase de DESARROLLO a la fase DE PRODUCCIÓN EN VIVO, utilice el comando update-blueprint con la opción --blueprint-stage.

Sintaxis

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

Control de versiones de blueprint

Cree una nueva versión de su blueprint para conservar su estado actual antes de realizar cambios importantes mediante el comando. create-blueprint-version

Sintaxis

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

Administrar las etiquetas de Blueprint

Las etiquetas ayudan a los usuarios a organizar y clasificar los planos para simplificar la administración.

Añadir etiquetas

Aplica metadatos a tu Blueprint añadiendo etiquetas.

Sintaxis

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

Elimina etiquetas

Elimine etiquetas específicas de su Blueprint con el comando untag-resource.

Sintaxis

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

Ver etiquetas

Enumere todas las etiquetas asociadas a su Blueprint mediante el list-tags-for-resource comando.

Sintaxis

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

Eliminar planos

Eliminar un blueprint completo

Utilice el comando delete-blueprint para eliminar permanentemente un blueprint y todas sus versiones.

Sintaxis

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

Precaución: Este comando elimina permanentemente un plano y no puede recuperarlo.

Importante: No puedes eliminar un blueprint que esté siendo utilizado actualmente en ningún proyecto. Antes de eliminarlo, asegúrate de que no se haga referencia al plano en la configuración de salida personalizada de ningún proyecto.