翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ブループリント操作の CLI
このガイドでは、AWS Command Line Interface (CLI) for Amazon BedrockData Automation (BDA) を通じて利用できる設計図オペレーションについて説明します。
ブループリントの作成
ブループリントは、ドキュメント、画像、音声、または動画のファイルから抽出するデータの構造とプロパティを定義します。新しいブループリントを定義するには、create-blueprint コマンドを使用します。
以下のコマンドは、パスポート画像からデータを抽出するための新しいブループリントを作成します。
[Syntax] (構文)
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 コマンドで利用可能なパラメータの一覧です。
| [Parameter] (パラメータ) | 必須 | デフォルト | [Description] (説明) |
|---|---|---|---|
--blueprint-name |
はい | 該当なし | ブループリントの名前 |
--type |
はい | 該当なし | コンテンツタイプ (画像、ドキュメント、音声、動画) |
--blueprint-stage |
不可 | LIVE | ブループリントのステージ (開発環境または本番環境) |
--schema |
はい | 該当なし | ブループリントの構造を定義する JSON スキーマ |
--client-token |
不可 | 自動生成 | リクエストのべき等性を確保するための一意の識別子 |
ブループリント設定の表示
すべてのブループリントを一覧表示する
アカウントに関連付けられているすべてのブループリントのリストを取得するには、list-blueprints コマンドを使用します。
[Syntax] (構文)
aws bedrock-data-automation list-blueprints
ブループリントの詳細を表示する
スキーマや構成など、特定のブループリントに関する詳細情報を表示するには、get-blueprint コマンドを使用します。
[Syntax] (構文)
aws bedrock-data-automation get-blueprint \ --blueprint-arn "Amazon Resource Name (ARN)"
特定のバージョンを検査する
バージョン管理されたブループリントを使用する場合に、特定のバージョンを表示するには、get-blueprint コマンドで --blueprint-version オプションを使用します。
[Syntax] (構文)
aws bedrock-data-automation get-blueprint \ --blueprint-arn "Amazon Resource Name (ARN)" \ --blueprint-version "version-number"
特定のステージを検査する
開発ステージまたは本番環境ステージでブループリントを表示するには、以下を使用します。
aws bedrock-data-automation get-blueprint \ --blueprint-arn "Amazon Resource Name (ARN)" \ --blueprint-stage "LIVE"
ブループリントの仕様の編集
ブループリント設定を更新する
既存のブループリントのスキーマまたはプロパティを変更するには、update-blueprint コマンドを使用します。
[Syntax] (構文)
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" } } }'
注: ブループリントを更新する際は、変更しないフィールドであっても、完全なスキーマを指定する必要があります。
本番環境に昇格する
ブループリントを本番稼働のために開発ステージから本番環境ステージに移動させるには、update-blueprint コマンドで、--blueprint-stage オプションを使用します。
[Syntax] (構文)
aws bedrock-data-automation update-blueprint \ --blueprint-arn "Amazon Resource Name (ARN)" \ --blueprint-stage "LIVE"
ブループリントのバージョニング
大幅な変更を加える前に、create-blueprint-version コマンドを使用してブループリントの新しいバージョンを作成し、現在の状態を保存します。
[Syntax] (構文)
aws bedrock-data-automation create-blueprint-version \ --blueprint-arn "Amazon Resource Name (ARN)"
ブループリントタグの管理
タグを使用すると、ブループリントを整理および分類して、管理を簡素化するのに役立ちます。
タグを追加する
タグを追加して、メタデータをブループリントに適用します。
[Syntax] (構文)
aws bedrock-data-automation tag-resource \ --resource-arn "Amazon Resource Name (ARN)" \ --tags '{"Department":"Finance","Project":"PassportProcessing"}'
タグを削除する
untag-resource コマンドを使用して、ブループリントから特定のタグを削除します。
[Syntax] (構文)
aws bedrock-data-automation untag-resource \ --resource-arn "Amazon Resource Name (ARN)" \ --tag-keys '["Department","Project"]'
タグを表示する
ブループリントに関連付けられているすべてのタグを一覧表示するには、list-tags-for-resource コマンドを使用します。
[Syntax] (構文)
aws bedrock-data-automation list-tags-for-resource \ --resource-arn "Amazon Resource Name (ARN)"
ブループリントの削除
ブループリント全体を削除する
ブループリントとブループリントのすべてのバージョンを完全に削除するには、delete-blueprint コマンドを使用します。
[Syntax] (構文)
aws bedrock-data-automation delete-blueprint \ --blueprint-arn "Amazon Resource Name (ARN)"
注: このコマンドはブループリントを完全に削除するため、復元することはできません。
重要: 現在いずれかのプロジェクトで使用されているブループリントは、削除することはできません。削除する前に、プロジェクトのカスタム出力設定でブループリントが参照されていないことを確認する必要があります。
設計図の最適化
設計図の最適化の呼び出し
非同期ブループリント最適化ジョブを開始して、各ブループリントフィールドのブループリントの指示と結果の精度を向上させます。
[Syntax] (構文)
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"
設計図の最適化ステータスの確認
ブループリント最適化ジョブの進行状況と結果をモニタリングします。
[Syntax] (構文)
aws bedrock-data-automation get-blueprint-optimization-status \ --invocation-arn "arn:aws:bedrock:<region>:<account_id>:blueprint-optimization-invocation/opt-12345abcdef"
このコマンドを使用して、最適化ジョブのステータスを追跡します。レスポンスには、現在のステータス (作成済み、InProgress、成功、ServiceError、または ClientError) と、完了時の出力設定の詳細が含まれます。
設計図ステージのコピー
あるステージから別のステージにブループリントをコピーする
[Syntax] (構文)
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) ステージにコピーする前に、ブループリントがソースステージで徹底的にテストされていることを確認します。この操作は簡単に元に戻すことができません。
