Agenti AI: cosa sono e come crearne uno passo dopo passo

Tutti parlano di agenti AI. Ma se chiedi a molti cosa sia realmente un agente, ottieni una risposta vaga su "un'AI che agisce in modo autonomo".

La realtà è più interessante di così. Gli agenti non sono una categoria. Sono uno spettro.

Questa guida spiega dove si collocano i diversi strumenti AI su questo spettro, cosa distingue una semplice interazione con un LLM da un vero flusso di lavoro agentico e come costruire il tuo agente con Claude Code e collegarlo a Telegram, senza scrivere codice tu stesso.

Prima di iniziare, seguimi su X e unisciti al mio canale Telegram che ho appena creato, dove pubblico contenuti AI ogni giorno. Entrambi sono gratuiti.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp

Cosa Rende Qualcosa un Agente

Chiedere a Claude "cosa dovrei pubblicare oggi?" non è un agente. È una chat.

Dire a Claude "trova i tre argomenti di tendenza nell'AI ora, scegli quello con il maggior potenziale di coinvolgimento, scrivi un post nel mio stile e salvalo in un file" e fargli fare tutto senza che tu tocchi nulla, quello è un agente.

La differenza non è il modello. È la struttura intorno ad esso.

Un agente ha tre cose che una chat normale non ha. Strumenti che può chiamare autonomamente: ricerca, file system, esecuzione di codice, API esterne. Memoria che persiste tra le attività, non solo all'interno di una sessione. E un ciclo che continua a eseguire fino al completamento dell'attività, non fino a quando genera una risposta.

Più aggiungi di queste tre cose, meno sei coinvolto. Questa è l'idea.

Lo Spettro: Dalla Chat all'Agente

A un'estremità c'è una chat base. Tu chiedi, Claude risponde, la sessione termina. Nessuno strumento, nessun obiettivo continuo, nessuna capacità di agire nel mondo.

Un gradino sopra: Claude con strumenti abilitati. Quando Claude cerca sul web prima di rispondere, legge un file allegato o genera un'immagine, è già leggermente agentico. Non gli hai detto di fare quelle cose passo dopo passo, ha deciso da solo di averne bisogno.

Più in alto: flussi di lavoro multi-step. Dai un obiettivo, Claude lo suddivide in passaggi, esegue ciascuno, controlla il risultato e fornisce un output finale. Non sei coinvolto tra un passaggio e l'altro.

Al vertice: agenti completamente autonomi. L'agente viene eseguito su un programma, monitora gli input, chiama servizi esterni e completa attività complesse senza un umano nel ciclo. Imposti l'obiettivo una volta e controlli l'output.

La differenza tra la base e la cima non è un modello diverso. È ciò che circonda il modello: strumenti che può chiamare, memoria che trasporta il contesto e un ciclo che continua fino al completamento dell'attività.

Tipi di Agenti Che Puoi Costruire Oggi

Per darti un'idea di come possono essere realmente gli agenti oggi, ho preparato alcuni esempi qui sotto. Non sono limiti: puoi costruire qualsiasi cosa si adatti alla tua situazione specifica.

Agente di ricerca: raccoglie informazioni su un argomento, legge più fonti, estrae ciò che conta e fornisce un riepilogo strutturato. Gli fai una domanda. Ti dà una risposta che avrebbe richiesto ore per essere compilata manualmente.

Agente di scrittura: scrive contenuti secondo un sistema che definisci. Gli dai il tuo tono, formato, pubblico e argomento. Gestisce bozze, riscritture e modifiche senza che tu gestisca ogni frase.

Agente di codice: scrive codice, lo esegue, legge gli errori, li corregge e continua. Descrivi cosa dovrebbe fare il codice. L'agente gestisce l'implementazione e il ciclo di debug.

Agente aziendale: gestisce attività aziendali ripetitive: scrivere email, elaborare richieste dei clienti, qualificare lead, generare report. Funziona in pilota automatico una volta definite le regole.

