As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Solicitação e reposta O corpo da solicitação é passado no `body` campo de uma solicitação para [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)ou [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html). **nota** As restrições se aplicam às seguintes operações: `InvokeModel` `InvokeModelWithResponseStream``Converse`,, `ConverseStream` e. Consulte as [restrições da API](inference-api-restrictions.md) para obter detalhes. **Atenção** Claude Sonnet 4.5e Claude Haiku 4.5 suporte para especificar o `top_p` parâmetro `temperature` ou, mas não ambos. Isso não se aplica aos modelos mais antigos. ------ #### [ Request ] O Claude da Anthropic tem os parâmetros de inferência a seguir para uma chamada de inferência de mensagens. ``` { "anthropic_version": "bedrock-2023-05-31", "anthropic_beta": ["computer-use-2024-10-22"] "max_tokens": int, "system": string, "messages": [ { "role": string, "content": [ { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "content image bytes" } }, { "type": "text", "text": "content text" } ] } ], "temperature": float, "top_p": float, "top_k": int, "tools": [ { "type": "custom", "name": string, "description": string, "input_schema": json }, { "type": "computer_20241022", "name": "computer", "display_height_px": int, "display_width_px": int, "display_number": 0 int }, { "type": "bash_20241022", "name": "bash" }, { "type": "text_editor_20241022", "name": "str_replace_editor" } ], "tool_choice": { "type" : string, "name" : string, }, "stop_sequences": [string] } ``` Veja a seguir os parâmetros necessários. + **anthropic\$1version**: (obrigatório) a versão da Anthropic. O valor deve ser `bedrock-2023-05-31`. + **max\$1tokens**: (obrigatório) o número máximo de tokens a serem gerados antes de parar. Observe que os modelos Claude da Anthropic podem parar de gerar tokens antes de atingir o valor de `max_tokens`. Modelos diferentes do Claude da Anthropic têm valores máximos diferentes para esse parâmetro. Para obter mais informações, consulte [Model comparison](https://docs.anthropic.com/claude/docs/models-overview#model-comparison). + **messages**: (obrigatório) as mensagens de entrada. + **role**: o perfil do turno da conversa. Os valores válidos são `user` e `assistant`. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) + **content**: (obrigatório) o conteúdo do turno da conversa, como uma matriz de objetos. Cada objeto contém um campo de **tipo**, no qual você pode especificar um dos seguintes valores: + `text`: se você especificar esse tipo, deverá incluir um campo de **texto** e especificar o prompt de texto como o respectivo valor. Se outro objeto na matriz for uma imagem, esse prompt de texto se aplicará às imagens. + `image`: se você especificar esse tipo, deverá incluir um campo de **origem** associado a um objeto com os seguintes campos: + **type**: (obrigatório) o tipo de codificação da imagem. Você pode especificar `base64`. + **media\$1type**: (obrigatório) o tipo da imagem. Você pode especificar os seguintes formatos de imagem: + `image/jpeg` + `image/png` + `image/webp` + `image/gif` + **data**: (obrigatório) os bytes de imagem codificados em base64 para a imagem. O tamanho máximo da imagem é 3,75 MB. O valor da altura e da largura máximas de uma imagem é 8.000 pixels. Veja a seguir os parâmetros opcionais. + **system**: (opcional) o prompt do sistema para a solicitação. Um prompt do sistema é uma maneira de contextualizar e dar instruções para o Claude da Anthropic, como especificar uma meta ou função específica. Para obter mais informações, consulte [System prompts](https://docs.anthropic.com/en/docs/system-prompts) na documentação da Anthropic. **nota** Você pode usar os prompts do sistema com o Claude versão 2.1 ou posterior da Anthropic. + **anthropic\$1beta**: (opcional) o parâmetro anthropic\$1beta é uma lista de strings de cabeçalhos beta usados para indicar a aceitação de um conjunto específico de recursos beta. **nota** A variante de tamanho de contexto de 1 milhão de tokens de Claude Sonnet 4 está disponível para você em AWS regiões selecionadas como um “Serviço Beta”, conforme definido nos Termos AWS de Serviço. Está sujeito ao seu Contrato AWS e aos Termos AWS de Serviço e ao modelo de EULA aplicável. Consulte a página [Preços do Amazon Bedrock](https://aws.amazon.com/bedrock/pricing/) para ter mais informações sobre os preços para solicitações de contexto mais longas. Aplicam-se cotas de serviço separadas (para obter mais informações, consulte Cotas **de serviço** no Console de gerenciamento da AWS). Os cabeçalhos beta disponíveis incluem os seguintes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) + **stop\$1sequences**: (opcional) sequências de texto personalizadas que fazem com que o modelo deixe de gerar. Os modelos Claude da Anthropic normalmente param quando completam a vez naturalmente; nesse caso, o valor do campo de resposta `stop_reason` é `end_turn`. Se quiser que o modelo deixe de ser gerado ao encontrar strings de texto personalizadas, você poderá usar o parâmetro `stop_sequences`. Se o modelo encontrar uma das strings de texto personalizadas, o valor do campo de resposta `stop_reason` será `stop_sequence` e o valor de `stop_sequence` conterá a sequência de parada correspondente. O número máximo de entradas é 8.191. + **temperature**: (opcional) a randomização injetada na resposta. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) + **top\$1p**: (opcional) use amostragem de núcleo. Na amostragem de núcleo, o Claude da Anthropic calcula a distribuição cumulativa de todas as opções de cada token subsequente em ordem de probabilidade decrescente e a interrompe quando atinge uma determinada probabilidade especificada por `top_p`. Ao ajustar os parâmetros de amostragem, modifique `temperature` ou `top_p`. Não modifique ambos ao mesmo tempo. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) + **top\$1k**: (opcional) somente um exemplo das opções K principais para cada token subsequente. Use `top_k` para remover respostas de baixa probabilidade de cauda longa. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) + **tools**: (opcional) definições de ferramentas que o modelo pode usar. **nota** Exige um modelo Claude 3 da Anthropic. Se você incluir `tools` na solicitação, o modelo poderá retornar blocos de conteúdo `tool_use` que representam o uso dessas ferramentas do modelo. É possível executar essas ferramentas usando a entrada de ferramenta gerada pelo modelo e, opcionalmente, retornar os resultados ao modelo usando blocos de conteúdo de `tool_result`. Você pode passar os seguintes tipos de ferramenta: **Personalizada** Definição de uma ferramenta personalizada. + (opcional) **type**: o tipo da ferramenta. Se definido, use o valor `custom`. + **name**: o nome da ferramenta. + **description**: (opcional, mas altamente recomendado) a descrição da ferramenta. + **input\$1schema**: o esquema JSON da ferramenta. **Computação** Definição da ferramenta de computação usada por você com a API Computer Use. + **type**: o valor deve ser `computer_20241022`. + **name**: o valor deve ser `computer`. + (Obrigatório) **display\$1height\$1px**: a altura da tela que está sendo controlada pelo modelo, em pixels. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) + (Obrigatório) **display\$1width\$1px**: a largura da tela que está sendo controlada pelo modelo, em pixels. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) + (Opcional) **display\$1number**: o número de exibição a ser controlado (só relevante para ambientes X11). Se especificada, a ferramenta receberá um número de exibição na definição da ferramenta. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-request-response.html) **bash** Definição da ferramenta de bash usada por você com a API Computer Use. + (opcional) **type**: o valor deve ser `bash_20241022`. + **name**: o valor deve ser `bash`. **text editor** Definição da ferramenta de edição de texto usada por você com a API Computer Use. + (opcional) **type**: o valor deve ser `text_editor_20241022`. + **name**: o valor deve ser `str_replace_editor`. + **tool\$1choice**: (opcional) especifica como o modelo deve usar as ferramentas fornecidas. O modelo pode usar uma ferramenta específica, qualquer ferramenta disponível ou decidir por conta própria. **nota** Exige um modelo Claude 3 da Anthropic. + **type**: o tipo de opção de ferramenta. Os valores possíveis são `any` (use qualquer ferramenta disponível), `auto` (o modelo decide) e `tool` (use a ferramenta especificada). + **name**: (opcional) o nome da ferramenta a ser usada. Obrigatório se você especificar `tool` no campo `type`. ------ #### [ Response ] O modelo Claude da Anthropic exibe os campos a seguir para uma chamada de inferência de mensagens. ``` { "id": string, "model": string, "type" : "message", "role" : "assistant", "content": [ { "type": string, "text": string, "image" :json, "id": string, "name":string, "input": json } ], "stop_reason": string, "stop_sequence": string, "usage": { "input_tokens": integer, "output_tokens": integer } } ``` Exemplos de resposta com novos valores stop\$1reason: ``` // Example with refusal { "stop_reason": "refusal", "content": [ { "type": "text", "text": "I can't help with that request." } ] } // Example with tool_use { "stop_reason": "tool_use", "content": [ { "type": "tool_use", "id": "toolu_123", "name": "calculator", "input": {"expression": "2+2"} } ] } // Example with model_context_window_exceeded (Claude Sonnet 4.5) { "stop_reason": "model_context_window_exceeded", "content": [ { "type": "text", "text": "The response was truncated due to context window limits..." } ] } ``` + **id**: o identificador exclusivo da resposta. O formato e o tamanho do ID podem mudar com o passar do tempo. + **model**: o ID do modelo Claude da Anthropic que fez a solicitação. + **stop\$1reason**: o motivo pelo qual o Claude da Anthropic deixou de gerar a resposta. + **end\$1turn**: o modelo atingiu um ponto de parada natural + **max\$1tokens**: o texto gerado excedeu o valor do campo de entrada `max_tokens` ou eo número máximo de tokens que o modelo permite. + **stop\$1sequence**: o modelo gerou uma das sequências de parada especificadas por você no campo de entrada `stop_sequences`. + **refusal**: o Claude se recusa a gerar uma resposta devido a questões de segurança. + **tool\$1use**: o claude está chamando uma ferramenta e espera que você a execute. + **model\$1context\$1window\$1exceeded**: o modelo interrompeu a geração devido ao limite da janela de contexto. + Novo no Claude Sonnet 4.5 + **stop\$1sequence**: a sequência de parada que encerrou a geração. + **type**: o tipo de resposta. O valor é sempre `message`. + **role**: a função conversacional da mensagem gerada. O valor é sempre `assistant`. + **content**: o conteúdo gerado pelo modelo. Retornado como uma matriz. Há três tipos de conteúdo: *text*, *tool\$1use* e *image*. + *text*: uma resposta em texto. + **type**: o tipo do conteúdo. Este valor é `text`. + **text**: se o valor de `type` for text, conterá o texto do conteúdo. + *tool\$1use*: uma solicitação do modelo para usar uma ferramenta. + **type**: o tipo do conteúdo. Este valor é `tool_use`. + **id**: o ID da ferramenta cujo uso o modelo está solicitando. + **name**: contém o nome da ferramenta solicitada. + **input**: os parâmetros de entrada a serem passados para a ferramenta. + *image*: uma solicitação do modelo para usar uma ferramenta. + **type**: o tipo do conteúdo. Este valor é `image`. + **source**: contém a imagem. Para obter mais informações, consulte [Prompts multimodais](model-parameters-anthropic-claude-messages.md#model-parameters-anthropic-claude-messages-multimodal-prompts). + **usage**: contêiner para o número de tokens fornecidos por você na solicitação e o número de tokens que o modelo gerou na resposta. + **input\$1tokens**: o número de tokens de entrada na solicitação. + **output\$1tokens**: o número de tokens gerados pelo modelo na resposta. + **stop\$1sequence**: o modelo gerou uma das sequências de parada especificadas por você no campo de entrada `stop_sequences`. ------ ## Parâmetro de esforço (beta) O `effort` parâmetro é uma alternativa para pensar em orçamentos simbólicos para Claude Opus 4,5. Esse parâmetro indica com Claude que liberalidade ele deve gastar tokens para produzir o melhor resultado, ajustando o uso do token ao pensamento, às chamadas de ferramentas e à comunicação com o usuário. Ele pode ser usado com ou sem o modo de pensamento estendido. O parâmetro de esforço pode ser definido como: + `high`(padrão) — Claude gasta quantos tokens forem necessários para obter o melhor resultado + `medium`— Uso balanceado de tokens + `low`— Uso conservador de tokens Para usar esse recurso, você deve passar o cabeçalho beta`effort-2025-11-24`. Exemplo de solicitação: ``` { "anthropic_version": "bedrock-2023-05-31", "anthropic_beta": [ "effort-2025-11-24" ], "max_tokens": 4096, "output_config": { "effort": "medium" }, "messages": [{ "role": "user", "content": "Analyze this complex dataset and provide insights" }] } ```