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

Tutti parlano di agenti AI. Ma se chiedi alla maggior parte delle persone cosa sia realmente un agente, ottieni una risposta vaga su "un'IA che fa cose in modo autonomo".

Il quadro reale è più utile 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 separa un'interazione LLM di base 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.

X -

https://x.com/ai_rohitt

Cosa Rende Qualcosa un Agente

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

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

La differenza non è il modello. È la struttura che lo circonda.

Un agente ha tre cose che una chat normale non ha. Strumenti che può richiamare da solo: ricerca, file system, esecuzione di codice, API esterne. Memoria che persiste tra le attività, non solo all'interno di una singola sessione. E un ciclo che continua finché l'attività non è completata, non finché non genera una singola risposta.

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

Lo Spettro: Dalla Chat all'Agente

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

Un gradino sopra: Claude con gli 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. Tu non sei coinvolto tra un passaggio e l'altro.

All'apice: 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 il basso e l'alto non è un modello diverso. È ciò che circonda il modello: strumenti che può richiamare, memoria che trasporta il contesto e un ciclo che continua a funzionare finché l'attività non è completata.

Tipi di Agenti che Puoi Costruire Oggi

Per darti un'idea di come possono essere realmente gli agenti oggi, ho messo insieme alcuni esempi qui sotto. Questi 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. Fornisci 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 modalità pilota automatico una volta definite le regole.

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

Costruire il Tuo Primo Agente - Inizia Qui

Utilizzerai Claude Code per costruire un bot Telegram che viene eseguito su un server remoto e usa Claude come cervello. Claude Code scrive tutto il codice per te; 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 è necessario saper programmare.

Modelli di Prompt di Sistema - Incolla nel Prompt 2

Quando esegui il Prompt 2 dalla configurazione seguente, devi descrivere che tipo di agente desideri. Questi sono modelli già pronti; copia quello che si adatta, incollalo nel Prompt 2 dove dice "L'agente dovrebbe essere:", e Claude Code costruirà quell'agente specifico. Regola 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 ti viene assegnato un compito 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 sostegno e lacune che non hai potuto colmare
9
10Formato: usa intestazioni, 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, nessun linguaggio aziendale
5- Frasi e paragrafi brevi
6- Numeri ed esempi specifici invece di affermazioni vaghe
7- Termina sempre con qualcosa che il lettore dovrebbe fare o a cui pensare
8
9Quando ti viene assegnato un compito di scrittura:
101. Chiedi l'argomento, il pubblico e la lunghezza desiderata se non forniti
112. Scrivi una prima bozza
123. Rivedila in base alle mie regole di stile
134. Fornisci la versione finale pronta per la pubblicazione
14
15Non aggiungere mai introduzioni non necessarie. 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 ti viene assegnato un compito di programmazione:
41. Conferma la tua comprensione di cosa dovrebbe fare il codice
52. Scrivi la soluzione con commenti chiari
63. Identifica eventuali casi limite o potenziali errori
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 in linguaggio semplice cosa fa ogni sezione principale
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- Nessuna formalità non necessaria
6- Vai al punto nella prima frase
7- Chiudi con un chiaro passo successivo
8
9Quando ti viene assegnato un compito di email:
101. Identifica l'obiettivo dell'email (informare, richiedere, follow-up, confermare)
112. Scrivi un oggetto che rifletta lo scopo dell'email
123. Scrivi l'email in un massimo di 3-5 paragrafi brevi
134. Termina con un elemento di azione chiaro o un passo successivo
14
15Scrivi sempre email pronte per l'invio, 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, a dare priorità ai compiti e a pianificare la mia settimana.
2
3Quando condivido i miei compiti o obiettivi:
41. Identifica cosa è urgente rispetto a cosa è importante
52. Suggerisci una sequenza realistica basata sulle dipendenze
63. Stima il tempo richiesto per ogni compito
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. Nessun riempitivo motivazionale. 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 mensile fissa. 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, 1 GB di RAM e 20 GB 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 che hai 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 è fondamentale.

Costruire il Tuo Primo Agente - Passo 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 usa 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 della conversazione 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 della conversazione per quell'utente
11
12Crea tutti i file necessari: file principale del bot, requirements.txt e un modello di file .env per le chiavi API.
13Non hardcodare 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'avvio 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 terminali esatti per installare il servizio, avviarlo, verificare se è in esecuzione e visualizzare i log.

Aggiungi memoria persistente tra le sessioni

1Il bot perde la cronologia della conversazione quando si riavvia. Risolvi questo problema.
2
3Salva la cronologia della conversazione 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 dalla 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 dalla 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: Limitare 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 ulteriori messaggi di quell'utente.
5
6Aggiungi anche come posso trovare il mio ID utente Telegram — tramite il bot stesso o un altro metodo.

**Competenza: Tracciare i 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 il tracciamento di base dei costi al bot.
2
3Dopo ogni risposta dell'API Claude, registra il numero di token di input e token di output utilizzati.
4Mantieni un totale corrente 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 chiedere.

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 massima priorità per la giornata
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 principale del bot, trova la variabile del prompt di sistema in alto, modificala, 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 è dove 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 funzionalità X al bot." Claude Code legge il tuo codice esistente, aggiunge la nuova funzionalità 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 a 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 accadere. 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 riepilogo e continuare da lì. Il thread rimane intatto.

Aggiungi i fatti chiave di cui il tuo agente ha sempre bisogno direttamente al prompt di sistema nel codice del tuo bot. Claude legge questo all'inizio di ogni conversazione, quindi quelle informazioni sono sempre nel contesto, non importa quanto le cose si allunghino.

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 accadere dopo]
7
8Questa nota verrà utilizzata per riprendere l'attività in una nuova sessione senza perdere il contesto.

Prompt di Recupero del 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 tutte le domande necessarie per continuare
9
10Non ripetere il lavoro che è già stato completato.

Prompt di Riepilogo Continuo

1La conversazione si sta allungando. 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 accadere
7
8Dopo aver scritto il riepilogo, continua da lì. Considera questo riepilogo come il nuovo punto di partenza.

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

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

X - https://x.com/ai_rohitt