Agente personale: gestisce la tua agenda, organizza le attività, prepara briefing e si occupa del lavoro di pianificazione che fai manualmente ogni giorno.

Costruire il Tuo Primo Agente - Inizia Qui

Utilizzerai Claude Code per creare un bot Telegram che gira su un server remoto e usa Claude come cervello. Claude Code scrive tutto il codice per te: tu descrivi semplicemente cosa vuoi in inglese semplice. Una volta configurato, tutta la comunicazione con il bot avviene direttamente tramite Telegram.

L'intera configurazione richiede circa 10-20 minuti. Non devi saper programmare.

Modelli di System Prompt - Incolla nel Prompt 2

Quando esegui il Prompt 2 dalla configurazione qui sotto, devi descrivere che tipo di agente vuoi. Questi sono modelli già pronti: copia quello che fa per te, incollalo nel Prompt 2 dove dice "L'agente dovrebbe essere:" e Claude Code costruirà quell'agente specifico. Modifica eventuali dettagli per adattarli alla tua situazione.

Agente di Ricerca

1Sei un agente di ricerca. Il tuo compito è raccogliere, analizzare e sintetizzare informazioni su qualsiasi argomento ti venga dato.
2
3Quando ricevi un'attività di ricerca:
41. Identifica le 3-5 sotto-domande più importanti a cui rispondere
52. Cerca informazioni su ciascuna
63. Valuta la qualità e la pertinenza di ogni fonte
74. Estrai solo ciò che risponde direttamente alla domanda
85. Fornisci un riepilogo strutturato con: risultati chiave, prove a supporto e lacune che non hai potuto colmare
9
10Formato: usa titoli, elenchi puntati e sezioni chiare.
11Se non sei sicuro di qualcosa, dillo esplicitamente.
12Non aggiungere riempitivi. Ogni frase deve contenere informazioni.

Agente di Scrittura

1Sei un agente di scrittura. Scrivi contenuti con la mia voce e il mio stile.
2
3Il mio stile:
4- Conversazionale, diretto, niente linguaggio aziendale
5- Frasi e paragrafi brevi
6- Numeri ed esempi specifici invece di affermazioni vaghe
7- Finisci sempre con qualcosa che il lettore dovrebbe fare o a cui pensare
8
9Quando ricevi un'attività di scrittura:
101. Chiedi l'argomento, il pubblico e la lunghezza desiderata se non forniti
112. Scrivi una prima bozza
123. Rivedila rispetto alle mie regole di stile
134. Fornisci la versione finale pronta per la pubblicazione
14
15Non aggiungere introduzioni inutili. Inizia con il punto più importante.

Agente di Codice

1Sei un agente di codice. Il tuo compito è scrivere, eseguire il debug e migliorare il codice.
2
3Quando ricevi un'attività di codifica:
41. Conferma la tua comprensione di ciò che il codice dovrebbe fare
52. Scrivi la soluzione con commenti chiari
63. Identifica eventuali casi limite o potenziali fallimenti
74. Se ci sono errori, esegui il debug sistematicamente prima di chiedere aiuto
8
9Regole:
10- Scrivi codice pulito e leggibile con nomi di variabili significativi
11- Includi sempre la gestione degli errori
12- Spiega cosa fa ogni sezione principale in linguaggio semplice
13- Se non sei sicuro dei requisiti, fai una domanda chiarificatrice prima di procedere

Agente di Email Aziendali

1Sei un agente di email aziendali. Scrivi email professionali per mio conto.
2
3Il mio stile di comunicazione:
4- Diretto e rispettoso
5- Niente formalità inutili
6- Vai al punto nella prima frase
7- Chiudi con un chiaro passo successivo
8
9Quando ricevi un'attività di email:
101. Identifica l'obiettivo dell'email (informare, richiedere, follow-up, confermare)
112. Scrivi un oggetto che rifletta lo scopo dell'email
123. Prepara l'email in massimo 3-5 paragrafi brevi
134. Termina con un'azione chiara o un passo successivo
14
15Scrivi sempre email pronte per essere inviate, non modelli con spazi vuoti da riempire.

