📖 Per iniziare · Capitolo 01

5 concetti fondamentali sull'AI

Prima di utilizzare EasyClaw, dedica 5 minuti a comprendere questi concetti — ti aiuteranno a capire davvero come funziona l'AI, anziché inserire comandi alla cieca.

1. Agent (Entità intelligente)

🗣️

Comprensione comune

L'AI è il tuo assistente digitale o chatbot.

🧠

Comprensione approfondita

Una normale AI risponde direttamente alle domande; un Agent pianifica, utilizza strumenti e verifica i risultati prima di rispondere — come un collega davvero capace.

Ad esempio: se dici "aiutami a organizzare la mia casella di posta", una normale AI ti dice solo come farlo; l'Agent di EasyClaw apre direttamente il client email → classifica e archivia → risponde alle email importanti → segnala il completamento.

2. Skills (Competenze)

🗣️

Comprensione comune

Le funzionalità AI sono strumenti o app avanzati di vario tipo.

🧩

Comprensione approfondita

Le Skills sono manuali operativi professionali già pronti. Una volta installate, l'Agent sa come chiamare correttamente l'API di Lark, generare immagini, riconoscere targhe... senza dover indovinare.

Pensa a una Skill come a delle "istruzioni per l'AI": con essa, l'AI padroneggia le specifiche operative complete di un determinato dominio. Marketplace delle Skills: clawhub.com

💡
Come funzionano le Skills?
Quando invii un'attività, l'Agent analizza le descrizioni di tutte le Skills installate, carica le specifiche operative corrispondenti dopo la corrispondenza e guida ogni successivo passo di esecuzione.

3. Prompt (Istruzioni)

🗣️

Comprensione comune

È una "richiesta in una frase" che dai all'AI in linguaggio naturale.

🎯

Comprensione approfondita

Il Prompt è l'interfaccia principale per comunicare con l'AI. Un buon Prompt include: definizione del ruolo, informazioni contestuali, requisiti specifici per ogni passaggio e formato di output.

TipoEsempioEffetto
❌ Prompt generico"Aiutami a scrivere un'email"L'AI può solo intuire, qualità dell'output scarsa
✅ Prompt efficace"Sei un commerciale B2B, aiutami a scrivere un'email di follow-up su un prodotto a un CTO, tono professionale e conciso, con una chiara azione successiva alla fine"Ruolo + contesto + formato, output preciso

4. Memory / MEMORY.md

🗣️

Comprensione comune

Il "blocco note" dell'AI.

🗄️

Comprensione approfondita

La Memory è il nucleo della memoria a lungo termine dell'Agent. Le conversazioni normali vengono cancellate al termine; ma i contenuti scritti in MEMORY.md saranno prioritariamente letti dall'Agent ad ogni avvio — ricorda in modo permanente le tue preferenze e i tuoi SOP di lavoro.

Ad esempio, se dici all'Agent "preferisco risposte concise in italiano, codice in Python", dopo che questa informazione entra in MEMORY.md, l'Agent la seguirà automaticamente ogni volta senza che tu debba ripeterla.

Consiglio pratico
Comunica all'Agent "una volta sola" le tue abitudini di lavoro, i formati più usati, i contatti importanti — lascia che le scriva in memoria, e il tuo assistente AI ti capiranno sempre meglio nel tempo.

5. Soul / SOUL.md

🗣️

Comprensione comune

Le "impostazioni di personalità" dell'AI.

Comprensione approfondita

SOUL.md definisce le regole di comportamento, i valori e i limiti operativi dell'Agent. È la costituzione fondamentale dell'Agent — cosa si può fare, cosa non si può assolutamente fare, tutto è scritto qui.

Se Memory è "cosa ricordare", allora Soul sono le "regole di chi essere". Ad esempio: rispondere solo a domande relative al prodotto, le operazioni finanziarie devono essere confermate due volte, è vietato richiedere password...

⚠️
Nota per utenti avanzati
Le impostazioni di SOUL.md influenzano direttamente i limiti di sicurezza dell'Agent. Se intendi distribuire EasyClaw come strumento per il team, assicurati di configurare questo file con attenzione.

Concetti avanzati (facoltativi)

I tre concetti seguenti sono rivolti agli utenti avanzati che vogliono personalizzare EasyClaw in profondità. I principianti possono saltarli e tornare quando necessario.

🔀

Workflow (Automazione dei processi)

Collega più attività Agent in sequenza logica per formare una pipeline di automazione ripetibile. Esempio: "Ricevi email → Estrai informazioni chiave → Genera riepilogo → Invia notifica Lark" è un tipico Workflow.

📦

JSON (Formato di scambio dati)

Formato standard per il trasferimento dati tra l'Agent e strumenti/API esterni. Quando chiedi all'Agent di chiamare servizi di terze parti (come meteo, calendario, database), i dati di solito transitano in formato JSON. Non è necessario scriverlo manualmente, ma comprenderne la struttura aiuta nella risoluzione dei problemi.

🔑

API Key (Credenziale di accesso)

Credenziale di identità per accedere ai modelli AI o a servizi di terze parti. EasyClaw utilizza per impostazione predefinita il sistema di crediti ufficiale, senza necessità di una propria Key; gli utenti avanzati possono inserire la propria API Key in "Aggiungi modello personalizzato" per accedere ai modelli specificati.

💡
Quando è necessario occuparsene?
Quando vuoi creare processi di automazione complessi a più passaggi (Workflow), accedere con la tua API Key per risparmiare sui costi, o hai bisogno di risolvere problemi di trasferimento dati tra l'Agent e strumenti esterni (JSON), questi tre concetti diventano molto utili.
🎉
Riferimento rapido ai concetti
Agent = Collega AI con potere esecutivo | Skills = Plugin di competenze professionali | Prompt = Metodo di comunicazione di alta qualità | Memory = Archivio di memoria a lungo termine | Soul = Costituzione comportamentale