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á. # Anthropic Claude API Messages do da Esta seção fornece os parâmetros de inferência e exemplos de código para uso da API Messages do Claude da Anthropic. **Topics** + [Anthropic Claude Visão geral da API Messages do da](#model-parameters-anthropic-claude-messages-overview) + [Uso de ferramentas](model-parameters-anthropic-claude-messages-tool-use.md) + [Raciocínio estendido](claude-messages-extended-thinking.md) + [Pensamento adaptativo](claude-messages-adaptive-thinking.md) + [Criptografia de raciocínio](claude-messages-thinking-encryption.md) + [Diferenças de raciocínio entre as versões de modelo](claude-messages-thinking-differences.md) + [Compactação](claude-messages-compaction.md) + [Obtenha resultados JSON validados de modelos](claude-messages-structured-outputs.md) + [Solicitação e reposta](model-parameters-anthropic-claude-messages-request-response.md) + [Exemplos de código](api-inference-examples-claude-messages-code-examples.md) + [Modelos compatíveis](claude-messages-supported-models.md) ## Anthropic Claude Visão geral da API Messages do da Você pode usar a API Messages para criar chatbots ou aplicações de assistente virtual. A API gerencia as trocas de conversas entre um usuário e um modelo do Claude da Anthropic (assistente). **nota** Este tópico mostra como usar a API de Anthropic Claude mensagens com as operações básicas de inferência ([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)). No entanto, é recomendável usar a API Converse para implementar mensagens em sua aplicação. A API Converse oferece um conjunto unificado de parâmetros que funcionam em todos os modelos que permitem mensagens. Para obter mais informações, consulte [Inferência usando a API Converse](conversation-inference.md). 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. A Anthropic treina modelos Claude para operar em turnos alternados de conversação do usuário e do assistente. Ao criar uma mensagem, você especifica os turnos de conversação anteriores com o parâmetro messages. O modelo acaba gerando a próxima mensagem na conversa. Cada mensagem de entrada deve ser um objeto com uma função e um conteúdo. Você pode especificar uma única mensagem de função do usuário ou pode incluir várias mensagens de usuário e assistente. Se você estiver usando a técnica de pré-preencher a resposta do Claude (preenchendo o início da resposta do Claude usando uma mensagem da função de assistente final), o Claude responderá retomando de onde você parou. Com essa técnica, o Claude ainda retornará uma resposta com a função de assistente. Se a mensagem final usar a função de assistente, o conteúdo da resposta continuará imediatamente a partir do conteúdo dessa mensagem. Você pode usar isso para restringir parte da resposta do modelo. Exemplo com uma única mensagem do usuário: ``` [{"role": "user", "content": "Hello, Claude"}] ``` Exemplo com vários turnos de conversação: ``` [ {"role": "user", "content": "Hello there."}, {"role": "assistant", "content": "Hi, I'm Claude. How can I help you?"}, {"role": "user", "content": "Can you explain LLMs in plain English?"}, ] ``` Exemplo com uma resposta parcialmente preenchida pelo Claude: ``` [ {"role": "user", "content": "Please describe yourself using only JSON"}, {"role": "assistant", "content": "Here is my JSON description:\n{"}, ] ``` O conteúdo de cada mensagem de entrada pode ser uma string única ou uma matriz dos blocos de conteúdo, em que cada bloco tem um tipo específico. O uso de uma string é um atalho para uma matriz de um bloco de conteúdo do tipo “texto”. As seguintes mensagens de entrada são equivalentes: ``` {"role": "user", "content": "Hello, Claude"} ``` ``` {"role": "user", "content": [{"type": "text", "text": "Hello, Claude"}]} ``` Para obter informações sobre como criar prompts para modelos Claude da Anthropic, consulte, [Intro to prompting](https://docs.anthropic.com/claude/docs/intro-to-prompting) na documentação do Claude da Anthropic. Se você tiver prompts de [preenchimento de texto](model-parameters-anthropic-claude-text-completion.md) existentes que deseja migrar para a API de mensagens, consulte [Migrating from Text Completions](https://docs.anthropic.com/claude/reference/migrating-from-text-completions-to-messages). **Importante** O período limite para chamadas de inferência aos modelos Claude 3.7 Sonnet e Claude 4 da Anthropic é 60 minutos. Por padrão, os clientes AWS SDK atingem o tempo limite após 1 minuto. Recomendamos que você aumente o período de tempo limite de leitura do seu cliente AWS SDK para pelo menos 60 minutos. Por exemplo, no botocore do AWS SDK para Python, altere o valor do campo `read_timeout` em [botocore.config](https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#) para pelo menos 3.600. ### Prompts do sistema Você também pode incluir um prompt do sistema na solicitação. Um prompt do sistema permite a você contextualizar e dar instruções para o Claude da Anthropic, como especificar uma meta ou função específica. Especifique um prompt do sistema no campo `system`, conforme exibido no exemplo a seguir. ``` "system": "You are Claude, an AI assistant created by Anthropic to be helpful, harmless, and honest. Your goal is to provide informative and substantive responses to queries while avoiding potential harms." ``` Para obter mais informações, consulte [System prompts](https://docs.anthropic.com/en/docs/system-prompts) na documentação da Anthropic. ### Prompts multimodais Um prompt multimodal combina várias modalidades (imagens e textos) em um único prompt. Você especifica as modalidades no campo de entrada `content`. O exemplo a seguir mostra como você pode pedir para o Claude da Anthropic descrever o conteúdo de uma imagem fornecida. Para obter um código de exemplo, consulte [Exemplos de código multimodal](api-inference-examples-claude-messages-code-examples.md#api-inference-examples-claude-multimodal-code-example). ``` { "anthropic_version": "bedrock-2023-05-31", "max_tokens": 1024, "messages": [ { "role": "user", "content": [ { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "iVBORw..." } }, { "type": "text", "text": "What's in these images?" } ] } ] } ``` Cada imagem incluída por você em uma solicitação conta para o uso do token. Para obter mais informações, consulte [Image costs](https://docs.anthropic.com/claude/docs/vision#image-costs) na documentação da Anthropic.