Per una guida alla migrazione più diretta al codice, consulta la nostra guida alla migrazione di riferimento API.

Mentre continuiamo a migliorare ed espandere le nostre capacità di AI, siamo entusiasti di presentare la nostra nuova API Messages, che offre diversi vantaggi rispetto alla nostra API Text Completions legacy.

Questa guida ti aiuterà a migrare le tue applicazioni esistenti dall’API Text Completions all’API Messages, garantendo una transizione fluida e sbloccando l’accesso alle nostre ultime funzionalità e miglioramenti.

​
Perché aggiornare all’API Messages?

L’API Messages offre diversi vantaggi chiave:

  1. Elaborazione delle immagini: L’API Messages è l’unico modo per elaborare le immagini con Claude, consentendoti di sfruttare le nostre avanzate capacità di visione artificiale per attività come la classificazione delle immagini, il rilevamento di oggetti e altro ancora.
  2. Costruire con i modelli Claude 3: I nostri modelli Claude 3 più recenti e potenti (Haiku, Sonnet e Opus) possono essere chiamati solo tramite l’API Messages. Aggiornando, sarai in grado di sfruttare le loro prestazioni e capacità migliorate.
  3. Gestione degli errori migliorata: L’API Messages ci consente di restituire messaggi di errore più informativi e utili, rendendo più facile per te diagnosticare e risolvere i problemi nelle tue richieste.
  4. Migliore convalida delle richieste: Con l’API Messages, possiamo convalidare le tue richieste API in modo più efficace, garantendo che tu riceva i risultati di massima qualità e le migliori prestazioni possibili dai nostri modelli.

​
Come aggiornare all’API Messages

Il modo più semplice per eseguire l’aggiornamento dall’API Text Completions all’API Messages è utilizzare la nostra Console web per convertire i tuoi prompt. Utilizzando la Console, puoi migrare rapidamente e facilmente i tuoi prompt e le tue richieste all’API Messages senza dover riscrivere manualmente il tuo codice.

Segui semplicemente questi passaggi:

​
1. Vai alla Console e seleziona il modello che desideri utilizzare

All’interno della Console, c’è un pannello delle impostazioni del modello in basso a destra dell’area dei messaggi. Quel pannello ospita un menu a discesa in cui puoi selezionare il modello corretto per il tuo prompt migrato.

Qui puoi anche regolare eventuali parametri aggiuntivi secondo necessità, come la temperatura e il numero massimo di token da campionare. Per ulteriori informazioni sui nostri parametri, consulta la documentazione dell’API Messages.

​
2. Trasferisci il tuo prompt nei campi di messaggio appropriati della Console

I prompt dell’API Text Completions sono stringhe multilinea che comprendono tutte le parti di un prompt, come il prompt di sistema e il turno dell’utente. L’API Messages suddivide le varie parti di un prompt, come il prompt di sistema e il turno dell’utente, in campi separati.

Ad esempio, prendiamo questo prompt dell’API Text Completions:

Text
Today is March 4, 2024.

H: What are 3 ways to cook apples?

A:

Senza utilizzare la Console, la transizione di questo prompt richiederebbe di riscrivere completamente il tuo codice nell’API Messages. Tuttavia, rilasciando le parti separate del tuo prompt (prompt di sistema e prompt utente) nei campi corrispondenti della Console, puoi estrarre codice preformattato corretto pronto all’uso.

Nella Console, il prompt di cui sopra avrebbe questo aspetto:

Nota che non c’è alcun testo Human: o Assistant: e che il prompt di sistema e il prompt utente appartengono a campi di messaggio diversi.

​
3. Copia il codice preformattato

Una volta che tutte le parti del tuo prompt sono a posto e i parametri sono stati regolati, fai clic sul pulsante </> Get Code in alto a destra per visualizzare e copiare il frammento di codice corrispondente dell’API Messages, sia per Python che per TypeScript.

Per il nostro prompt di esempio, l’output Python automatizzato dal menu </> Get Code sarebbe:

Python
import anthropic

client = anthropic.Anthropic(
    # defaults to os.environ.get("ANTHROPIC_API_KEY")
    api_key="my_api_key",
)
message = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    temperature=0,
    system="Today is March 4, 2024.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "What are 3 ways to cook apples?"
                }
            ]
        }
    ]
)
print(message.content)

Nota: La Console non consente ancora di precompilare la risposta di Claude (cioè precompilare il testo nel turno Assistant), ma l’API Messages sottostante sì. Consulta la nostra guida su come precompilare la risposta di Claude per esempi su come formattare una richiesta dell’API Messages con questa tecnica.

​
Migrazione da altri modelli

Se attualmente stai utilizzando una piattaforma o un modello di AI diverso e desideri passare a Claude con l’API Messages, abbiamo creato una guida completa per aiutarti nel processo. Consulta migrazione da altri modelli per istruzioni dettagliate su come adattare i tuoi prompt e il tuo codice alla nostra piattaforma.

​
Documentazione API

Per ulteriori informazioni sull’API Messages e le sue funzionalità, consulta la nostra documentazione API:

Se hai domande o hai bisogno di ulteriore assistenza per l’aggiornamento all’API Messages, non esitare a contattare il nostro team di supporto. Siamo qui per aiutarti a sfruttare al meglio le nostre capacità di AI e garantire una transizione fluida a Claude.

Migrazione da altri modelliPanoramica