Come concatenare le chiamate all'API di Claude in un flusso di lavoro
3 min di lettura
Quando costruisci qualcosa di automatizzato con l'API di Claude, probabilmente inizi scrivendo un grande prompt che cerca di svolgere l'intera attività in una sola chiamata, poi ti frustri perché parte dell'output non è affidabile.
Un flusso che fa una cosa per chiamata è più facile da considerare affidabile di un solo prompt che cerca di fare tutto insieme.
Un'attività per chiamata, poi si compone
Dividi il lavoro come faresti nel codice normale: una chiamata estrae o classifica, una seconda agisce su quel risultato. Ogni chiamata è più semplice da far riuscire, e puoi ispezionare l'output tra i passaggi invece di fare debug di un lungo prompt ingarbugliato.
- 1
Individua l'unico output della prima chiamata
Decidi esattamente quale risultato strutturato la prima chiamata deve produrre, e nulla di più. Un compito più stretto è più facile da far riuscire in modo affidabile.
- 2
Passa quel risultato come input alla seconda chiamata
Il prompt della seconda chiamata deve riferirsi all'output reale della prima, non ripetere da zero l'input grezzo originale.
- 3
Dai a ogni chiamata i propri criteri di successo chiari
Se il primo passaggio fallisce o restituisce qualcosa di inatteso, vuoi sapere quale passaggio si è rotto, senza dover sbrogliare un'unica risposta gigante.
Progetta un flusso in due passaggi: la prima chiamata legge un ticket di supporto incollato ed estrae la vera richiesta del cliente in un riassunto di una frase più una categoria (fatturazione, bug, richiesta di funzione). La seconda chiamata prende quel riassunto e quella categoria e scrive una prima risposta nel nostro tono: diretto, senza scuse a meno che l'errore fosse davvero nostro. Mostrami la forma della richiesta per ogni passaggio.
”
Dentro Claude Tutorial
Scomporre il lavoro in passaggi più piccoli è una competenza di Claude tra le tante
Scomporre un grande compito in passaggi a scopo singolo che si appoggiano l'uno all'altro compare anche nelle lezioni dell'app, non solo nei flussi costruiti sull'API.
Dove tende ad andare storto
L'errore più comune è saltare del tutto il confine tra le chiamate, lasciando che il testo grezzo e non strutturato della prima alimenti direttamente la seconda. Chiedi alla prima chiamata una forma specifica e strutturata (un breve riassunto, una categoria, un piccolo insieme di campi) anziché prosa libera, così la seconda ha qualcosa di affidabile su cui costruire.
Attenzione
Se non riesci a dire con chiarezza cosa deve produrre la prima chiamata prima di scrivere il suo prompt, il flusso probabilmente non è ancora scomposto correttamente. Sistema il confine prima di aggiungere una seconda chiamata.
Continua a leggere
- Collegare Claude ai tuoi dati e strumenti con MCP per ancorare un passaggio del flusso a dati dal vivo anziché solo a ciò che è incollato.
- Cosa sono gli artefatti di Claude? Un'introduzione pratica per chiamare l'API di Claude da dentro un prototipo in esecuzione anziché dal tuo codice backend.
- Fare una modifica a più file con Claude Code invece di un file alla volta per la stessa abitudine di “descrivere il risultato, verificare il risultato” applicata alla modifica del codice anziché alla composizione di chiamate API.