Agente di Pianificazione Personale

1Sei il mio agente di pianificazione personale. Mi aiuti a organizzare il mio lavoro, dare priorità ai compiti e pianificare la mia settimana.
2
3Quando condivido i miei compiti o obiettivi:
41. Identifica ciò che è urgente vs. importante
52. Suggerisci una sequenza realistica basata sulle dipendenze
63. Stima il tempo richiesto per ogni attività
74. Segnala qualsiasi cosa che potrebbe essere delegata o eliminata
8
9Quando descrivo un progetto:
10- Suddividilo in azioni concrete successive
11- Identifica la singola cosa più importante da fare per prima
12- Crea una semplice checklist che posso seguire
13
14Mantieni tutto pratico. Niente riempitivi motivazionali. Solo il piano.

Cosa ti serve prima di iniziare

1 - una chiave API Claude da console.anthropic.com. Questa è una chiave per sviluppatori, paghi per utilizzo, non una tariffa fissa mensile. Per un bot personale che invia 50 messaggi al giorno, il costo è di $1-5 al mese a seconda del modello scelto.

2 - un token bot Telegram da BotFather.

3 - un VPS con Linux. Per un bot Telegram personale non hai bisogno di nulla di potente: 1 CPU, 1GB RAM e 20GB di spazio di archiviazione sono più che sufficienti. Qualsiasi piano base di DigitalOcean, Hetzner o Vultr funzionerà e costa circa $4-$6 al mese. Una volta ottenuto il server, installa Claude Code eseguendo npm i -g @anthropic-ai/claude-code nel tuo terminale.

Quale modello Claude usare per il tuo bot e quanto costa effettivamente:

Per la maggior parte dei bot personali, Sonnet 4.6 è la scelta giusta: abbastanza potente per qualsiasi attività e conveniente per l'uso quotidiano. Usa Haiku 4.5 se vuoi ridurre al minimo i costi. Opus 4.8 ha senso solo per un agente analitico complesso dove la qualità della risposta è critica.

Costruire il Tuo Primo Agente - Passaggio 1

Apri il terminale del tuo VPS e avvia Claude Code. Incolla questo prompt e lascia che costruisca tutto.

Dai una personalità all'agente

1Costruiscimi un bot Telegram che usi l'API Claude come cervello.
2
3Requisiti:
4- Linguaggio: Python
5- Libreria per Telegram: python-telegram-bot
6- Modello Claude: claude-sonnet-4-6
7- Il bot riceve un messaggio, lo invia all'API Claude e restituisce la risposta di Claude a Telegram
8- Mantieni la cronologia delle conversazioni per utente: ogni utente ha il proprio contesto all'interno della sessione
9- Aggiungi un comando /start che presenta il bot
10- Aggiungi un comando /clear che reimposta la cronologia delle conversazioni per quell'utente
11
12Crea tutti i file necessari: file bot principale, requirements.txt e un modello di file .env per le chiavi API.
13Non codificare alcuna chiave API: leggile dalle variabili d'ambiente.

Distribuisci come servizio in background

1Crea un file di servizio systemd in modo che questo bot venga eseguito automaticamente sul mio VPS Linux e si riavvii se si blocca.
2
3Il servizio dovrebbe:
4- Avviarsi automaticamente all'accensione del server
5- Riavviarsi automaticamente se si blocca
6- Caricare le variabili d'ambiente dal file .env nella cartella del progetto
7- Salvare i log in un file che posso controllare in seguito
8
9Scrivimi anche i comandi esatti del terminale per installare il servizio, avviarlo, verificare se è in esecuzione e visualizzare i log.

Aggiungi memoria persistente tra le sessioni

1Il bot perde la cronologia delle conversazioni quando si riavvia. Risolvi questo problema.
2
3Salva la cronologia delle conversazioni di ogni utente in un file JSON su disco dopo ogni messaggio. Caricala automaticamente quando il bot si avvia.
4
5Aggiungi una lunghezza massima della cronologia: mantieni solo gli ultimi 20 messaggi per utente in modo che la finestra di contesto non diventi mai troppo lunga.

Aggiungere Competenze al Tuo Bot Claude Code

Le competenze sono capacità che aggiungi al tuo bot nel tempo. Ognuna è un nuovo prompt che dai a Claude Code, e lui scrive il codice per farla funzionare. Ecco le più utili.

Competenza: Ricerca web

**Il tuo agente può cercare informazioni in tempo reale invece di rispondere solo a memoria.

1Aggiungi la capacità di ricerca web al bot utilizzando l'API Tavily.
2
3Quando l'utente chiede qualcosa che richiede informazioni aggiornate (notizie, prezzi, eventi recenti), il bot cerca automaticamente sul web e include i risultati nella sua risposta.
4
5Il bot dovrebbe decidere da solo quando cercare e quando rispondere a memoria. Aggiungi TAVILY_API_KEY al modello di file .env.
6
7Usa la funzione di utilizzo degli strumenti di Claude per implementarlo in modo pulito.

Competenza: Salvare note

**Il tuo agente può salvare qualsiasi cosa gli dici in un file: idee, attività, risultati di ricerca, e recuperarli in seguito.

1Aggiungi una funzione di salvataggio note al bot.
2
3Quando l'utente dice "salva questo", "ricorda questo" o "nota:", il bot salva il contenuto in un file notes.txt con un timestamp.
4
5Aggiungi un comando /notes che restituisce le ultime 10 note salvate.
6Aggiungi un comando /clearnotes che elimina tutte le note salvate.

Competenza: Limita solo al tuo account

Per impostazione predefinita, chiunque trovi il tuo bot può usarlo e consumare i tuoi crediti API. Questo lo blocca solo per te.

1Aggiungi una restrizione utente al bot in modo che solo io possa usarlo.
2
3Aggiungi il mio ID utente Telegram al file .env come ALLOWED_USER_ID.
4Se qualcun altro invia un messaggio al bot, risponde con "Questo bot è privato." e ignora tutti gli altri messaggi da quell'utente.
5
6Aggiungi anche un modo per trovare il mio ID utente Telegram: tramite il bot stesso o un altro metodo.

Competenza: Monitoraggio costi API

L'API Claude addebita per token. Questo aggiunge un semplice tracciatore di costi in modo che tu sappia sempre cosa stai spendendo.

1Aggiungi un tracciamento di base dei costi al bot.
2
3Dopo ogni risposta dell'API Claude, registra il numero di token di input e di output utilizzati.
4Mantieni un totale in esecuzione in un file costs.json.
5
6Aggiungi un comando /costs che mostra: token totali utilizzati oggi, token totali utilizzati in assoluto e un costo stimato in USD basato sui prezzi di claude-sonnet-4-6.

Competenza: Briefing giornaliero programmato

**L'agente ti invia un messaggio ogni mattina senza che tu debba chiederlo.

1Aggiungi un briefing giornaliero programmato al bot.
2
3Ogni giorno alle 8:00, il bot mi invia un messaggio con:
41. Una frase motivazionale (breve, non sdolcinata)
52. Un promemoria per controllare la mia priorità principale del giorno
63. Un fatto utile casuale sulla produttività o l'AI
7
8Invialo al mio ID utente Telegram dal file .env.
9Usa la libreria schedule o APScheduler per implementarlo.

Cose Utili da Sapere Dopo la Configurazione

Come aggiornare la personalità del tuo agente. Apri il file bot principale, trova la variabile di sistema prompt in alto, cambiala, salva il file e riavvia il servizio con sudo systemctl restart nome-del-tuo-bot. La nuova personalità è attiva immediatamente.

Come verificare se il bot è in esecuzione. Esegui sudo systemctl status nome-del-tuo-bot nel tuo terminale. Se dice "active (running)" funziona. Se dice "failed" controlla i log.

Come leggere i log. Esegui journalctl -u nome-del-tuo-bot -n 50 per vedere le ultime 50 righe. Qui trovi i messaggi di errore se qualcosa si rompe.

Come aggiungere una nuova competenza. Apri Claude Code nella cartella del tuo progetto e descrivi cosa vuoi: "Aggiungi la funzione X al bot." Claude Code legge il codice esistente, aggiunge la nuova funzione in modo pulito e ti dice se è necessario un riavvio.

Il Problema della Memoria Che Ogni Agente Ha

Questo è il problema più comune che le persone incontrano. L'agente perde il contesto tra le sessioni, durante attività lunghe, dopo troppi messaggi e inizia a commettere errori o ripetere lavoro già fatto.

Ci sono tre modi in cui ciò accade:

Le attività lunghe alla fine superano il limite di contesto di Claude e l'agente inizia a perdere l'inizio della conversazione: l'obiettivo originale, le decisioni già prese, i vincoli che hai impostato.

Quando chiudi una sessione e ne apri una nuova, l'agente ricomincia da zero.

Se l'agente viene interrotto a metà attività, non ha modo di sapere dove si è fermato.

Quattro cose possono risolvere questo problema:

Dì all'agente di scrivere una nota di avanzamento dopo ogni passaggio importante: cosa è stato fatto, cosa è stato deciso, cosa deve ancora succedere. Incolla quella nota all'inizio della sessione successiva per ripristinare il contesto completo.

Ogni dieci-quindici messaggi, chiedi all'agente di riassumere dove si trova. Questo lo costringe a comprimere il contesto prima che trabocchi.

Prima che la conversazione diventi troppo lunga, chiedi all'agente di comprimere tutto in un breve riepilogo e continuare da lì. Il thread rimane intatto.

Aggiungi i fatti chiave di cui il tuo agente ha sempre bisogno direttamente nel system prompt nel codice del tuo bot. Claude legge questo all'inizio di ogni conversazione, quindi quelle informazioni sono sempre nel contesto, indipendentemente da quanto lunga diventi la conversazione.

Prompt di Checkpoint

1Prima di continuare, scrivi un breve checkpoint:
21. Cosa hai completato finora?
32. Quali sono le decisioni o i risultati chiave di questa sessione?
43. Cosa deve ancora essere fatto?
54. Di quale contesto avresti bisogno per continuare questa attività in una nuova sessione?
6
7Mantienilo sotto le 200 parole.

Prompt del File di Memoria

1Dopo aver completato ogni passaggio importante, scrivi una nota di memoria in questo formato:
2
3PASSAGGIO COMPLETATO: [cosa è stato fatto]
4DECISIONI CHIAVE: [scelte fatte e perché]
5STATO ATTUALE: [dove si trova l'attività ora]
6PROSSIMO PASSAGGIO: [cosa dovrebbe succedere dopo]
7
8Questa nota verrà utilizzata per riprendere l'attività in una nuova sessione senza perdere il contesto.

Prompt di Recupero Contesto

1Stiamo riprendendo un'attività da una sessione precedente. Ecco il contesto:
2
3[incolla qui la tua nota di memoria]
4
5Sulla base di questo:
61. Conferma la tua comprensione di dove siamo
72. Identifica il prossimo passaggio
83. Fai le domande necessarie per continuare
9
10Non ripetere il lavoro che è già stato completato.

Prompt di Riepilogo Continuo

1La conversazione sta diventando lunga. Comprimi tutto ciò che è importante in un riepilogo:
2
31. Obiettivo originale
42. Cosa è stato fatto e cosa è stato trovato
53. Decisioni chiave prese
64. Cosa deve ancora succedere
7
8Dopo aver scritto il riepilogo, continua da lì. Tratta questo riepilogo come il nuovo punto di partenza.

Ora sai cosa sono gli agenti, cosa possono fare e come costruirne uno tu stesso. Spero sia stato utile.

Se vuoi rimanere aggiornato su tutto ciò che accade nell'AI, seguimi su X e Telegram.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp