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á.
Pensamento adaptativo
O pensamento adaptativo é a forma recomendada de usar o Raciocínio estendido Claude Opus 4.6. Em vez de definir manualmente um orçamento simbólico inteligente, o pensamento adaptativo permite decidir Claude dinamicamente quando e quanto pensar com base na complexidade de cada solicitação. O pensamento adaptativo gera um desempenho melhor de forma confiável do que o pensamento estendido com um pensamento fixobudget_tokens, e recomendamos mudar para o pensamento adaptativo para obter as respostas mais inteligentes a partir da versão 4.6. Claude Opus Nenhum cabeçalho beta é necessário.
Os modelos compatíveis são os seguintes:
| Modelo | ID do modelo |
|---|---|
Cláudia Opus 5 |
|
Claude Mythos 5 |
|
Claude Fable 5 |
|
Claude Opus4.7 |
|
Prévia de Claude Mythos |
|
Claude Opus4.6 |
|
Claude Sonnet 4.6 |
|
nota
Claude Mythos 5, Claude Fable 5, Claude Opus 4.7 e Claude Mythos Preview suportam apenas o pensamento adaptativo. O pensamento manual estendido (thinking.type: "enabled"combudget_tokens) e o pensamento deficiente (thinking.type: "disabled") não são suportados nesses modelos e retornarão um erro 400. Use thinking.type: "adaptive" com output_config.effort para controlar o comportamento mental.
thinking.type: "enabled"e budget_tokens estão obsoletos na versão Claude Opus 4.6 e no Claude Sonnet 4.6 e serão removidos em uma versão futura do modelo. Em vez disso, use thinking.type: "adaptive" com o parâmetro de esforço.
Modelos mais antigos (Claude Sonnet 4.5, Claude Opus 4.5, etc.) não suportam o pensamento adaptativo e exigemthinking.type: "enabled". budget_tokens
Como funciona o pensamento adaptativo
No modo adaptativo, Claude avalia a complexidade de cada solicitação e decide se e quanto pensar. No nível de esforço padrão (high), quase sempre Claude pensará. Em níveis mais baixos de esforço, Claude pode deixar de pensar em problemas mais simples.
O pensamento adaptativo também ativa Raciocínio intercalado (beta) automaticamente. Isso significa que é Claude capaz de pensar entre as chamadas de ferramentas, o que a torna especialmente eficaz para fluxos de trabalho de agentes.
thinking.typeDefina como "adaptive" em sua solicitação de API:
Pensamento adaptativo com o parâmetro esforço
Você pode combinar o pensamento adaptativo com o parâmetro esforço para orientar o quanto Claude o pensamento funciona. O nível de esforço atua como uma orientação suave para a alocação Claude de pensamento:
| Nível de esforço | Comportamento de pensamento |
|---|---|
max |
Claudesempre pensa sem restrições quanto à profundidade de pensamento. Claude Opus4.6 e Claude Opus 5 somente — solicitações usadas max em outros modelos retornarão um erro. |
xhigh |
Claudesempre pensa com maior profundidade. Claude Opus 5 e Claude Opus 4.6 apenas. |
high (padrão) |
Claudesempre pensa. Fornece um raciocínio profundo sobre tarefas complexas. |
medium |
Claudeusa pensamento moderado. Pode deixar de pensar em perguntas muito simples. |
low |
Claudeminimiza o pensamento. Pula de pensar em tarefas simples em que a velocidade é mais importante. |
Importante
O effort parâmetro deve ser colocado dentro de um output_config objeto separado no corpo da solicitação, não dentro do thinking objeto. Colocar effort dentro thinking resultará em umValidationException.
Importante
Limite de esforço quando o pensamento está desativado (Claude Opus 5): Claude Opus 5 apóia"thinking": {"type": "disabled"}, mas quando o pensamento é deficiente, output_config.effort é limitado. high Solicitações xhigh ou max esforços combinados com o pensamento deficiente retornarão uminvalid_request_error. Esse limite também se aplica ao esforço por turno definido por meio de uma mensagem do sistema no meio da conversa. Para usar xhigh ou se max esforçar, ative o pensamento adaptativo (o padrão) ou omita totalmente o thinking parâmetro.
O exemplo a seguir mostra como definir o nível de esforço ao usar a InvokeModel API:
{ "anthropic_version": "bedrock-2023-05-31", "max_tokens": 16000, "thinking": { "type": "adaptive" }, "output_config": { "effort": "high" }, "messages": [{ "role": "user", "content": "Your prompt here" }] }
Usando o pensamento adaptativo com a API Converse
Ao usar a API Converse, passe os effort parâmetros thinking e para dentro delaadditionalModelRequestFields. O exemplo a seguir mostra o pensamento adaptativo com o nível de esforço padrão:
import boto3, json bedrock_runtime = boto3.client(service_name='bedrock-runtime', region_name='us-east-2') response = bedrock_runtime.converse( modelId="us.anthropic.claude-opus-4-6-v1", messages=[{ "role": "user", "content": [{"text": "Explain why the sum of two even numbers is always even."}] }], additionalModelRequestFields={ "thinking": { "type": "adaptive" } } ) print(json.dumps(response["output"], indent=2, default=str))
Para especificar um nível de esforço, adicione o effort campo dentro de um output_config objeto separado emadditionalModelRequestFields:
response = bedrock_runtime.converse( modelId="us.anthropic.claude-opus-4-6-v1", messages=[{ "role": "user", "content": [{"text": "What is 2 + 2?"}] }], additionalModelRequestFields={ "thinking": { "type": "adaptive" }, "output_config": { "effort": "low" } } )
Armazenamento em cache de prompts
Solicitações consecutivas usando o adaptive pensamento preservam os pontos de interrupção imediatos do cache. No entanto, alternar entre os modos de disabled pensamento adaptive eenabled/quebra os pontos de interrupção do cache para mensagens. Os prompts do sistema e as definições de ferramentas permanecem em cache, independentemente das alterações de modo.
Ajustando o comportamento de pensamento
Se Claude estiver pensando com mais ou menos frequência do que gostaria, você pode adicionar orientação ao prompt do sistema:
Extended thinking adds latency and should only be used when it will meaningfully improve answer quality — typically for problems that require multi-step reasoning. When in doubt, respond directly.
Atenção
ClaudePensar com menos frequência pode reduzir a qualidade das tarefas que se beneficiam do raciocínio. Avalie o impacto em suas cargas de trabalho específicas antes de implantar o ajuste de produção baseado em solicitações. Considere testar primeiro com níveis de esforço mais baixos.
Resumo do texto do conector (beta)
No Claude Fable 5, o texto que o modelo emite entre as chamadas da ferramenta (às vezes chamado de “texto do conector” — por exemplo, “Deixe-me verificar o arquivo a seguir...”) é resumido no lado do servidor e retornado como um bloco de pensamento em vez de um bloco de conteúdo de texto simples. O bloco de pensamento usa a mesma forma de qualquer outro bloco de pensamento (texto vazio com uma assinatura na omitted tela padrão).
Impacto no cliente:
Forma de resposta: Tool-use as respostas de Claude Fable 5 podem conter blocos de pensamento adicionais em que os modelos anteriores emitiam texto simples entre os blocos.
tool_useNão há nenhum novo tipo de bloco de conteúdo. As respostas finais do assistente (após a conclusão de todo o uso da ferramenta) não são afetadas e permanecem em texto simples.Multi-turn tratamento: devolva esses blocos de pensamento inalterados em conversas de vários turnos — o mesmo tratamento do pensamento protegido (assinatura validada no passback; retirada silenciosamente se enviada para um modelo diferente).
Escopo: O resumo do conector se aplica somente após a
tool_resultexistência de um na conversa. A narração antes da primeira chamada de ferramenta em uma nova conversa permanece em texto simples. Segmentos curtos de texto podem passar como texto simples sem resumos.
Esse recurso é ativado no lado do servidor para Claude Fable 5. Não há aceitação ou exclusão do cliente.