Inizia con Claude
Impariamo come utilizzare l’API di Anthropic per costruire con Claude.
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 la Workbench
Qualsiasi chiamata API che effettui—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 nella Workbench, un’interfaccia web per Claude.
Accedi alla Console Anthropic e clicca su Write a prompt from scratch.
Nella sezione centrale, sotto User, poniamo una domanda a Claude.
Clicca su Run. Sul lato destro, vedrai un output simile a
Questa è una buona risposta, ma supponiamo di voler controllare il tipo esatto di risposta che Claude fornisce. 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.
Clicca nuovamente su Run.
Vedi come è cambiata la risposta di Claude? I modelli 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 metodo 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 la tua Workbench in un’integrazione.
Installa l’SDK
Anthropic fornisce SDK per Python (3.7+), TypeScript (4.5+) e Java (8+). Abbiamo anche un SDK Go attualmente in beta.
Nella directory del tuo progetto, crea un ambiente virtuale.
Attiva l’ambiente virtuale usando
- Su macOS o Linux,
source claude-env/bin/activate
- Su Windows,
claude-env\Scripts\activate
Nella directory del tuo progetto, crea un ambiente virtuale.
Attiva l’ambiente virtuale usando
- Su macOS o Linux,
source claude-env/bin/activate
- Su Windows,
claude-env\Scripts\activate
Installa l’SDK.
Prima trova la versione corrente dell’SDK Java su Maven Central. Dichiara l’SDK come dipendenza nel tuo file Gradle:
O nel tuo file Maven:
Imposta la tua chiave API
Ogni chiamata API richiede una chiave API valida. Gli SDK sono progettati per prendere la chiave API dalla variabile d’ambiente ANTHROPIC_API_KEY
. Puoi anche fornire la chiave al client Anthropic durante l’inizializzazione.
Chiama l’API
Chiama l’API passando i parametri corretti all’endpoint /messages.
Nota che il codice fornito dalla 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.
Esegui il codice usando python3 claude_quickstart.py
o node claude_quickstart.js
.
Questa guida rapida mostra come sviluppare un’applicazione basica, ma funzionale, alimentata da Claude utilizzando la Console, la 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 effettuato la tua prima richiesta all’API di Anthropic, è il momento di esplorare cos’altro è possibile: