Novità di Claude Haiku 5.5
Panoramica delle nuove funzionalità, delle modifiche incompatibili e delle modifiche di comportamento in Claude Haiku 5.5, con un link alla guida di ciascuna funzionalità e alla guida alla migrazione per le modifiche al codice.
Claude Haiku 5.5 è progettato per carichi di lavoro ad alto volume e sensibili alla "latency" (latenza), come classificazione, instradamento, estrazione e attività di subagenti. Supporta l'"adaptive thinking" (ragionamento adattivo) con il parametro effort, una "context window" (finestra di contesto) da 1M token e fino a 128k token di output. Utilizza lo stesso tokenizer più recente di Claude 4.7 e dei modelli successivi, quindi lo stesso testo corrisponde a circa il 30% di token in più rispetto a Claude Haiku 4.5. I suoi blocchi di ragionamento funzionano solo nell'account che li ha prodotti o in un account collegato a esso.
Per le modifiche al codice, consulta la guida alla migrazione. Per ID dei modelli, prezzi e limiti, consulta la panoramica di Claude Haiku 5.5. Per indicazioni sulla scrittura dei prompt, consulta Prompting per Claude Haiku 5.5.
Riepilogo delle modifiche rispetto a Claude Haiku 4.5
Ogni riga indica una modifica, se è nuova, modificata o incompatibile, e cosa deve fare il tuo codice.
| Modifica | Tipo | Azione necessaria |
|---|---|---|
| Ragionamento adattivo ed effort | Nuova | Facoltativa: imposta effort per bilanciare la qualità della risposta con velocità e costi. |
| Finestra di contesto e output più ampi | Nuova | Nessuna. I valori esistenti di max_tokens restano validi, ma i token di ragionamento vengono conteggiati al loro interno. I prompt lunghi vengono fatturati a prezzi più alti; consulta Prezzi del contesto lungo. |
| Strumento browser use | Nuova | Nessuna. Disponibile sulla Claude API e su Google Cloud. |
| I classificatori di sicurezza possono rifiutare una richiesta | Nuova | Gestisci stop_reason: "refusal" nel tuo client. Il fallback lato server non è disponibile. |
| Il ragionamento esteso manuale restituisce un errore | Incompatibile | Sostituisci budget_tokens con il ragionamento adattivo. |
| I parametri di campionamento possono restituire un errore | Incompatibile | Ometti temperature, top_p e top_k. |
| Il prefill dei messaggi dell'assistente restituisce un errore | Incompatibile | Termina messages con un turno dell'utente. |
computer_20250124 restituisce un errore sulla Claude API, su Google Cloud e su Amazon Bedrock | Incompatibile | Sostituiscilo con computer_toolset_20260801 sulla Claude API e su Google Cloud, oppure con computer_20251124 su Amazon Bedrock. |
| Gli output strutturati non sono disponibili su Amazon Bedrock | Incompatibile | Su Amazon Bedrock, descrivi il formato nel prompt o usa uno strumento senza strict, e convalida l'output nel tuo codice. |
| La modifica dei turni precedenti invalida i blocchi di ragionamento | Incompatibile | Mantieni le conversazioni in sola aggiunta se rinvii i blocchi di ragionamento. |
| Le risposte possono iniziare con blocchi di ragionamento | Modificata | Seleziona i blocchi di contenuto in base a type, non in base alla posizione. |
| Il testo del ragionamento è omesso per impostazione predefinita | Modificata | Per ricevere il ragionamento riassunto, imposta thinking.display su "summarized". |
| Lo stesso testo corrisponde a più token | Modificata | Riconta i prompt e rivedi max_tokens e le stime dei costi. |
| Riproduzione dei blocchi di ragionamento tra account | Modificata | Se riproduci conversazioni memorizzate tramite un account diverso, riproduci ciascuna tramite l'account che l'ha prodotta. |
| I blocchi di ragionamento precedenti restano nel contesto | Modificata | Aspettati più token di input nelle conversazioni a più turni. Per rimuovere i blocchi più vecchi, usa la rimozione dei blocchi di ragionamento. |
| I prompt più brevi possono essere memorizzati nella cache | Modificata | Nessuna. La lunghezza minima di un prompt memorizzabile nella cache è di 512 token, rispetto ai 4.096 di Claude Haiku 4.5, quindi un prompt di lunghezza intermedia che imposta cache_control viene memorizzato nella cache su Claude Haiku 5.5. |
| I tag di consapevolezza del contesto non vengono inseriti | Modificata | Per fornire al modello un budget esplicito per un ciclo agentico, usa i budget delle attività (beta). |
Nuove funzionalità
Ragionamento adattivo ed effort
Con il ragionamento adattivo, Claude Haiku 5.5 determina quando e quanto ragionare. Il ragionamento adattivo è attivo per impostazione predefinita. Sebbene tu possa ancora disattivare il ragionamento con thinking: {"type": "disabled"} con effort high o inferiore, il modo migliore per bilanciare la qualità della risposta con velocità e costi è usare il parametro effort.
Finestra di contesto e output più ampi
Claude Haiku 5.5 ha una finestra di contesto da 1M di token e restituisce fino a 128k token di output, rispetto ai 200k e 64k di Claude Haiku 4.5. I valori esistenti di max_tokens restano validi, ma i token di ragionamento vengono conteggiati in max_tokens, quindi un limite ridotto può interrompere la risposta dopo un blocco thinking e prima di qualsiasi testo. Consulta Configura il ragionamento. I prompt lunghi vengono fatturati a prezzi più alti; consulta Prezzi del contesto lungo.
Modifiche di comportamento
Le risposte possono iniziare con blocchi di ragionamento
Il ragionamento adattivo è attivo per impostazione predefinita, quindi una risposta può iniziare con uno o più blocchi thinking anche quando la richiesta non menziona il ragionamento. Il codice che legge il primo blocco di contenuto come risposta deve selezionare i blocchi in base al loro campo type. Consulta Configura il ragionamento nella guida alla migrazione.
I blocchi di ragionamento precedenti restano nel contesto
Claude Haiku 5.5 mantiene nel contesto i blocchi di ragionamento di tutti i turni precedenti dell'assistente, e questi vengono conteggiati come token di input. Claude Haiku 4.5 manteneva solo i blocchi dell'ultimo turno. Le conversazioni a più turni comportano quindi più token di input di quanto spieghi la sola modifica del tokenizer. Per rimuovere i blocchi più vecchi, usa la rimozione dei blocchi di ragionamento. Consulta Preservazione dei blocchi di ragionamento per modello.
Lo stesso testo corrisponde a più token
Claude Haiku 5.5 utilizza lo stesso tokenizer più recente di Claude 4.7 e dei modelli successivi. Come per tutti i modelli che utilizzano questo tokenizer, lo stesso testo di input produce circa il 30% di token in più su Claude Haiku 5.5 rispetto a Claude Haiku 4.5. L'aumento esatto dipende dal contenuto. La struttura delle richieste e delle risposte non dipende dal tokenizer, ma tutto ciò che misuri o pianifichi in token cambia. Consulta Riconta i token nella guida alla migrazione.
Riproduzione dei blocchi di ragionamento tra account
I blocchi di ragionamento di Claude Haiku 5.5 funzionano solo nell'account che li ha prodotti o in un account collegato a esso. Questo è rilevante solo se memorizzi le conversazioni e le riproduci tramite un account diverso. Consulta Riproduci i blocchi di ragionamento tramite l'account che li ha prodotti.
Was this page helpful?