Mediante la API de Converse

El campo text se asigna a una cadena que especifica la petición. El text campo se interpreta junto con otros campos que se especifican en el mismo ContentBlock.

A continuación, se muestra un objeto Message con una content matriz que contiene solo un texto ContentBlock:

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

El image campo se asigna a un ImageBlock. Transfiera los bytes sin procesar, codificados en base64, a una imagen del campo bytes. Si utilizas un AWS SDK, no necesitas codificar los bytes en base64.

Si excluye el campo text, el modelo describirá la imagen.

A continuación, se muestra un ejemplo de objeto Message con una content matriz que contiene solo una imagen: ContentBlock

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

También puede especificar un URI de Amazon S3 en lugar de pasar los bytes directamente al cuerpo de la solicitud. A continuación, se muestra un objeto Message de ejemplo con una matriz de contenido que contiene el origen pasado a través de un URI de Amazon S3.

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

El document campo se asigna a un DocumentBlock. Si incluye un DocumentBlock, compruebe que su solicitud cumpla las siguientes restricciones:

Al usar un documento, puede habilitar la etiqueta citations, que proporcionará citas específicas del documento en respuesta a la llamada a la API. Consulte la DocumentBlockAPI para obtener más detalles.

A continuación, se muestra un ejemplo de objeto Message con una content matriz que contiene solo un documento ContentBlocky el texto adjunto obligatorio ContentBlock.

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

También puede especificar un URI de Amazon S3 en lugar de pasar los bytes directamente al cuerpo de la solicitud. A continuación, se muestra un objeto Message de ejemplo con una matriz de contenido que contiene el origen pasado a través de un URI de Amazon S3.

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

El video campo se asigna a un VideoBlockobjeto. Pase los bytes sin procesar, codificados en base64, al campo bytes. Si usa el AWS SDK, no necesita codificar los bytes en base64.

Si no incluye el campo text, el modelo describirá el vídeo.

A continuación, se muestra un ejemplo de objeto Message con una content matriz que contiene solo un vídeo. ContentBlock

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

También puede especificar un URI de Amazon S3 en lugar de pasar los bytes directamente al cuerpo de la solicitud. A continuación, se muestra un objeto Message de ejemplo con una matriz de contenido que contiene el origen pasado a través de un URI de Amazon S3.

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

Puede añadir puntos de comprobación de caché en forma de bloque en un mensaje junto con la petición correspondiente. Para ello, utilice los campos cachePoint para usar el almacenamiento en caché de peticiones. El almacenamiento en caché de peticiones es una característica que le permite empezar a almacenar en caché el contexto de las conversaciones para ahorrar costos y latencia. Para obtener más información, consulte Almacenamiento en caché de peticiones para una inferencia de modelos más rápida.

A continuación se muestra un ejemplo de objeto Message con una content matriz que contiene un documento ContentBlocky el texto correspondiente obligatorio ContentBlock, así como un CachePoint que añade el contenido del documento y del texto a la caché.

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

El guardContent campo se asigna a un GuardrailConverseContentBlockobjeto. Puede usar este campo para seleccionar una entrada para que la evalúe la barrera de protección definida en el campo guardrailConfig. Si no especifica este campo, la barrera de protección evalúa todos los mensajes del cuerpo de la solicitud. Puede pasar los siguientes tipos de contenido a un GuardBlock:

Para obtener más información acerca de las barreras de protección, consulte Detección y filtrado del contenido dañino mediante Barreras de protección para Amazon Bedrock.

El reasoningContent campo se asigna a ReasoningContentBlock. Este bloque incluye contenido sobre el razonamiento llevado a cabo por el modelo para generar la respuesta en el ContentBlock adjunto.

A continuación, se muestra un objeto Message con una matriz content que contiene solo un ReasoningContentBlock y un ContentBlock de texto adjunto.

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

ReasoningContentBlock contiene el razonamiento utilizado para generar el contenido adjunto en el campo reasoningText, además de cualquier contenido del razonamiento que haya sido cifrado por el proveedor del modelo por motivos de confianza y seguridad en el campo redactedContent.

Dentro del campo reasoningText, los campos text describen el razonamiento. El campo signature es un hash de todos los mensajes de la conversación y una medida de seguridad contra la manipulación del razonamiento utilizado por el modelo. Debe incluir la firma y todos los mensajes anteriores en las solicitudes Converse posteriores. Si se cambia alguno de los mensajes, la respuesta produce un error.

Contiene información sobre la herramienta que debe utilizar el modelo. Para obtener más información, consulte Uso de una herramienta para completar una respuesta modelo de Amazon Bedrock.

Contiene información sobre el resultado del modelo mediante el uso de una herramienta. Para obtener más información, consulte Uso de una herramienta para completar una respuesta modelo de Amazon Bedrock.