Configurazione iniziale

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

​

Prerequisiti

Avrai bisogno di:

• Un account Console Anthropic
• Una chiave API
• Python 3.7+ o TypeScript 4.5+

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

​

Inizia con il Workbench

Qualsiasi chiamata API che fai—indipendentemente dal compito specifico—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 Anthropic e clicca su Workbench.

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

Perché l'oceano è salato?

Clicca su Run. Sul lato destro, vedrai un output simile a

L'oceano è salato a causa di diversi fattori:

1. Erosione delle rocce: Nel corso di milioni di anni, pioggia, fiumi e ruscelli hanno eroso 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 oceanici 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 tempo, questi processi hanno continuamente aggiunto sali all'oceano, mentre l'evaporazione rimuove l'acqua pura, portando agli attuali livelli di salinità 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 di evaporiti.

Questa è una buona risposta, ma supponiamo di voler controllare il tipo esatto di risposta che Claude fornisce. Per esempio, permettere a Claude di rispondere alle domande solo con poesie. Possiamo controllare il formato, il tono e la personalità della risposta aggiungendo un System Prompt.

Sei un poeta di classe mondiale. Rispondi solo con brevi poesie.

Clicca nuovamente su Run.

La salamoia dell'oceano,
Un racconto di tempo e elementi combinato.
Rocce e pioggia, una lenta erosione,
Minerali portati in soluzione.
Eoni passano, il sale rimane,
Nel vasto, eterno dominio acquoso.

Vedi come è cambiata la risposta di Claude? Gli LLM rispondono bene a istruzioni chiare e dirette. Puoi inserire le istruzioni sul ruolo sia nel prompt di sistema che nel messaggio dell’utente. Ti consigliamo di testare per vedere quale modo produce i migliori risultati 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 usare Claude—converti il tuo Workbench in un’integrazione.

​

Installa l’SDK

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

• Python
• TypeScript

python -m venv claude-env

pip install anthropic

​

Imposta la tua chiave API

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

• macOS e Linux
• Windows

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

​

Chiama l’API

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

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

• Python
• TypeScript

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1000,
    temperature=0,
    system="Sei un poeta di classe 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.

[TextBlock(text="La salamoia dell'oceano,\nUn racconto di tempo e disegno.\nRocce e fiumi, i loro minerali versati,\nAccumulandosi nel letto oceanico.\nL'evaporazione lascia il sale dietro,\nNelle vaste acque, per sempre custodito.", type='text')]

Questa guida rapida mostra come sviluppare un’applicazione base, ma funzionale, alimentata da Claude utilizzando la Console, il Workbench e l’API. Puoi utilizzare questo stesso flusso di lavoro come base per casi d’uso molto più potenti.

​

Prossimi passi

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