翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon Bedrock データ自動化 (BDA) 機能は、データを処理するための合理化された API ワークフローを提供します。すべてのモダリティについて、このワークフローは、プロジェクトの作成、分析の呼び出し、結果の取得の 3 つの主要なステップで構成されます。処理されたデータのカスタム出力を取得するには、分析オペレーションを呼び出すときにブループリント ARN を指定します。
データ自動化プロジェクトを作成する
BDA でファイルの処理を開始するには、まずデータ自動化プロジェクトを作成する必要があります。これは、CreateDataAutomationProject オペレーションまたは Amazon Amazon Bedrock コンソールの 2 つの方法で実行できます。
API を使用する
API を使用してプロジェクトを作成する場合は、CreateDataAutomationProject を呼び出します。プロジェクトを作成するときは、処理する傾向のあるファイルの種類 (使用するモダリティ) の設定を定義する必要があります。イメージの標準出力を設定する方法の例を次に示します。
{
"standardOutputConfiguration": {
"image": {
"state": "ENABLED",
"extraction": {
"category": {
"state": "ENABLED",
"types": [
"CONTENT_MODERATION",
"TEXT_DETECTION"
]
},
"boundingBox": {
"state": "ENABLED"
}
},
"generativeField": {
"state": "ENABLED",
"types": [
"IMAGE_SUMMARY",
"IAB"
]
}
}
}
}API は入力設定を検証します。一意の ARN を持つ新しいプロジェクトが作成されます。プロジェクト設定は、将来の使用のために保存されます。パラメータなしでプロジェクトが作成された場合、デフォルト設定が適用されます。たとえば、画像を処理する場合、画像の要約とテキスト検出はデフォルトで有効になります。
AWS アカウントごとに作成できるプロジェクトの数には制限があります。特定の設定の組み合わせは許可されないか、追加のアクセス許可が必要になる場合があります。
データ自動化非同期を呼び出す
プロジェクトがセットアップされており、InvokeDataAutomationAsync オペレーションを使用してイメージの処理を開始できます。カスタム出力を使用する場合、リクエストごとに送信できるブループリント ARN は 1 つだけです。
この API コールは、指定された S3 バケット内のファイルの非同期処理を開始します。API は、処理するプロジェクト ARN とファイルを受け入れ、非同期処理ジョブを開始します。プロセスを追跡するためにジョブ ID が返されます。プロジェクトが存在しない場合、発信者に必要なアクセス許可がない場合、または入力ファイルがサポートされている形式でない場合、エラーが発生します。
JSON リクエストの構造は次のとおりです。
{ { "blueprints": [ { "blueprintArn": "string", "stage": "string", "version": "string" } ], "clientToken": "string", "dataAutomationConfiguration": { "dataAutomationProjectArn": "string", "stage": "string" }, "dataAutomationProfileArn": "string", "encryptionConfiguration": { "kmsEncryptionContext": { "string" : "string" }, "kmsKeyId": "string" }, "inputConfiguration": { "s3Uri": "string" }, "notificationConfiguration": { "eventBridgeConfiguration": { "eventBridgeEnabled":boolean} }, "outputConfiguration": { "s3Uri": "string" }, "tags": [ { "key": "sstring", "value": "string" } ] } }
データ自動化ステータスの取得
処理ジョブのステータスを確認し、結果を取得するには、GetDataAutomationStatus を使用します。
GetDataAutomationStatus API を使用すると、ジョブの進行状況をモニタリングし、処理が完了したら結果にアクセスできます。API は、InvokeDataAutomationAsync によって返される呼び出し ARN を受け入れます。ジョブの現在のステータスをチェックし、関連情報を返します。ジョブが完了すると、S3 で結果の場所が提供されます。
ジョブがまだ進行中の場合は、現在の状態 (「InProgress」など) を返します。ジョブが完了すると、結果の S3 の場所とともに「成功」が返されます。エラーが発生した場合、エラーの詳細とともに「ServiceError」または「ClientError」を返します。
リクエスト JSON の形式は次のとおりです。
{
"InvocationArn": "string" // Arn
}非同期出力レスポンス
ファイル処理の結果は、入力イメージ用に設定された S3 バケットに保存されます。出力には、InvokeDataAutomationAsync の呼び出しで指定されたファイルモダリティとオペレーションタイプの両方に応じて、一意の構造が含まれます。
特定のモダリティの標準出力の詳細については、「」を参照してくださいBedrock Data Automation の標準出力。
たとえば、イメージには、次の情報を含めることができます。
イメージの概要: イメージのわかりやすい概要またはキャプション。
IAB 分類: IAB 分類に基づく分類。
イメージテキスト検出: 境界ボックス情報を含む抽出テキスト。
コンテンツのモデレーション: イメージ内の不適切、望ましくない、または不快なコンテンツを検出します。
以下は、画像処理の出力のスニペットの例です。
{
"metadata": {
"id": "image_123",
"semantic_modality": "IMAGE",
"s3_bucket": "my-s3-bucket",
"s3_prefix": "images/",
"image_width_pixels": 1920,
"image_height_pixels": 1080
},
"image": {
"summary": "A lively party scene with colorful decorations and supplies",
"iab_categories": [
{
"category": "Party Supplies",
"confidence": 0.9,
"parent_name": "Events & Attractions"
}
],
"content_moderation": [
{
"category": "Drugs & Tobacco Paraphernalia & Use",
"confidence": 0.7
}
],
"text_words": [
{
"id": "word_1",
"text": "lively",
"confidence": 0.9,
"line_id": "line_1",
"locations": [
{
"bounding_box": {
"left": 100,
"top": 200,
"width": 50,
"height": 20
},
"polygon": [
{
"x": 100,
"y": 200
},
{
"x": 150,
"y": 200
},
{
"x": 150,
"y": 220
},
{
"x": 100,
"y": 220
}
]
}
]
}
]
}
}この構造化された出力により、ダウンストリームアプリケーションとの統合とさらなる分析が容易になります。
