View a markdown version of this page

CLI de operaciones con esquemas - Amazon Bedrock
Creación de esquemasReferencia de parámetros completaConsulta de las configuraciones de esquemasEdición de especificaciones del esquemaAdministración de etiquetas de esquemasCreación de esquemasOptimización del plano

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CLI de operaciones con esquemas

En esta guía se describen 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 esquemas

Los esquemas 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 esquema.

El siguiente comando crea un nuevo esquema adaptado 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 de parámetros completa

El ejemplo de código siguiente muestra todos los parámetros disponibles para el comando create-blueprint:

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

Consulta de las configuraciones de esquemas

Enumeración de todos los esquemas

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

Sintaxis

aws bedrock-data-automation list-blueprints

Consulta de los detalles del esquema

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

Sintaxis

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

Inspección de una versión específica

Cuando trabaje con esquemas con control de versiones, 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"

Inspección de una etapa específica

Para ver los esquemas en la etapa EN DESARROLLO o EN DIRECTO, utilice:


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

Edición de especificaciones del esquema

Actualización de la configuración del esquema

Para modificar la estructura o las propiedades de un esquema 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 esquema, debe proporcionar la estructura completa, incluso para los campos que no vaya a cambiar.

Promoción a EN DIRECTO

Para pasar un esquema de la etapa EN DESARROLLO a EN DIRECTO, 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 del esquema

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

Sintaxis

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

Administración de etiquetas de esquemas

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

Añada etiquetas

Aplique metadatos a su esquema añadiendo etiquetas.

Sintaxis

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

Eliminar etiquetas

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

Sintaxis

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

Consulta de etiquetas

Haz una lista de todas las etiquetas asociadas a tu Blueprint mediante el list-tags-for-resource comando.

Sintaxis

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

Creación de esquemas

Eliminación de un esquema completo

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

Sintaxis

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

Precaución: Este comando elimina un esquema de forma permanente y no lo puede recuperar.

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

Optimización del plano

Invocando la optimización de planos

Inicie un trabajo de optimización asíncrona del plan para mejorar las instrucciones del plano para cada uno de los campos del plan y la precisión de los resultados.

Sintaxis

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"

Comprobación del estado de la optimización del plano

Supervise el progreso y los resultados de un trabajo de optimización de planos.

Sintaxis

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

Utilice este comando para realizar un seguimiento del estado del trabajo de optimización. La respuesta incluye el estado actual (Creado InProgress ServiceError, Éxito o ClientError) y los detalles de la configuración de salida una vez completada.

Copiar las etapas del plano

Copie un plano de una etapa a otra

Sintaxis

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

Precaución: Este comando copia toda la configuración del blueprint desde la etapa de origen a la etapa de destino y sobrescribe cualquier configuración existente en la etapa de destino.

Importante: Asegúrese de que el blueprint se haya probado exhaustivamente en la fase de origen antes de copiarlo a la fase de producción (LIVE). Esta operación no se puede deshacer fácilmente.