使用 Converse API

text 欄位會對應至指定提示的字串。系統會將 text 欄位與其他在相同 ContentBlock 中指定的欄位一起解譯。

以下顯示 Message 物件，其 content 陣列僅包含文字 ContentBlock：

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

image 欄位會對應至 ImageBlock。傳遞 bytes 欄位中影像的原始位元組 (以 base64 編碼)。如果您使用 AWS SDK，則不需要對 base64 中的位元組進行編碼。

如果您排除 text 欄位，則模型會描述影像。

以下顯示範例 Message 物件，其 content 陣列僅包含影像 ContentBlock：

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

您也可以指定 Amazon S3 URI (而不是直接在請求內文中傳遞位元組)。以下顯示具有內容陣列的範例 Message 物件，其中包含透過 Amazon S3 URI 傳遞的來源。

{
    "role": "user",
    "content": [
        {
            "image": {
                "format": "png",
                "source": {
                    "s3Location": {
                        "uri": "s3://amzn-s3-demo-bucket/myImage",
                        "bucketOwner": "111122223333"
                    }
                }
            }
        }
    ]
}

document 欄位對應至 DocumentBlock。如果您包含 DocumentBlock，請檢查請求是否符合下列限制：

使用文件時，您可以啟用 citations 標籤，這會在 API 呼叫的回應中提供文件特定的引文。如需詳細資訊，請參閱 DocumentBlock API。

以下顯示範例 Message 物件，其 content 陣列僅包含文件 ContentBlock 和必要的隨附文字 ContentBlock。

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf",
                "name": "MyDocument",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        }
    ]
}

您也可以指定 Amazon S3 URI (而不是直接在請求內文中傳遞位元組)。以下顯示具有內容陣列的範例 Message 物件，其中包含透過 Amazon S3 URI 傳遞的來源。

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf",
                "name": "MyDocument",
                "source": {
                    "s3Location": {
                      "uri": "s3://amzn-s3-demo-bucket/myDocument",
                      "bucketOwner": "111122223333"
                    }
                }
            }
        }
    ]
}

video 欄位會對應至 VideoBlock 物件。傳遞 bytes 欄位中的原始位元組 (以 base64 編碼)。如果您使用 AWS SDK，則不需要對 base64 中的位元組進行編碼。

如果您未包含 text 欄位，模型會描述影片。

以下顯示範例 Message 物件，其 content 陣列僅包含影片 ContentBlock。

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mp4",
                "source": {
                    "bytes": "video in bytes"
                }
            }
        }
    ]
}

您也可以指定 Amazon S3 URI (而不是直接在請求內文中傳遞位元組)。以下顯示具有內容陣列的範例 Message 物件，其中包含透過 Amazon S3 URI 傳遞的來源。

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mp4",
                "source": {
                    "s3Location": {
                        "uri": "s3://amzn-s3-demo-bucket/myVideo",
                        "bucketOwner": "111122223333"
                    }
                }
            }
        }
    ]
}

您可以使用 cachePoint 欄位，將快取檢查點新增為訊息中的區塊搭配隨附的提示，來利用提示快取。提示快取是一項功能，可讓您開始快取對話的內容，以節省成本和減少延遲。如需詳細資訊，請參閱 提示快取可加快模型推論速度。

以下顯示範例 Message 物件，其 content 陣列包含文件 ContentBlock 和必要的隨附文字 ContentBlock，以及同時將文件和文字內容新增至快取的 cachePoint。

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf",
                "name": "string",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

guardContent 欄位會對應至 GuardrailConverseContentBlock 物件。您可以使用此欄位，將要由 guardrailConfig 欄位中定義的防護機制評估的輸入設為目標。如果您未指定此欄位，防護機制會評估請求內文中的所有訊息。您可以在 GuardBlock 中傳遞下列類型的內容：

如需防護機制的使用詳細資訊，請參閱使用 Amazon Bedrock 防護機制偵測和篩選有害內容。

reasoningContent 欄位會對應至 ReasoningContentBlock。此區塊包含有關模型在隨附 ContentBlock 中產生回應所執行之推理的內容。

以下顯示 Message 物件，其 content 陣列僅包含 ReasoningContentBlock 和隨附的文字 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 模型回應。