使用 Converse API

text 字段会映射到指定提示的字符串。该text字段与同一字段中指定的其他字段一起解释ContentBlock。

下面显示了一个 M essag e 对象，其content数组仅包含文本 ContentBlock：

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

该image字段映射到 ImageBlock. 为 bytes 字段中的图像传递以 base64 编码的原始字节。如果您使用 AWS 软件开发工具包，则无需在 base64 中对字节进行编码。

如果您排除该text字段，则模型将描述图像。

下面显示了一个示例 Mess ag e 对象，其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，请检查您的请求是否符合以下限制：

下面显示了一个示例 Mess ag e 对象，其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 软件开发工具包，则无需在 base64 中对字节进行编码。

如果您不包括该text字段，则模型将描述视频。

下面显示了一个示例 Mess ag e 对象，其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字段来利用提示缓存，在消息中将缓存检查点作为一个块添加到随附的提示旁边。提示缓存是一项功能，可让您开始缓存对话上下文，从而节省成本和延迟。有关更多信息，请参阅 提示缓存以加快模型推断速度。

下面显示了一个示例 Mess ag e 对象，该对象包含一个包含文档ContentBlock和必需的随附文本的content数组 ContentBlock，以及一个将文档和文本内容都添加到缓存中的 CachePoint。

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

该guardContent字段映射到一个GuardrailConverseContentBlock对象。您可以使用此字段来定位要由字段中定义的护栏评估的guardrailConfig输入。如果您未指定此字段，则护栏会评估请求正文中的所有消息。您可以在 a 中传递以下类型的内容GuardBlock：

有关使用护栏的更多信息，请参阅。使用 Amazon Bedrock Guardrails 检测和过滤有害内容

该reasoningContent字段映射到 a ReasoningContentBlock. 此区块包含有关模型为生成随附响应而执行的推理的内容ContentBlock。

下面显示了一个Message对象，其content数组仅包含 a 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 模型响应。