Uso da API Converse

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

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

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

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.

Veja a seguir um exemplo de objeto Message com uma content matriz contendo somente uma imagem ContentBlock:

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

Você também pode especificar um URI do Amazon S3 em vez de passar os bytes diretamente no corpo da solicitação. O exemplo a seguir mostra um Message objeto de amostra com uma matriz de conteúdo contendo a fonte passada por um URI do Amazon S3.

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

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:

Ao usar um documento, você pode ativar a citations tag, que fornecerá citações específicas do documento na resposta da chamada da API. Consulte a DocumentBlockAPI para obter mais detalhes.

Veja a seguir um exemplo de 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",
                "name": "MyDocument",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        }
    ]
}

Você também pode especificar um URI do Amazon S3 em vez de passar os bytes diretamente no corpo da solicitação. O exemplo a seguir mostra um Message objeto de amostra com uma matriz de conteúdo contendo a fonte passada por um URI do Amazon S3.

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

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.

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

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

Você também pode especificar um URI do Amazon S3 em vez de passar os bytes diretamente no corpo da solicitação. O exemplo a seguir mostra um Message objeto de amostra com uma matriz de conteúdo contendo a fonte passada por um URI do Amazon S3.

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

Você pode adicionar pontos de verificação de cache como um bloco em uma mensagem junto com uma solicitação anexa usando cachePoint campos para utilizar o cache de solicitações. 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.

Veja a seguir um exemplo de 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",
                "name": "string",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

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. Detecte e filtre conteúdo nocivo usando o Amazon Bedrock Guardrails

O reasoningContent campo mapeia 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 seguinte 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.