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 latenza, come classificazione, instradamento, estrazione e attività di subagenti. Supporta il ragionamento adattivo con il parametro effort, una “context window” (finestra di contesto) da 1M di 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 conta come circa il 30 percento 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 richiesta |
|---|---|---|
| Ragionamento adattivo ed effort | Nuovo | Facoltativo: imposta effort per bilanciare la qualità delle risposte con velocità e costo. |
| Finestra di contesto e output più ampi | Nuovo | 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 per contesti lunghi. |
| Strumento browser use | Nuovo | Nessuna. |
| I classificatori di sicurezza possono rifiutare una richiesta | Nuovo | Gestisci stop_reason: "refusal" nel tuo client. Il fallback lato server non è disponibile. Rimuovi dai prompt le istruzioni che chiedono al modello di scrivere il proprio ragionamento. |
| 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 | Incompatibile | Sostituiscilo con computer_toolset_20260801. Su Amazon Bedrock funziona anche computer_20251124. |
| 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 | Modificato | Seleziona i blocchi di contenuto in base al type, non alla posizione. |
| Il testo del ragionamento è omesso per impostazione predefinita | Modificato | Per ricevere il ragionamento riassunto, imposta thinking.display su "summarized". |
| Lo stesso testo conta come più token | Modificato | Riconta i token dei prompt e rivedi max_tokens e le stime dei costi. |
| Riproduzione dei blocchi di ragionamento tra account diversi | Modificato | Se riproduci conversazioni archiviate tramite un account diverso, riproduci ciascuna tramite l’account che l’ha generata. |
| I blocchi di ragionamento precedenti restano nel contesto | Modificato | Aspettati più token di input nelle conversazioni multi-turno. Per rimuovere i blocchi più vecchi, usa la cancellazione dei blocchi di ragionamento. |
| I prompt più brevi possono essere memorizzati nella cache | Modificato | 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 | Modificato | 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 “adaptive thinking” (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 Configurare 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 percento 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 Ricontare 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.
Questa pagina ti è stata utile?