Usar o Converse API

O campo text é associado a uma string que especifica o prompt. O text campo é interpretado junto com outros campos especificados no mesmo ContentBlock.

(Opcional) Para determinados modelos, você pode adicionar pontos de verificação de cache usando cachePoint campos para utilizar o cache imediato. O cache imediato é um recurso que permite que você comece a armazenar em cache o contexto das conversas para obter economia de custos e latência. Para obter mais informações, consulte Cache imediato para inferência mais rápida do modelo.

O seguinte mostra um objeto Message com uma content matriz contendo somente um texto ContentBlock:

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

O exemplo a seguir mostra um objeto Message com uma content matriz contendo um texto ContentBlocke um cachePoint campo opcional. Como resultado, o conteúdo do texto ContentBlocké adicionado ao cache.

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

O image campo é mapeado para um ImageBlock. Passe os bytes brutos, codificados em base64, para uma imagem no campo bytes. Se você usa um AWS SDK, não precisa codificar os bytes em base64.

Se você excluir o text campo, o modelo descreverá a imagem.

(Opcional) Para determinados modelos, você pode adicionar pontos de verificação de cache usando cachePoint campos para utilizar o cache imediato. O cache imediato é um recurso que permite que você comece a armazenar em cache o contexto das conversas para obter economia de custos e latência. Para obter mais informações, consulte Cache imediato para inferência mais rápida do modelo.

O seguinte mostra um objeto Message com uma content matriz contendo somente uma imagem ContentBlock:

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

O exemplo a seguir mostra um objeto Message com uma content matriz contendo uma imagem ContentBlocke um cachePoint campo opcional. Como resultado, o conteúdo da imagem é adicionado ao cache.

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

O document campo é mapeado para um DocumentBlock. Se você incluir um DocumentBlock, verifique se a solicitação está em conformidade com as seguintes restrições:

(Opcional) Para determinados modelos, você pode adicionar pontos de verificação de cache usando cachePoint campos para utilizar o cache imediato. O cache imediato é um recurso que permite que você comece a armazenar em cache o contexto das conversas para obter economia de custos e latência. Para obter mais informações, consulte Cache imediato para inferência mais rápida do modelo.

O seguinte mostra um objeto Message com uma content matriz contendo somente um documento ContentBlocke um texto ContentBlockde acompanhamento obrigatório.

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

A seguir, é mostrado um objeto Message com uma content matriz contendo um documento ContentBlocke um texto de acompanhamento obrigatório ContentBlock, bem como um CachePoint que adiciona o conteúdo do documento e do texto ao cache.

{
    "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"
            }
        }
    ]
}

O video campo é mapeado para um VideoBlockobjeto. Passe os bytes brutos no bytes campo, codificados em base64. Se você usa o AWS SDK, não precisa codificar os bytes em base64.

Se você não incluir o text campo, o modelo descreverá o vídeo.

O exemplo a seguir mostra um objeto Message com uma content matriz contendo somente um vídeo ContentBlock.

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

Observe que, para arquivos com uma .3gp extensão, o formato precisa ser especificado comothree_gp.

Você também pode passar um vídeo por meio de um URI do Amazon S3 em vez de passar os bytes diretamente no corpo da solicitação. O seguinte mostra um Message objeto com uma matriz de conteúdo contendo somente um vídeo ContentBlock com a fonte de vídeo passada por um URI do Amazon S3.

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

O s3Location parâmetro só é suportado na região Leste dos EUA (Norte da Virgínia).

O guardContent campo é mapeado para um GuardrailConverseContentBlockobjeto. Você pode usar esse campo para direcionar uma entrada a ser avaliada pela grade de proteção definida no guardrailConfig campo. Se você não especificar esse campo, a grade de proteção avaliará todas as mensagens no corpo da solicitação. Você pode transmitir os seguintes tipos de conteúdo em umGuardBlock:

Para obter mais informações sobre o uso de grades de proteção, consulte. Impedir conteúdo prejudicial em modelos usando o Amazon Bedrock Guardrails

O reasoningContent campo é mapeado para um ReasoningContentBlock. Este bloco contém conteúdo sobre o raciocínio que foi realizado pelo modelo para gerar a resposta no anexoContentBlock.

O exemplo a seguir mostra um Message objeto com uma content matriz contendo somente a ReasoningContentBlock e um texto ContentBlock que o acompanha.

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

ReasoningContentBlockContém o raciocínio usado para gerar o conteúdo anexo no reasoningText campo, além de qualquer conteúdo no raciocínio que tenha sido criptografado pelo fornecedor do modelo por motivos de confiança e segurança no campo. redactedContent

Dentro do reasoningText campo, os text campos descrevem o raciocínio. O signature campo é um hash de todas as mensagens da conversa e é uma proteção contra a adulteração do raciocínio usado pelo modelo. Você deve incluir a assinatura e todas as mensagens anteriores nas Converse solicitações subsequentes. Se alguma das mensagens for alterada, a resposta gerará um erro.

Contém informações sobre uma ferramenta para o modelo usar. Para obter mais informações, consulte Use uma ferramenta para concluir uma resposta do modelo do Amazon Bedrock.

Contém informações sobre o resultado do modelo usando uma ferramenta. Para obter mais informações, consulte Use uma ferramenta para concluir uma resposta do modelo do Amazon Bedrock.