In questo esempio, faremo scrivere a Claude una funzione Python che verifica se una stringa è un palindromo.

​
Prerequisiti

Per completare questa guida rapida, hai bisogno di:

Anthropic fornisce SDK per Python e TypeScript, anche se puoi effettuare richieste HTTP dirette all’API.

​
Inizia con il Workbench

Qualsiasi chiamata API che effettui, indipendentemente dall’attività specifica, invia un prompt ben configurato all’API di Anthropic. Mentre impari a sfruttare al meglio Claude, ti consigliamo di iniziare il processo di sviluppo nel Workbench, un’interfaccia web per Claude.

Accedi alla Console di Anthropic e fai clic su Workbench.

Nella sezione centrale, sotto User, poniamo una domanda a Claude.

User
Perché l'oceano è salato?

Fai clic su Run. Sul lato destro, vedrai un output come

Response
L'oceano è salato a causa di diversi fattori:

1. Erosione delle rocce: Nel corso di milioni di anni, pioggia, fiumi e ruscelli hanno eroso le rocce contenenti sali minerali. Questi sali vengono trasportati nell'oceano dal deflusso dell'acqua.
2. Attività vulcanica: I vulcani sottomarini e le sorgenti idrotermali rilasciano minerali, inclusi i sali, nell'acqua dell'oceano.
3. Deposizione atmosferica: Le particelle di sale provenienti dagli spruzzi dell'oceano possono essere trasportate dal vento e depositate nuovamente nell'oceano.
4. Evaporazione: Quando l'acqua evapora dalla superficie dell'oceano, lascia dietro di sé i sali disciolti, aumentando la concentrazione di sale nell'acqua rimanente.
5. Processi biologici: Alcuni organismi marini contribuiscono alla salinità dell'oceano rilasciando composti salini come sottoprodotti del loro metabolismo.

Nel corso del tempo, questi processi hanno continuamente aggiunto sali all'oceano, mentre l'evaporazione rimuove l'acqua pura, portando ai livelli di salinità attuali dell'oceano. È importante notare che la quantità totale di sale nell'oceano rimane relativamente stabile perché l'apporto di sali è bilanciato dalla rimozione di sali attraverso processi come la formazione di depositi evaporitici.

Questa è una buona risposta, ma diciamo che volessimo controllare esattamente il tipo di risposta che Claude dà. Ad esempio, permettendo a Claude di rispondere alle domande solo con poesie. Possiamo controllare il formato, il tono e la personalità della risposta aggiungendo un System Prompt.

System prompt
Sei un poeta di fama mondiale. Rispondi solo con brevi poesie.

Fai clic su Run di nuovo.

Response
La salata acqua dell'oceano,
Una storia di tempo ed elementi combinati.
Rocce e pioggia, una lenta erosione,
Minerali trasportati in soluzione.
Passano eoni, il sale rimane,
Nel vasto, eterno dominio acquatico.

Vedi come la risposta di Claude è cambiata? I LLM rispondono bene a istruzioni chiare e dirette. Puoi mettere le istruzioni sul ruolo nel prompt di sistema o nel messaggio dell’utente. Ti consigliamo di testare per vedere quale modo produce i risultati migliori per il tuo caso d’uso.

Una volta che hai modificato gli input in modo da essere soddisfatto dell’output, e hai una buona idea di come utilizzare Claude, converti il tuo Workbench in un’integrazione.

Fai clic su Get Code per copiare il codice generato che rappresenta la tua sessione di Workbench.

​
Installa l’SDK

Anthropic fornisce SDK per Python (3.7+) e TypeScript (4.5+).

Nella directory del tuo progetto, crea un ambiente virtuale.

Python
python -m venv claude-env

Attiva l’ambiente virtuale usando

  • Su macOS o Linux, source claude-env/bin/activate
  • Su Windows, claude-env\Scripts\activate
Python
pip install anthropic

​
Imposta la tua chiave API

Ogni chiamata API richiede una chiave API valida. Gli SDK sono progettati per prelevare la chiave API da una variabile d’ambiente ANTHROPIC_API_KEY. Puoi anche fornire la chiave al client Anthropic durante l’inizializzazione.

export ANTHROPIC_API_KEY='your-api-key-here'

​
Chiama l’API

Chiama l’API passando i parametri corretti all’endpoint /messages/create.

Nota che il codice fornito dal Workbench imposta la chiave API nel costruttore. Se imposti la chiave API come variabile d’ambiente, puoi omettere quella riga come di seguito.

claude_quickstart.py
import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20240620",
    max_tokens=1000,
    temperature=0,
    system="Sei un poeta di fama mondiale. Rispondi solo con brevi poesie.",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Perché l'oceano è salato?"
                }
            ]
        }
    ]
)
print(message.content)

Esegui il codice usando python3 claude_quickstart.py o node claude_quickstart.js.

Response
[TextBlock(text="La salata acqua dell'oceano,\nUna storia di tempo e disegno.\nRocce e fiumi, i loro minerali cedono,\nAccumulandosi nel letto dell'oceano.\nL'evaporazione lascia il sale dietro,\nNelle vaste acque, per sempre custodito.", type='text')]
Il Workbench e gli esempi di codice utilizzano le impostazioni predefinite del modello per: modello (nome), temperatura e token massimi da campionare.

Questa guida rapida mostra come sviluppare un’applicazione di base, ma funzionale, basata su Claude utilizzando Console, Workbench e API. Puoi utilizzare lo stesso flusso di lavoro come base per casi d’uso molto più potenti.

​
Prossimi passi

Ora che hai effettuato la tua prima richiesta all’API di Anthropic, è il momento di esplorare cos’altro è possibile:

Guida all'ingegneria dei prompt

Ottimizza le prestazioni di Claude attraverso il prompting.

Anthropic Cookbook

Impara con notebook Jupyter interattivi che dimostrano il caricamento di PDF, embedding e altro ancora.

Libreria di prompt

Esplora dozzine di prompt di esempio per trarre ispirazione per diversi casi d’uso.

PanoramicaIntroduzione a Claude