Amazon BedrockData Automation CLI の使用 - Amazon Bedrock
最初の Data Automation プロジェクトを作成する完全なパラメータのリファレンスブループリントの作成ブループリントの使用ドキュメントを処理する処理ステータスを確認する結果を取得するイメージを同期的に処理する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon BedrockData Automation CLI の使用

Amazon Bedrockデータ自動化 (BDA) 機能は、データを処理するための合理化された CLI ワークフローを提供します。すべてのモダリティにおいて、このワークフローは、プロジェクトの作成、カスタム出力用のブループリントの作成、ドキュメントの処理という 3 つの主要なステップで構成されます。このガイドでは、BDA を使用するための主要な CLI コマンドについて説明します。

最初の Data Automation プロジェクトを作成する

BDA の使用を開始するには、まず create-data-automation-project コマンドを使用してプロジェクトを作成します。

処理の対象となる次のサンプルパスポートについて考えてみましょう。

プロジェクトを作成するときは、処理するファイルのタイプの構成設定を定義する必要があります。次のコマンドは、画像処理プロジェクトを作成するための最小限の実例を示しています。

aws bedrock-data-automation create-data-automation-project \
    --project-name "ImageProcessingProject" \
    --standard-output-configuration '{
        "image": {
            "extraction": {
                "category": {
                    "state": "ENABLED",
                    "types": ["TEXT_DETECTION"]
                },
                "boundingBox": {
                    "state": "ENABLED"
                }
            },
            "generativeField": {
                "state": "ENABLED"
            }
        }
    }'

このコマンドは、入力設定を検証し、一意の ARN を持つ新しいプロジェクトを作成します。レスポンスには、プロジェクトの ARN とステージが含まれます。

{
    "projectArn": "Amazon Resource Name (ARN)",
    "projectStage": "DEVELOPMENT",
    "status": "IN_PROGRESS"
}

パラメータを指定せずにプロジェクトを作成した場合、デフォルト設定が適用されます。例えば、画像を処理する場合、画像の要約とテキスト検出がデフォルトで有効になります。

完全なパラメータのリファレンス

次の表は、create-data-automation-project コマンドで利用可能なパラメータの一覧です。

create-data-automation-project のパラメータ
[Parameter] (パラメータ) 必須 デフォルト [Description] (説明)
--project-name はい 該当なし Data Automation プロジェクトの名前
--project-type 不可 プロジェクトのタイプは、使用できるランタイム処理 API を定義します。 ASYNCプロジェクトは invoke-bedrock-data-automation-async API でのみ使用できますが、 SYNC プロジェクトは invoke-bedrock-data-automation API でのみ使用できます。
--project-stage 不可 LIVE プロジェクトのステージ (DEVELOPMENT または LIVE)
--standard-output-configuration はい 該当なし 標準出力処理の JSON 設定
--custom-output-configuration 不可 該当なし カスタム出力処理の JSON 設定
--encryption-configuration 不可 該当なし プロジェクトの暗号化設定
--client-token 不可 自動生成 リクエストのべき等性を確保するための一意の識別子

ブループリントの作成

プロジェクトを作成したら、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"
            }
        }
    }'

このコマンドは、指定されたスキーマを使用して新しいブループリントを作成します。ドキュメントを処理するときにこのブループリントを使用すると、定義されたスキーマに従って構造化データを抽出できます。

ブループリントの使用

プロジェクトへのブループリントの追加

プロジェクトにブループリントを追加するには、update-data-automation-project コマンドを使用します。

aws bedrock-data-automation update-data-automation-project \
    --project-arn "Amazon Resource Name (ARN)" \
    --standard-output-configuration '{
        "image": {
            "extraction": {
                "category": {
                    "state": "ENABLED",
                    "types": ["TEXT_DETECTION"]
                },
                "boundingBox": {
                    "state": "ENABLED"
                }
            },
            "generativeField": {
                "state": "ENABLED",
                "types": ["IMAGE_SUMMARY"]
            }
        }
    }' \
    --custom-output-configuration '{
        "blueprints": [
            {
                "blueprintArn": "Amazon Resource Name (ARN)",
                "blueprintVersion": "1",
                "blueprintStage": "LIVE"
            }
        ]
    }'

ブループリントの統合の検証

get-data-automation-project コマンドを使用してブループリントの統合を検証できます。

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

複数のブループリントの管理

すべてのブループリントを表示するには、list-blueprints コマンドを使用します。

aws bedrock-data-automation list-blueprints

ドキュメントを処理する

プロジェクトをセットアップしたら、invoke-data-automation-async コマンドを使用してドキュメントを処理できます。

aws bedrock-data-automation-runtime invoke-data-automation-async \
    --input-configuration '{
        "s3Uri": "s3://my-bda-documents/invoices/invoice-123.pdf"
    }' \
    --output-configuration '{
        "s3Uri": "s3://my-bda-documents/output/"
    }' \
    --data-automation-configuration '{
        "dataAutomationProjectArn": "Amazon Resource Name (ARN)",
        "stage": "LIVE"
    }' \
    --data-automation-profile-arn "Amazon Resource Name (ARN)"

このコマンドは、処理ステータスの確認に使用できる呼び出し ARN を返します。

{
    "invocationArn": "Amazon Resource Name (ARN)"
}

処理ステータスを確認する

処理ジョブのステータスを確認するには、get-data-automation-status コマンドを使用します。

aws bedrock-data-automation-runtime get-data-automation-status \
    --invocation-arn "Amazon Resource Name (ARN)"

このコマンドは、処理ジョブの現在のステータスを返します。

{
    "status": "COMPLETED",
    "creationTime": "2025-07-09T12:34:56.789Z",
    "lastModifiedTime": "2025-07-09T12:45:12.345Z",
    "outputLocation": "s3://my-bda-documents/output/efgh5678/"
}

可能なステータス値は以下のとおりです。

  • IN_PROGRESS: 処理ジョブは現在実行中です。

  • COMPLETED: 処理ジョブは正常に完了しました。

  • FAILED: 処理ジョブは失敗しました。エラーの詳細については、レスポンスを確認してください。

  • STOPPED: 処理ジョブは手動で停止されました。

結果を取得する

処理が完了したら、S3 バケット内の出力ファイルを一覧表示できます。

aws s3 ls s3://my-bda-documents/output/efgh5678/

結果をローカルマシンにダウンロードするには:

aws s3 cp s3://my-bda-documents/output/efgh5678/ ~/Downloads/bda-results/ --recursive

出力には、プロジェクト設定と適用したブループリントに基づく構造化データが含まれます。

イメージを同期的に処理する

コマンドは、プロジェクト設定と適用したブループリントに基づいて構造化データを返します。

aws bedrock-data-automation-runtime invoke-data-automation \
    --input-configuration '{
        "s3Uri": "s3://my-bda-documents/invoices/advertisement_latest.jpeg"
    }' \
    --data-automation-configuration '{
        "dataAutomationProjectArn": "Amazon Resource Name (ARN)",
        "stage": "LIVE"
    }' \
    --data-automation-profile-arn "Amazon Resource Name (ARN)"