Orchestratore di Agenti AI
Impara da zero a creare un sistema di agenti AI che lavorano insieme con Claude Cowork
📑 Indice del Tutorial
- 1. Ma cos'è un'AI? Partiamo dalle basi
- 2. Cos'è un Agente AI (e perché ti serve)
- 3. L'Orchestratore e i Sub-Agenti: come funzionano
- 4. Cosa ti serve per iniziare
- 5. Step 1: Iscriviti e installa Claude
- 6. Step 2: Il tuo primo task con Cowork
- 7. Step 3: Crea il tuo Orchestratore
- 8. Step 4: Configura i Sub-Agenti specializzati
- 9. Step 5: Fai lavorare gli agenti insieme
- 10. Esempi pratici completi
- 11. Errori comuni e come evitarli
- 12. Prossimi passi
🧠 Ma cos'è un'AI? Partiamo dalle basi
Se non hai mai usato un'intelligenza artificiale, niente paura! Spieghiamo tutto da zero.
🤔 Cos'è un'Intelligenza Artificiale?
Un'AI è un programma per computer che è stato "addestrato" su miliardi di testi, libri, siti web e conversazioni. Grazie a questo addestramento, è capace di:
- 📝 Capire quello che gli scrivi in italiano (o qualsiasi lingua)
- 💬 Rispondere in modo intelligente e coerente
- 🔍 Ragionare su problemi complessi
- ✍️ Creare testi, analisi, codice e molto altro
Pensa all'AI come a un assistente molto intelligente che ha letto praticamente tutto quello che esiste su internet e che è pronto ad aiutarti 24 ore su 24.
💬 Chat vs Agente: la differenza fondamentale
Quando chatti con ChatGPT o Claude, stai usando l'AI in modalità "chat": tu scrivi una domanda, l'AI ti risponde. È come mandare messaggi a un amico molto intelligente.
Ma c'è un livello superiore: l'AI come agente. In questa modalità, l'AI non si limita a rispondere — agisce sul tuo computer. Può aprire file, creare cartelle, scrivere documenti, navigare il web. È come avere un assistente che non solo ti dice cosa fare, ma lo fa al posto tuo.
| Modalità | Cosa fa | Esempio |
|---|---|---|
| 💬 Chat | Risponde alle tue domande | "Come si fa un business plan?" → Ti spiega la teoria |
| 🤝 Agente (Cowork) | Esegue azioni concrete | "Fammi un business plan" → Crea il file Excel e il documento Word |
🤖 Cos'è un Agente AI (e perché ti serve)
Un agente AI è un'intelligenza artificiale che può eseguire task in autonomia. Non è solo un chatbot: è un vero e proprio collaboratore digitale.
🏢 Analogia: l'ufficio
Immagina di avere un ufficio con dei dipendenti:
- Un chatbot è come un collega a cui puoi fare domande al telefono. Ti risponde, ma non si alza dalla sedia.
- Un agente AI è come un assistente che prende il tuo compito, va alla scrivania, apre i file, lavora per un'ora e ti porta il risultato finito.
✨ Cosa può fare un agente con Claude Cowork:
- 📂 Organizzare cartelle e rinominare file
- 📊 Creare fogli Excel con dati e grafici
- 📝 Scrivere documenti Word e PDF
- 🔍 Fare ricerche sul web
- 📧 Leggere messaggi Slack e Notion
- 📋 Preparare presentazioni PowerPoint
- 🗂️ Analizzare centinaia di file in pochi minuti
- 📑 Sintetizzare informazioni da più fonti
💡 La cosa più importante
L'agente ti chiede sempre il permesso prima di agire. Ti mostra il suo piano e aspetta che tu dica "ok, procedi". Non farà mai nulla senza il tuo consenso. Sei sempre tu al comando!
🎯 L'Orchestratore e i Sub-Agenti
Ora arriviamo alla parte più interessante. Quando hai un compito grande e complesso, un singolo agente potrebbe non bastare. È come chiedere a una sola persona di fare tutto: ricerca, analisi, scrittura, grafica. Meglio dividere il lavoro!
🎶 Analogia: l'orchestra
Pensa a un'orchestra musicale:
- Il direttore d'orchestra (= orchestratore) non suona nessuno strumento, ma coordina tutti i musicisti
- I musicisti (= sub-agenti) sono specializzati: chi suona il violino, chi il piano, chi la tromba
- Insieme creano una sinfonia (= il risultato finale) che nessuno di loro potrebbe creare da solo
ORCHESTRATORE
Riceve il tuo obiettivo, lo scompone in sotto-task e coordina i sub-agenti
Cerca informazioni sul web e nei documenti
Analizza dati e crea grafici e tabelle
Redige report, email e documenti
Organizza cartelle, rinomina e archivia
🛠️ Cosa ti serve per iniziare
Un Mac
Claude Cowork funziona solo su macOS (per ora). Serve un Mac con macOS 13 o superiore.
Piano Claude Pro (minimo)
Cowork è incluso nei piani Pro ($20/mese), Max 5x ($100/mese) e Max 20x ($200/mese).
📋 Checklist prima di iniziare
- ☐ Un computer Mac con macOS 13+
- ☐ Una connessione internet stabile
- ☐ Un indirizzo email per creare l'account
- ☐ Una carta di credito per il piano Pro ($20/mese)
- ☐ 30-45 minuti di tempo per seguire il tutorial
💡 Non hai un Mac?
Puoi comunque usare Claude in versione chat dal browser su qualsiasi computer. Non avrai la funzione Cowork, ma potrai seguire la logica dell'orchestratore usando prompt strutturati nella chat. Spiegheremo anche come fare!
📱 Iscriviti e Installa Claude Desktop
Seguiamo insieme ogni singolo passaggio. Non serve alcuna competenza tecnica!
1.1 — Crea il tuo account Anthropic
- Apri il browser (Safari, Chrome, Firefox...) e vai su claude.ai
- Clicca sul pulsante "Sign Up" (Iscriviti) in alto a destra
-
Puoi iscriverti con:
- 📧 Email: inserisci la tua email e scegli una password
- 🔵 Google: clicca "Continue with Google" per usare il tuo account Gmail
- Conferma l'email cliccando sul link che riceverai nella tua casella di posta
- Completa il profilo con il tuo nome
💡 Primo contatto con Claude
Appena entri, vedrai una chat. Prova a scrivere qualcosa come "Ciao! Puoi spiegarmi chi sei in modo semplice?". Claude ti risponderà in italiano! Questo è il modo "chat" — utile, ma noi vogliamo fare molto di più.
1.2 — Attiva il piano Pro
- Vai su claude.ai/settings/billing
- Clicca su "Upgrade to Pro"
- Inserisci i dati della tua carta di credito
- Conferma l'abbonamento a $20/mese (circa €18,50)
1.3 — Scarica e installa l'app desktop
- Vai su claude.ai/download
- Clicca "Download for macOS"
- Apri il file .dmg scaricato
- Trascina l'icona di Claude nella cartella Applicazioni
- Apri Claude dalla cartella Applicazioni (o dal Launchpad)
- Accedi con le credenziali create al punto 1.1
✅ Fatto! Dovresti vedere...
L'app Claude Desktop con una sidebar a sinistra. Nella sidebar vedrai tre opzioni: Chat, Code e Cowork. Se vedi "Cowork", sei pronto per il passo successivo!
🎮 Il tuo primo Task con Cowork
Prima di costruire un sistema di agenti complesso, facciamo un test semplice per capire come funziona Cowork. Sarà il tuo "Hello World" dell'automazione AI!
2.1 — Apri Cowork
- Nell'app Claude Desktop, clicca su "Cowork" nella sidebar a sinistra
- Si aprirà una nuova interfaccia con una barra per scrivere in basso
- In alto vedrai un'icona 📎 per collegare cartelle e connettori
2.2 — Collega una cartella di test
Creiamo prima una cartella di prova per non rischiare di modificare file importanti:
- Apri il Finder sul tuo Mac
- Vai sulla Scrivania (Desktop)
- Crea una nuova cartella chiamata "Test-Cowork"
- Dentro questa cartella, crea 5-6 file di testo vuoti (click destro → Nuovo Documento)
- Torna su Claude Cowork, clicca l'icona 📎 e seleziona la cartella "Test-Cowork"
2.3 — Scrivi il tuo primo prompt
Adesso scrivi il seguente messaggio nella barra di Cowork:
2.4 — Cosa succede adesso
Osserva con attenzione quello che fa Claude:
- 📋 Legge i file nella cartella (vedrai un'animazione di "lavoro in corso")
- 🧠 Analizza cosa ha trovato
- 📝 Ti mostra un piano con le sue proposte
- ⏸️ Si ferma e aspetta la tua approvazione
💡 Hai capito il concetto?
Questo è il cuore di Cowork: tu dai l'obiettivo, Claude pianifica, tu approvi, Claude esegue. Non fa nulla senza il tuo consenso. Ora che hai capito come funziona, costruiamo qualcosa di più potente!
🎯 Crea il tuo Orchestratore
Ora costruiamo il "direttore d'orchestra". L'idea è semplice: scriveremo un prompt speciale che dice a Claude di comportarsi come un coordinatore che scompone lavori complessi in sotto-task.
🤔 Cosa cambia rispetto al task semplice?
Nel task semplice hai detto "organizzami i file". Con l'orchestratore, dici a Claude: "Sei un project manager. Quando ti do un obiettivo, devi scomporlo in fasi, assegnare un ruolo specializzato a ciascuna fase, e poi eseguirle una alla volta."
3.1 — Il Prompt dell'Orchestratore
Apri una nuova conversazione Cowork e incolla questo prompt. È lungo, ma ogni riga ha uno scopo preciso — te lo spiego sotto:
3.2 — Spiegazione riga per riga
Ecco cosa fa ogni parte del prompt:
| Sezione | Cosa fa | Perché è importante |
|---|---|---|
| MODALITÀ ORCHESTRATORE | Dice a Claude che ruolo deve assumere | L'AI si comporta diversamente in base al ruolo che le assegni |
| Fase 1 — Analisi | Claude deve scomporre il tuo obiettivo in sotto-task | Un compito grande diventa più facile se lo dividi in pezzi piccoli |
| Fase 2 — Piano | Claude ti mostra cosa farà PRIMA di farlo | Tu mantieni il controllo e puoi correggere il tiro |
| Fase 3 — Esecuzione | Claude lavora un pezzo alla volta e ti aggiorna | Puoi seguire il progresso e intervenire se serve |
| Regole importanti | Vincoli di sicurezza | Evitano che Claude faccia cose che non vuoi |
💡 Non devi imparare tutto a memoria!
Salva questo prompt in un file di testo sul tuo Mac. Ogni volta che vuoi usare l'orchestratore, basta copiarlo e incollarlo all'inizio di una nuova conversazione Cowork.
🤖 Configura i Sub-Agenti Specializzati
I sub-agenti sono le "specializzazioni" che l'orchestratore usa per completare il lavoro. Non servono software separati: è sempre Claude, ma con istruzioni specifiche per ogni ruolo.
🎭 Come funzionano i sub-agenti?
Immagina Claude come un attore molto bravo. Quando l'orchestratore dice "ora serve l'Agente Ricerca", Claude "mette il cappello" del ricercatore e si concentra solo su quello. Poi cambia cappello per il ruolo successivo. Tutto avviene nella stessa conversazione!
4.1 — Sub-Agente 🔍 RICERCA
Questo agente raccoglie informazioni. Dopo aver attivato l'orchestratore, puoi definirlo così:
4.2 — Sub-Agente 📊 ANALISI DATI
4.3 — Sub-Agente ✍️ SCRITTURA
4.4 — Sub-Agente 📂 ORGANIZZAZIONE FILE
4.5 — Come usare i sub-agenti in pratica
Puoi includere tutti i sub-agenti nello stesso prompt iniziale dell'orchestratore. Basta aggiungerli dopo il prompt principale. Claude capirà che deve "attivare" il sub-agente giusto al momento giusto.
💡 Prompt completo = Orchestratore + Sub-Agenti
Il tuo prompt iniziale sarà così strutturato:
- Prompt dell'Orchestratore (quello dello Step 3)
- Definizione Sub-Agente Ricerca
- Definizione Sub-Agente Analisi
- Definizione Sub-Agente Scrittura
- Definizione Sub-Agente File
- "Orchestratore attivo ✅ — aspetta il mio obiettivo"
Salva tutto in un unico file di testo. Ogni volta che apri Cowork, copia-incolla e sei operativo in 5 secondi!
🚀 Fai lavorare gli Agenti insieme
Ora che hai configurato tutto, è il momento di vedere la magia in azione! Dopo aver incollato il prompt completo (orchestratore + sub-agenti), Claude risponderà "Orchestratore attivo ✅". A quel punto sei pronto a dargli il tuo primo obiettivo reale.
5.1 — Dai il primo obiettivo
Ecco un esempio perfetto per iniziare:
5.2 — Cosa vedrai succedere
Claude (come orchestratore) ti risponderà con qualcosa del genere:
🎯 Piano dell'Orchestratore:
Ho analizzato il tuo obiettivo e lo divido in 4 fasi:
Fase 1 — Agente Ricerca 🔍 (10 min)
Cerco sul web le migliori app AI gratuite del 2026, verifico che siano
ancora attive e raccolgo informazioni su funzionalità e prezzi.
Fase 2 — Agente Analisi 📊 (5 min)
Creo una tabella comparativa con le 5 migliori e le valuto su criteri
oggettivi.
Fase 3 — Agente Scrittura ✍️ (10 min)
Scrivo il report completo in formato professionale con intro, analisi
e raccomandazione.
Fase 4 — Agente File 📂 (2 min)
Organizzo tutto nella cartella che hai indicato con naming corretto e
file index.
Tempo totale stimato: ~27 minuti
Procedo con la Fase 1? 👍
5.3 — Il tuo ruolo durante l'esecuzione
Mentre gli agenti lavorano, tu devi fare pochissimo:
| Momento | Cosa fa Claude | Cosa fai tu |
|---|---|---|
| Dopo ogni fase | Ti mostra il risultato parziale | Leggi, e rispondi "OK procedi" oppure "Modifica questo..." |
| Se ha dubbi | Ti fa una domanda specifica | Rispondi con più dettagli |
| Se serve approvazione | Ti mostra cosa sta per fare (es. creare file) | Approvi o correggi |
| Alla fine | Ti consegna il risultato completo | Verifichi e richiedi modifiche se necessario |
💡 Puoi anche andare a prenderti un caffè!
Una volta approvato il piano, Claude lavora in autonomia. Puoi minimizzare l'app e fare altro. Quando avrà finito una fase, vedrai una notifica sul tuo Mac. Torni, approvi la fase successiva, e via così!
📚 Esempi Pratici Completi
Ecco 3 scenari reali dove l'orchestratore brilla. Per ognuno, ti do il prompt pronto da copiare!
📌 Esempio 1: Analisi Competitor per una Startup
📌 Esempio 2: Organizzare un archivio di documenti
📌 Esempio 3: Briefing settimanale automatico
💡 Connettori per il Briefing
Per l'Esempio 3, devi prima collegare i connettori. In Cowork, clicca l'icona 📎 → "Aggiungi connettore" → seleziona Slack, Notion e GitHub. Claude ti guiderà nell'autorizzazione (basta cliccare "Autorizza" e accedere ai tuoi account).
Non sai cosa sono i connettori? Leggi la guida completa a Claude Cowork!
⚠️ Errori Comuni e Come Evitarli
| Errore | Perché succede | Come evitarlo |
|---|---|---|
| Claude fa tutto senza chiedere | Non hai specificato di mostrarti il piano | Aggiungi sempre "Mostrami il piano PRIMA di agire" nel prompt |
| Il risultato è troppo generico | L'obiettivo era vago | Sii specifico: cosa vuoi, in che formato, dove salvarlo |
| Claude si confonde tra le fasi | Troppi sub-agenti o ruoli poco chiari | Inizia con 2-3 sub-agenti, poi aggiungi se serve |
| "Ho raggiunto il limite di utilizzo" | Il piano Pro ha limiti giornalieri | Cowork consuma più crediti della chat. Valuta il piano Max ($100/mese) per uso intensivo |
| Non trova la cartella | Non hai collegato la cartella in Cowork | Clicca 📎 in alto e seleziona la cartella prima di iniziare |
| Non riesce a cercare sul web | Claude in Chrome non è installato | Installa l'estensione da claude.ai/chrome |
| Modifica file che non doveva | Gli hai dato accesso a troppi file | Collega SOLO la cartella specifica del progetto, mai intere directory come ~/Documenti |
⚠️ Regola d'oro della sicurezza
Mai dare a Cowork accesso a cartelle con documenti finanziari, password, dati personali sensibili o file di lavoro critici senza backup. Cowork è in "research preview" — è potente ma ancora in fase di sviluppo. Usa sempre cartelle di test o copie dei file!
🚀 Prossimi Passi
Complimenti! Ora sai come creare un orchestratore di agenti AI con Claude Cowork. Ecco come continuare:
📋 Da fare subito:
- Salva il prompt dell'orchestratore in un file
- Prova con un task semplice (es. organizzare una cartella)
- Sperimenta aggiungendo sub-agenti personalizzati
- Crea prompt diversi per diversi tipi di progetto
📚 Approfondisci:
💡 Idee per sub-agenti avanzati:
- Agente Social Media: crea post per Instagram e LinkedIn
- Agente Traduttore: traduce documenti in più lingue
- Agente Email: prepara bozze di email professionali
- Agente SEO: analizza e ottimizza contenuti web