Converse API を使用する場合

text フィールドは、プロンプトを指定する文字列にマッピングされます。text フィールドは、同じ ContentBlock で指定された他のフィールドとともに解釈されます。

（オプション) 特定のモデルでは、cachePointフィールドを使用してキャッシュチェックポイントを追加してプロンプトキャッシュを利用できます。プロンプトキャッシュは、会話のコンテキストのキャッシュを開始して、コストとレイテンシーを節約できる機能です。詳細については、「モデル推論を高速化するためのプロンプトキャッシュ」を参照してください。

以下は、テキスト ContentBlock のみを含む content 配列を持つ Message オブジェクトを示しています。

{
    "role": "user | assistant",
    "content": [
        {
            "text": "string"
        }
    ]
}

以下は、テキスト ContentBlock とオプションの cachePointフィールドを含むcontent配列を持つ Message オブジェクトを示しています。その結果、テキスト ContentBlock のコンテンツがキャッシュに追加されます。

{
    "role": "user | assistant",
    "content": [
        {
            "text": "string"
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

image フィールドは ImageBlock にマッピングされます。base64 でエンコードされた raw バイトを、bytes フィールド内の画像に渡します。 AWS SDK を使用する場合、base64 でバイトをエンコードする必要はありません。

text フィールドを除外すると、モデルはイメージを記述します。

（オプション) 特定のモデルでは、cachePointフィールドを使用してキャッシュチェックポイントを追加してプロンプトキャッシュを利用できます。プロンプトキャッシュは、会話のコンテキストのキャッシュを開始して、コストとレイテンシーを節約できる機能です。詳細については、「モデル推論を高速化するためのプロンプトキャッシュ」を参照してください。

以下は、画像 ContentBlock のみを含む content 配列を持つ Message オブジェクトを示しています。

{
    "role": "user",
    "content": [
        {
            "image": {
                "format": "png | jpeg | gif | webp",
                "source": {
                    "bytes": "image in bytes"
                }
            }
        }
    ]
}

以下は、イメージ ContentBlock とオプションの cachePointフィールドを含むcontent配列を持つ Message オブジェクトを示しています。その結果、イメージコンテンツがキャッシュに追加されます。

{
    "role": "user",
    "content": [
        {
            "image": {
                "format": "png | jpeg | gif | webp",
                "source": {
                    "bytes": "image in bytes"
                }
            }
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

document フィールドは DocumentBlock にマッピングされます。DocumentBlock を含める場合は、リクエストが次の制限に準拠していることを確認します。

（オプション) 特定のモデルでは、cachePointフィールドを使用してキャッシュチェックポイントを追加してプロンプトキャッシュを利用できます。プロンプトキャッシュは、会話のコンテキストのキャッシュを開始して、コストとレイテンシーを節約できる機能です。詳細については、「モデル推論を高速化するためのプロンプトキャッシュ」を参照してください。

以下は、ドキュメント ContentBlock と必須の付随テキスト ContentBlock のみを含む content 配列を持つ Message オブジェクトを示しています。

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf | csv | doc | docx | xls | xlsx | html | txt | md",
                "name": "string",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        }
    ]
}

以下は、ドキュメント ContentBlock と必須の付随するテキスト ContentBlock を含むcontent配列と、ドキュメントとテキストの両方のコンテンツをキャッシュに追加する cachePoint を含む Message オブジェクトを示しています。

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf | csv | doc | docx | xls | xlsx | html | txt | md",
                "name": "string",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

video フィールドは VideoBlock オブジェクトにマッピングされます。base64 でエンコードされた bytesフィールドに raw バイトを渡します。 AWS SDK を使用する場合、base64 でバイトをエンコードする必要はありません。

text フィールドを含めない場合、モデルは動画を記述します。

以下は、動画 ContentBlock のみを含むcontent配列を持つ Message オブジェクトを示しています。

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mov | mkv | mp4 | webm | flv | mpeg | mpg | wmv | three_gp",
                "source": {
                    "bytes": "video in bytes"
                }
            }
        }
    ]
}

.3gp 拡張子が のファイルの場合、形式を として指定する必要がありますthree_gp。

リクエストボディでバイトを直接渡す代わりに、Amazon S3 URI を介して動画を渡すこともできます。以下は、Amazon S3 URI を介して渡されたビデオソースを持つビデオのみを含むコンテンツ配列ContentBlockを持つMessageオブジェクトを示しています。

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mov | mkv | mp4 | webm | flv | mpeg | mpg | wmv | three_gp",
                "source": {
                    "s3Location": {
                        "uri": "${S3Uri}",
                        "bucketOwner": "${AccountId}"
                    }
                }
            }
        }
    ]
}

s3Location パラメータは、米国東部 (バージニア北部) リージョンでのみサポートされています。

guardContent フィールドは GuardrailConverseContentBlock オブジェクトにマッピングされます。このフィールドを使用して、 guardrailConfigフィールドで定義されたガードレールによって評価される入力をターゲットにすることができます。このフィールドを指定しない場合、ガードレールはリクエストボディ内のすべてのメッセージを評価します。では、次のタイプのコンテンツを渡すことができますGuardBlock。

ガードレールの使用の詳細については、「」を参照してくださいAmazon Bedrock ガードレールを使用してモデルで有害なコンテンツを阻止する。

reasoningContent フィールドは ReasoningContentBlock にマッピングされます。このブロックには、付随する でレスポンスを生成するためにモデルによって実行された推論に関するコンテンツが含まれていますContentBlock。

以下は、 とそれに付随するテキスト のみを含むcontent配列ReasoningContentBlockを持つ Message オブジェクトを示していますContentBlock。

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "reasoningContent": {
                "reasoningText": {
                    "text": "string",
                    "signature": "string"
                }
                "redactedContent": "base64-encoded binary data object"
            }
        }
    ]
}

ReasoningContentBlock には、 reasoningTextフィールドに付随するコンテンツを生成するために使用される推論と、 redactedContent フィールドの信頼と安全の理由でモデルプロバイダーによって暗号化された推論の内容が含まれます。

reasoningText フィールド内では、textフィールドは推論を記述します。signature フィールドは会話内のすべてのメッセージのハッシュであり、モデルで使用される推論の改ざんに対する保護手段です。後続のConverseリクエストには、署名と以前のメッセージをすべて含める必要があります。メッセージのいずれかが変更されると、レスポンスはエラーをスローします。

使用するモデルのツールに関する情報が含まれています。詳細については、「ツールを使用して Amazon Bedrock のモデルレスポンスを完成させる」を参照してください。

ツールを使用したモデルの結果に関する情報が含まれます。詳細については、「ツールを使用して Amazon Bedrock のモデルレスポンスを完成させる」を参照してください。