本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

蓝图操作 CLI

本指南涵盖了通过 AWS Amazon Bedrock 数据自动化命令行接口 (CLI) (BDA) 提供的蓝图操作。

创建蓝图

蓝图定义了要从文档、图像、音频或视频文件中提取的数据的结构和属性。使用 create-blueprint 命令定义新的蓝图。

以下命令创建一个专为从护照图像中提取数据而定制的新蓝图。

语法

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

完整参数参考

下表显示 create-blueprint 命令的所有可用参数。

查看蓝图配置

列出所有蓝图

使用 list-blueprints 命令检索与您账户关联的所有蓝图的列表。

语法

aws bedrock-data-automation list-blueprints

查看蓝图详细信息

要查看有关特定蓝图的详细信息，包括其架构和配置，请使用 get-blueprint 命令。

语法

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

检查特定版本

使用具有版本控制的蓝图时，通过 get-blueprint 命令和 --blueprint-version 选项来查看特定版本。

语法

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

检查特定阶段

要查看处于 DEVELOPMENT 或 LIVE 阶段的蓝图，请使用：

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

编辑蓝图规范

更新蓝图设置

要修改现有蓝图的架构或属性，请使用 update-blueprint 命令。

语法

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

注意：更新蓝图时，即使对于您没有进行更改的字段，也必须提供完整的架构。

提升为 LIVE

要将蓝图从 DEVELOPMENT 阶段转到 LIVE 阶段用于生产，请使用 update-blueprint 命令和 --blueprint-阶段选项。

语法

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

蓝图版本控制

在使用 create-blueprint-version命令进行重大更改之前，创建蓝图的新版本以保留其当前状态。

语法

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

管理蓝图标签

标签可帮助用户整理和分类蓝图，从而简化管理。

添加标签

通过添加标签将元数据应用到蓝图。

语法

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

移除标签

使用 untag-resource 命令从蓝图中移除特定标签。

语法

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

查看标签

使用 list-tags-for-resource命令列出与您的蓝图关联的所有标签。

语法

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

删除蓝图

删除整个蓝图

使用 delete-blueprint 命令永久删除蓝图及其所有版本。

语法

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

注意：此命令将永久删除蓝图且无法将其恢复。

重要提示：您不能删除当前由任何项目使用的蓝图。删除蓝图之前，请确保该蓝图未在任何项目的自定义输出配置中引用。

蓝图优化

调用蓝图优化

启动异步蓝图优化作业，以改进蓝图对每个蓝图字段的指令和结果的准确性。

语法

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"

检查蓝图优化状态

监控蓝图优化作业的进度和结果。

语法

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

使用此命令跟踪优化作业的状态。完成后，响应包括当前状态（已创建 InProgress ServiceError、、成功或 ClientError）和输出配置详细信息。

复制蓝图阶段

将蓝图从一个关卡复制到另一个阶段

语法

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

注意：此命令将整个蓝图配置从源阶段复制到目标阶段，覆盖目标阶段中的任何现有配置。

重要：在复制到生产 (LIVE) 阶段之前，请确保蓝图在源代码阶段经过全面测试。无法方便地撤消该操作。