Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Pensiero adattivo Il pensiero adattivo consente di decidere Claude dinamicamente quando e quanto pensare in base alla complessità di ogni richiesta, invece di richiedere un budget fisso per i token di pensiero. È supportato su Claude Fable 5.1, Claude Mythos 5.1, Claude Opus 5, Claude Sonnet 5 e altri modelli capaci di pensare. Il pensiero adattivo garantisce prestazioni migliori in modo affidabile rispetto al pensiero esteso con un sistema fisso. `budget_tokens` Non è richiesta alcuna intestazione beta. I modelli supportati sono i seguenti: | Modello | ID modello | | --- | --- | | Claude Fable 5.1 | `anthropic.claude-fable-5-1` | | Claude Mythos 5.1 | `anthropic.claude-mythos-5-1` | | Claude Opus 5 | `anthropic.claude-opus-5` | | Sonetto Claude 5 | `anthropic.claude-sonnet-5` | | Claude Mythos 5 | `anthropic.claude-mythos-5` | | Claude Favola 5 | `anthropic.claude-fable-5` | | Claude Opus4.7 | `anthropic.claude-opus-4-7` | | Anteprima di Claude Mythos | `anthropic.claude-mythos-preview` | | Claude Opus4.6 | `anthropic.claude-opus-4-6-v1` | | Claude Sonnet 4.6 | `anthropic.claude-sonnet-4-6` | **Nota** Claude Fable 5.1, Claude Mythos 5.1, Claude Mythos 5, Claude Fable 5 e Claude Mythos Preview supportano solo il pensiero adattivo. * * Il pensiero manuale esteso (`thinking.type: "enabled"`con`budget_tokens`) e il pensiero disabile () non sono supportati su questi modelli e `thinking.type: "disabled"` restituiranno un errore 400. Usalo `thinking.type: "adaptive"` con `output_config.effort` per controllare il comportamento mentale. Claude Opus4.7 supporta il pensiero adattivo e disabile. Per disattivare il pensiero, usa. `thinking.type: "disabled"` Il pensiero manuale esteso (`thinking.type: "enabled"`con`budget_tokens`) non è supportato e restituirà un errore 400. `thinking.type: "enabled"`e `budget_tokens` sono obsoleti nella versione Claude Opus 4.6 e Claude Sonnet 4.6 e verranno rimossi in una futura versione del modello. Utilizzatelo invece `thinking.type: "adaptive"` con il parametro effort. I modelli precedenti (Claude Sonnet 4.5, Claude Opus 4.5, ecc.) non supportano il pensiero adattivo e lo richiedono`thinking.type: "enabled"`. `budget_tokens` **Importante** **Il pensiero adattivo è attivo per impostazione predefinita su Claude Sonnet 5 e Claude Opus 5. ** Una richiesta che omette il `thinking` campo viene eseguita con il pensiero adattivo. Questa è una modifica rispetto a Claude Sonnet 4.6, in cui la stessa richiesta veniva eseguita senza pensarci, quindi un'applicazione migrata da Claude Sonnet 4.6 senza modifiche produrrà un output razionale, che verrà fatturato per i token pensanti come token di output, anche se il corpo della richiesta non è cambiato. Per disattivare completamente il pensiero su questi modelli, passate esplicitamente. `"thinking": {"type": "disabled"}` L'omissione del `thinking` campo non disattiva il pensiero: seleziona il pensiero adattivo. Inoltre, un'impostazione del client che esprima il «non pensare» con un budget ridotto o pari a zero non lo disattiva: `thinking.type: "enabled"` with non `budget_tokens` è supportato su Claude Sonnet 5 e restituisce un. `ValidationException` Solo il `disabled` tipo esplicito disattiva il pensiero. Perché `max_tokens` è un limite rigido all'output totale (pensiero più testo di risposta) da rivedere `max_tokens` per carichi di lavoro che in precedenza venivano eseguiti senza pensarci. Se utilizzavi il pensiero disabile su Claude Sonnet 4.6, prendi in considerazione il pensiero adattivo con un `output_config.effort` livello inferiore su Claude Sonnet 5 invece di disabilitarlo. ## Come funziona il pensiero adattivo In modalità adattiva, Claude valuta la complessità di ogni richiesta e decide se e quanto pensare. Al livello di sforzo predefinito (`high`), Claude penserà quasi sempre. A livelli di sforzo inferiori, Claude può evitare di pensare a problemi più semplici. Anche il pensiero adattivo lo abilita automaticamente. [Pensiero interlacciato (beta)](claude-messages-extended-thinking.md#claude-messages-extended-thinking-tool-use-interleaved) Ciò significa che è in Claude grado di pensare tra una chiamata all'altra degli strumenti, il che lo rende particolarmente efficace per i flussi di lavoro agentici. Imposta su `thinking.type` `"adaptive"` nella tua richiesta API: ------ #### [ CLI ] ``` aws bedrock-runtime invoke-model \ --model-id "us.anthropic.claude-opus-4-6-v1" \ --body '{ "anthropic_version": "bedrock-2023-05-31", "max_tokens": 16000, "thinking": { "type": "adaptive" }, "messages": [ { "role": "user", "content": "Three players A, B, C play a game. Each has a jar with 100 balls numbered 1-100. Simultaneously, each draws one ball. A beats B if As number > Bs number (mod 100, treating 100 as 0 for comparison). Similarly for B vs C and C vs A. The overall winner is determined by majority of pairwise wins (ties broken randomly). Is there a mixed strategy Nash equilibrium where each player draws uniformly? If not, characterize the equilibrium." } ] }' \ --cli-binary-format raw-in-base64-out \ output.json && cat output.json | jq '.content[] | {type, thinking: .thinking[0:200], text}' ``` ------ #### [ Python ] ``` import boto3 import json bedrock_runtime = boto3.client( service_name='bedrock-runtime', region_name='us-east-2' ) response = bedrock_runtime.invoke_model( modelId="us.anthropic.claude-opus-4-6-v1", body=json.dumps({ "anthropic_version": "bedrock-2023-05-31", "max_tokens": 16000, "thinking": { "type": "adaptive" }, "messages": [{ "role": "user", "content": "Explain why the sum of two even numbers is always even." }] }) ) response_body = json.loads(response["body"].read()) for block in response_body["content"]: if block["type"] == "thinking": print(f"\nThinking: {block['thinking']}") elif block["type"] == "text": print(f"\nResponse: {block['text']}") ``` ------ #### [ TypeScript ] ``` import { BedrockRuntimeClient, InvokeModelCommand } from "@aws-sdk/client-bedrock-runtime"; async function main() { const client = new BedrockRuntimeClient({}); const command = new InvokeModelCommand({ modelId: "us.anthropic.claude-opus-4-6-v1", body: JSON.stringify({ anthropic_version: "bedrock-2023-05-31", max_tokens: 16000, thinking: { type: "adaptive" }, messages: [{ role: "user", content: "Explain why the sum of two even numbers is always even." }] }) }); const response = await client.send(command); const responseBody = JSON.parse(new TextDecoder().decode(response.body)); for (const block of responseBody.content) { if (block.type === "thinking") { console.log(`\nThinking: ${block.thinking}`); } else if (block.type === "text") { console.log(`\nResponse: ${block.text}`); } } } main().catch(console.error); ``` ------ ## Pensiero adattivo con il parametro effort Puoi combinare il pensiero adattivo con il parametro dello sforzo per determinare l'effetto del pensieroClaude. Il livello di impegno funge da guida morbida per l'allocazione Claude del pensiero: | Livello di impegno | Comportamento mentale | | --- | --- | | max | Claudepensa sempre senza vincoli di profondità di pensiero. Claude Opus Supporto per 4.6, Claude Sonnet 4.6 e Claude Opus 5. max Le richieste che utilizzano modelli non supportati restituiscono max un errore. | | xhigh | Claudepensa sempre con una profondità estesa. Solo Claude Opus 5 e Claude Opus 4.6. | | high (predefinito) | Claudepensa sempre. Fornisce un ragionamento approfondito su compiti complessi. | | medium | Claudeusa un pensiero moderato. Può saltare il pensiero per domande molto semplici. | | low | Claudeminimizza il pensiero. Evita di pensare a compiti semplici in cui la velocità è più importante. | **Importante** Il `effort` parametro deve essere inserito all'interno di un `output_config` oggetto separato nel corpo della richiesta, non all'interno dell'`thinking`oggetto. Il posizionamento `effort` all'interno `thinking` comporterà un`ValidationException`. **Importante** **Limite di sforzo quando il pensiero è disabilitato (Claude Opus 5): ** Claude Opus 5 sostiene`"thinking": {"type": "disabled"}`, ma quando il pensiero è disabilitato, `output_config.effort` è limitato a. `high` Le richieste `xhigh` o `max` lo sforzo combinato con il pensiero disabile restituiranno un. `invalid_request_error` Questo limite si applica anche allo sforzo per turno impostato tramite un messaggio di sistema a metà conversazione. Per utilizzare il `xhigh` nostro `max` sforzo, abilita il pensiero adattivo (impostazione predefinita) o ometti completamente il parametro. `thinking` L'esempio seguente mostra come impostare il livello di impegno quando si utilizza l' 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" }] } ``` ## Usare il pensiero adattivo con l'API Converse Quando usi l'API [ Converse](conversation-inference.md), passa i parametri `thinking` and `effort` all'interno. `additionalModelRequestFields` L'esempio seguente mostra il pensiero adattivo con il livello di impegno predefinito: ``` 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)) ``` Per specificare un livello di impegno, aggiungi il `effort` campo all'interno di un `output_config` oggetto separato in`additionalModelRequestFields`: ``` 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" } } ) ``` ## Impostazione dello sforzo per turno (beta) Questa funzionalità è un servizio beta come definito nei Termini del servizio AWS. In Claude Fable 5.1 e Claude Mythos 5.1, puoi modificare il livello di impegno durante una conversazione invece di impostarlo una volta per l'intera richiesta. Inserisce un messaggio di sistema contenente un `output_config.effort` valore in qualsiasi punto dell'array. `messages` Il nuovo livello di sforzo si applica ai turni successivi. La richiesta restituisce 200 senza modifiche alla forma della risposta. Per utilizzare lo sforzo per turno, includi uno dei seguenti `anthropic_beta` valori:`mid-conversation-output-config-2026-07-01`, `mid-conversation-effort-2026-08-01``per-turn-control-2026-07-01`, o. `per-message-effort-2026-07-01` ``` { "anthropic_version": "bedrock-2023-05-31", "anthropic_beta": ["mid-conversation-effort-2026-08-01"], "max_tokens": 16000, "output_config": {"effort": "high"}, "messages": [ {"role": "user", "content": "First question"}, {"role": "assistant", "content": "First answer"}, {"role": "system", "content": [], "output_config": {"effort": "low"}}, {"role": "user", "content": "A simpler follow-up question"} ] } ``` **Nota** Senza uno dei valori beta elencati, o su un modello che non supporta il lavoro per turno, viene restituita una richiesta che include `output_config` in un messaggio di sistema. `400 messages.N.output_config: Extra inputs are not permitted` La frequenza per turno non `task_budget` è supportata e restituisce inoltre 400. ## Caching dei prompt Le richieste consecutive che utilizzano `adaptive` thinking preservano i breakpoint della cache dei prompt. Tuttavia, il passaggio tra le modalità `adaptive` e`enabled`/`disabled`thinking interrompe i punti di interruzione della cache per i messaggi. I prompt di sistema e le definizioni degli strumenti rimangono memorizzati nella cache indipendentemente dalle modifiche alla modalità. ## Ottimizzazione del comportamento mentale Se Claude sta pensando più o meno spesso di quanto vorresti, puoi aggiungere una guida al prompt del tuo 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. ``` **avvertimento** ClaudeIncitarsi a pensare meno spesso può ridurre la qualità delle attività che traggono beneficio dal ragionamento. Misura l'impatto sui carichi di lavoro specifici prima di implementare un'ottimizzazione della produzione basata sui tempi rapidi. Valuta innanzitutto la possibilità di eseguire test con livelli di impegno inferiori. ## Riepilogo del testo del connettore (beta) In Claude Fable 5, il testo che il modello emette tra una chiamata allo strumento e l'altra (a volte chiamato «testo del connettore», ad esempio «Fammi controllare il file successivo...») viene riepilogato sul lato server e restituito come blocco di pensiero anziché come blocco di contenuto di testo semplice. Il blocco di pensiero utilizza la stessa forma di qualsiasi altro blocco di pensiero (testo vuoto con una firma nella visualizzazione predefinita). `omitted` **Impatto sul cliente: ** + **Forma della risposta: ** Tool-use le risposte di Claude Fable 5 possono contenere blocchi di pensiero aggiuntivi in cui i modelli precedenti emettevano testo semplice tra i blocchi. `tool_use` Non esiste un nuovo tipo di blocco di contenuto. Le risposte finali dell'assistente (dopo che tutto l'uso dello strumento è stato completato) non vengono modificate e rimangono in testo normale. + **Multi-turn gestione: ** restituisci questi blocchi di pensiero inalterati nelle conversazioni a più turni, la stessa gestione del pensiero protetto (firma convalidata su passback; cancellata automaticamente se inviata a un modello diverso). + **Ambito: il riepilogo ** del connettore si applica solo dopo che a è presente nella conversazione. `tool_result` La narrazione prima della prima chiamata allo strumento in una nuova conversazione rimane testo normale. Brevi segmenti di testo possono essere visualizzati come testo normale senza riepilogo. Questa funzionalità è abilitata lato server per Claude Fable 5. Non è previsto alcun opt-in o opt-out da parte del cliente.