Vai al contenuto

Appendici

AGlossario

Tutte le parole chiave del corso, in ordine alfabetico, con il capitolo in cui sono spiegate.

.gitignore
File di testo con l'elenco dei file che Git non deve salvare né pubblicare. Ci si scrive .env perché le chiavi non finiscano online per sbaglio. Spiegato in 7. Scegliere il modello: online o sul tuo computer.
Agent (in CrewAI)
Il membro della squadra. Si definisce con tre testi obbligatori — role, goal, backstory — più modello e strumenti opzionali. Spiegato in 4. Cos'è CrewAI.
Agente AI
Programma che usa un LLM per decidere da solo i passi da fare verso un obiettivo: ragiona, usa strumenti, osserva il risultato e riprova finché ha finito. Spiegato in 3. Dal chatbot all'agente.
AI Act
Il regolamento (UE) 2024/1689 sull'intelligenza artificiale: classifica i sistemi di IA per livello di rischio e fissa obblighi per chi li produce e per chi li usa. Spiegato in 28. Esempio 10 · Selezione del personale.
Allucinazione
Quando un modello scrive con sicurezza una cosa falsa o inventata. Succede perché il modello genera testo plausibile, non verifica fatti. Spiegato in 2. Cos'è un LLM, in parole semplici.
Ambiente virtuale
Una copia isolata di Python dedicata a un progetto, con i suoi pacchetti. Evita che progetti diversi si pestino i piedi. uv lo crea da solo. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
API
Application Programming Interface: una "porta" con regole precise attraverso cui un programma chiede un servizio a un altro. I modelli online si usano via API. Spiegato in 2. Cos'è un LLM, in parole semplici.
backstory
La storia e lo stile dell'agente: esperienza, valori, modo di lavorare. È il suo "carattere" nel prompt. Spiegato in 9. Gli agenti: role, goal, backstory.
Bias (pregiudizio)
Una distorsione sistematica: un modello che ha imparato da dati sbilanciati può favorire o penalizzare alcuni gruppi di persone senza che nessuno lo abbia chiesto. Spiegato in 28. Esempio 10 · Selezione del personale.
Cartella di progetto
La cartella del computer che contiene tutti i file di un tuo lavoro. I comandi si lanciano stando "dentro" questa cartella. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
Chatbot
Programma con cui si conversa per messaggi. Risponde, ma di norma non agisce da solo nel mondo esterno. Spiegato in 2. Cos'è un LLM, in parole semplici.
Chiave API
Una lunga password personale che identifica chi usa un'API e a chi addebitare i costi. Va tenuta segreta: mai pubblicarla o condividerla. Spiegato in 7. Scegliere il modello: online o sul tuo computer.
Chunk
Un pezzo di documento. Prima di calcolare gli embedding, la knowledge divide i file lunghi in pezzi, così a ogni domanda si recuperano solo le parti utili. Spiegato in 15. Memoria e knowledge.
Classe e oggetto
Una classe è uno stampo (per esempio Agent); un oggetto è una cosa concreta creata con quello stampo (il tuo agente ricercatore). Spiegato in 8. Il tuo primo crew.
CLI
Command Line Interface: un programma che si usa dal terminale con comandi. CrewAI ne ha una: crewai create, crewai run… Spiegato in 6. Installare CrewAI passo passo.
Comando
Un'istruzione scritta nel terminale, seguita da Invio. Esempio: crewai run. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
Commento (nel codice)
Una nota per chi legge il codice, che il computer ignora. In Python inizia con # e arriva fino alla fine della riga. Spiegato in 8. Il tuo primo crew.
context (di un task)
L'elenco di task precedenti il cui risultato viene passato a questo task. Serve quando un task deve leggere il lavoro di uno specifico altro task. Spiegato in 10. I task: descrivere il lavoro e il risultato.
Crew
La squadra: un insieme di agenti e di task, più la regola con cui i task vengono eseguiti (il process). Si avvia con kickoff(). Spiegato in 4. Cos'è CrewAI.
CrewAI
Framework open source in Python per costruire squadre di agenti AI che collaborano. Creato da João Moura, sviluppato da CrewAI Inc. Spiegato in 1. Come funziona questo corso.
CrewAI AMP
Agent Management Platform: la piattaforma commerciale di CrewAI Inc. per pubblicare, monitorare e scalare crew e flow. Il framework resta gratuito anche senza AMP. Spiegato in 4. Cos'è CrewAI.
CrewOutput
L'oggetto restituito da crew.kickoff(): contiene il testo finale (raw), l'eventuale output strutturato, i risultati dei singoli task e i token usati. Spiegato in 8. Il tuo primo crew.
CSV
File di tabella in testo semplice: una riga per record, valori separati da virgole. Si apre con Excel o Fogli Google. Spiegato in 26. Esempio 8 · Analisi di dati.
Database vettoriale
Archivio specializzato che conserva embedding e trova velocemente quelli più simili a una domanda. CrewAI usa ChromaDB e LanceDB. Spiegato in 15. Memoria e knowledge.
Decoratore
Una riga che inizia con @ sopra una funzione e le aggiunge un comportamento. In CrewAI: @agent, @task, @start, @listen. Spiegato in 12. Gli strumenti: dare le mani agli agenti.
Delega
La possibilità, per un agente con allow_delegation=True, di chiedere aiuto o passare un pezzo di lavoro a un collega della crew. Spiegato in 9. Gli agenti: role, goal, backstory.
Dipendenza
Un pacchetto di cui il tuo progetto ha bisogno per funzionare. Le dipendenze si elencano in pyproject.toml o in testa allo script. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
Dizionario
Una raccolta di coppie nome → valore tra parentesi graffe: {"citta": "Arezzo"}. Spiegato in 8. Il tuo primo crew.
Editor di codice
Programma per scrivere e modificare file di codice, con colori e suggerimenti. Il più usato e gratuito è Visual Studio Code. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
Embedder
Il modello che trasforma un testo in embedding. Per la knowledge CrewAI usa di serie quello di OpenAI; con Ollama puoi usarne uno locale, per esempio nomic-embed-text. Documenti e domande devono passare dallo stesso embedder. Spiegato in 15. Memoria e knowledge.
Embedding
Una lista di numeri che rappresenta il significato di un testo. Testi con significato simile hanno numeri vicini: così si trovano i pezzi di documento pertinenti a una domanda. Spiegato in 15. Memoria e knowledge.
Escalation
Il passaggio di una richiesta a un livello superiore, di solito a una persona, quando il sistema automatico non deve o non sa gestirla da solo. Spiegato in 22. Esempio 4 · Assistenza clienti.
Esecuzione asincrona
Far partire un lavoro senza aspettare che finisca prima di passare al successivo. In CrewAI un task con async_execution=True lavora mentre la crew prosegue. Spiegato in 10. I task: descrivere il lavoro e il risultato.
expected_output
La descrizione del risultato atteso di un task: formato, lunghezza, struttura. È il criterio con cui l'agente capisce di aver finito. Spiegato in 10. I task: descrivere il lavoro e il risultato.
File .env
File di testo nella cartella del progetto con le variabili d'ambiente, una per riga: NOME=valore. Non va mai condiviso né caricato online. Spiegato in 7. Scegliere il modello: online o sul tuo computer.
Finestra di contesto
Quanti token un modello riesce a considerare tutti insieme in una volta (prompt + risposta). Oltre quel limite, il testo più vecchio va tagliato o riassunto. Spiegato in 2. Cos'è un LLM, in parole semplici.
Flow
Il "copione" che orchestra passi, crew e agenti con uno stato condiviso, condizioni e diramazioni. La documentazione lo consiglia come struttura per le applicazioni vere. Spiegato in 4. Cos'è CrewAI.
Framework
Una base di codice già pronta che fissa una struttura e ti evita di riscrivere le parti comuni. Tu riempi i pezzi specifici del tuo problema. Spiegato in 4. Cos'è CrewAI.
Funzione
Un blocco di codice con un nome che fa un lavoro e restituisce un risultato. Si definisce con def e si chiama con le parentesi: somma(2, 3). Spiegato in 12. Gli strumenti: dare le mani agli agenti.
GDPR
Il Regolamento generale sulla protezione dei dati (Regolamento UE 2016/679): le regole europee su come si raccolgono, usano e conservano i dati personali. Spiegato in 17. Errori comuni, costi e sicurezza.
goal
L'obiettivo personale dell'agente, con il criterio di qualità: "Trovare i 5 rischi principali con le fonti". Spiegato in 9. Gli agenti: role, goal, backstory.
Guardrail
Un controllo automatico sul risultato di un task. Se il controllo fallisce, l'errore torna all'agente che riprova. Spiegato in 13. Risultati strutturati e guardrail.
Hashtag
Una parola preceduta da # (per esempio #Bologna) che sui social raggruppa i contenuti sullo stesso tema. Spiegato in 27. Esempio 9 · Marketing e social.
Human in the loop
Un punto del processo in cui una persona controlla o approva prima che il lavoro prosegua. In CrewAI: human_input=True o @human_feedback. Spiegato in 3. Dal chatbot all'agente.
IA generativa
Tipo di intelligenza artificiale che produce contenuti nuovi (testo, immagini, codice) invece di limitarsi a classificare quelli esistenti. Spiegato in 1. Come funziona questo corso.
Import
La riga from ... import ... che rende disponibili in un file Python le parti di una libreria, per esempio Agent e Task di CrewAI. Spiegato in 8. Il tuo primo crew.
Indice di bilancio
Un rapporto tra due voci del bilancio, per esempio utile diviso patrimonio, che riassume in un numero la redditività, la liquidità o i debiti di un'azienda. Spiegato in 24. Esempio 6 · Analisi finanziaria.
Intelligenza artificiale (IA)
Programmi che svolgono compiti per cui di solito serve l'intelligenza umana: capire testo, riconoscere immagini, prendere decisioni. Spiegato in 1. Come funziona questo corso.
JSON
Formato di testo per dati strutturati con graffe, virgolette e due punti. È il formato predefinito dei nuovi progetti CrewAI (crew.jsonc). Spiegato in 13. Risultati strutturati e guardrail.
kickoff()
Il metodo che fa partire il lavoro di una crew, di un agente o di un flow. Il nome viene dal calcio d'inizio. Spiegato in 8. Il tuo primo crew.
Knowledge
Documenti tuoi (PDF, testi, CSV…) messi a disposizione degli agenti come fonte da consultare. Ancora le risposte ai tuoi dati. Spiegato in 15. Memoria e knowledge.
Lead
Nel marketing e nelle vendite, un potenziale cliente di cui si hanno almeno i dati di contatto e un segnale di interesse. Spiegato in 25. Esempio 7 · Vendite: qualificare i lead.
Libreria (pacchetto)
Codice scritto da altri che installi e riusi nei tuoi programmi. CrewAI si installa come pacchetto Python. Spiegato in 4. Cos'è CrewAI.
Lista
Una sequenza ordinata di valori tra parentesi quadre: [ricercatore, scrittore]. Spiegato in 8. Il tuo primo crew.
LLM
Large Language Model, grande modello linguistico: un programma addestrato su enormi quantità di testo che, data una frase, prevede le parole che seguono. È il motore di ChatGPT, Claude, Gemini. Spiegato in 2. Cos'è un LLM, in parole semplici.
Manager (processo gerarchico)
L'agente capo della crew gerarchica: non esegue i task di persona, li affida ai colleghi con la delega e controlla i risultati. CrewAI lo crea da solo a partire da manager_llm. Spiegato in 11. La crew e i processi.
Markdown
Un modo semplice di formattare il testo con simboli: # per i titoli, ** per il grassetto, - per gli elenchi. I file Markdown finiscono in .md. Spiegato in 10. I task: descrivere il lavoro e il risultato.
max_iter
Numero massimo di giri di ragionamento che un agente può fare su un task prima di dare la risposta migliore che ha. In CrewAI 1.15 il valore predefinito è 25. Spiegato in 9. Gli agenti: role, goal, backstory.
MCP
Model Context Protocol: standard aperto per collegare agenti a servizi esterni (calendari, database, GitHub…) tramite "server MCP" già pronti. Spiegato in 12. Gli strumenti: dare le mani agli agenti.
Memoria
La capacità della crew di ricordare informazioni tra un passo e l'altro e tra esecuzioni diverse. Si attiva con memory=True. Spiegato in 15. Memoria e knowledge.
Metodo
Un'azione che un oggetto sa fare, chiamata con il punto e le parentesi: crew.kickoff() chiede all'oggetto crew di partire. Spiegato in 8. Il tuo primo crew.
Modello
Il file (o il servizio online) che contiene un LLM già addestrato. Ogni modello ha un nome, per esempio gpt-4o o qwen2.5:7b. Spiegato in 2. Cos'è un LLM, in parole semplici.
Modello locale
Un modello che gira sul tuo computer invece che sui server di un'azienda. Privacy e costo zero, ma di solito più lento e meno capace. Spiegato in 7. Scegliere il modello: online o sul tuo computer.
Normalizzare
Riportare numeri con scale diverse su una scala comune, per esempio da 0 a 1 dividendo ogni valore per il più grande. Così si possono sommare misure che altrimenti non sarebbero confrontabili. Spiegato in 18. Come abbiamo scelto e ordinato gli esempi.
Ollama
Programma gratuito che scarica ed esegue modelli linguistici sul tuo computer, senza chiavi e senza costi a consumo. Spiegato in 7. Scegliere il modello: online o sul tuo computer.
Open source
Software il cui codice è pubblico e riutilizzabile secondo una licenza. CrewAI usa la licenza MIT, molto permissiva. Spiegato in 4. Cos'è CrewAI.
Output strutturato
Un risultato con campi fissi (titolo, lista, numero…) invece di testo libero, così un programma può usarlo senza interpretarlo. In CrewAI: output_pydantic. Spiegato in 13. Risultati strutturati e guardrail.
Parametro
Un valore che passi a una funzione o a una classe tra parentesi, con un nome: Agent(role="...") — qui role è il parametro. Spiegato in 8. Il tuo primo crew.
PATH
La variabile d'ambiente con l'elenco delle cartelle in cui il terminale cerca i programmi. Se la cartella di un programma non è nel PATH, il terminale risponde che il comando non esiste. Spiegato in 6. Installare CrewAI passo passo.
planning
Opzione della crew (planning=True) che, prima di iniziare, fa scrivere a un agente pianificatore un piano passo passo per ogni task e lo aggiunge alla descrizione del task. Spiegato in 11. La crew e i processi.
Process
La regola con cui la crew esegue i task: sequential (uno dopo l'altro) oppure hierarchical (un manager decide chi fa cosa). Spiegato in 4. Cos'è CrewAI.
Processo gerarchico
Un agente manager riceve i task, li assegna ai membri più adatti e controlla i risultati. Richiede manager_llm o manager_agent. Spiegato in 11. La crew e i processi.
Processo sequenziale
I task si eseguono nell'ordine in cui li scrivi; il risultato di ciascuno passa come contesto ai successivi. È il processo predefinito. Spiegato in 11. La crew e i processi.
Prompt
Il testo che dai in ingresso a un modello: domanda, istruzioni, esempi. La qualità della risposta dipende molto dalla chiarezza del prompt. Spiegato in 2. Cos'è un LLM, in parole semplici.
Prompt injection
Un testo inserito nei dati (una pagina web, un commento nel codice, un'email) scritto per sembrare un'istruzione e far fare al modello qualcosa che non gli hai chiesto. Spiegato in 17. Errori comuni, costi e sicurezza.
Provider
L'azienda o il servizio che offre il modello: OpenAI, Anthropic, Google, oppure Ollama sul tuo computer. In CrewAI si scrive come prefisso: openai/gpt-4o. Spiegato in 2. Cos'è un LLM, in parole semplici.
Pydantic
Libreria Python per descrivere la forma dei dati (campi e tipi) e controllarla. CrewAI la usa per ottenere risposte strutturate e verificate. Spiegato in 13. Risultati strutturati e guardrail.
Python
Linguaggio di programmazione molto diffuso, leggibile e usatissimo nell'intelligenza artificiale. CrewAI è scritto in Python e si usa da Python. Spiegato in 4. Cos'è CrewAI.
RAG
Retrieval-Augmented Generation: prima si recuperano i pezzi di documento pertinenti, poi si danno al modello insieme alla domanda. Riduce le allucinazioni sui tuoi dati. Spiegato in 15. Memoria e knowledge.
Rate limit
Il limite di richieste al minuto imposto da un provider. Superarlo dà errori temporanei. In CrewAI si rispetta con max_rpm. Spiegato in 7. Scegliere il modello: online o sul tuo computer.
role
Il ruolo dell'agente, cioè il suo mestiere: "Analista finanziario senior". Orienta il modo in cui il modello ragiona. Spiegato in 9. Gli agenti: role, goal, backstory.
Router
Un passo di un flow che sceglie la strada successiva restituendo un'etichetta, per esempio "approvato" o "da_rivedere". Spiegato in 16. I flow: passi, condizioni e persone.
Sandbox
Un ambiente isolato e usa e getta in cui eseguire codice di cui non ti fidi: se il codice fa danni, li fa lì dentro e non sul tuo computer. Spiegato in 23. Esempio 5 · Revisione del codice.
Script
Un file di codice che si esegue dall'inizio alla fine con un solo comando, per esempio uv run primo_crew.py. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
Segnaposto {…}
Una parola tra graffe, come {citta}, dentro i testi di agenti e task. Al kickoff(inputs={...}) viene sostituita con il valore vero. Spiegato in 8. Il tuo primo crew.
SEO
Search Engine Optimization: l'insieme di accorgimenti per far comparire un sito o un contenuto più in alto nei risultati dei motori di ricerca. Spiegato in 27. Esempio 9 · Marketing e social.
Serper
Servizio online (serper.dev) che restituisce i risultati di ricerca di Google a un programma. Lo usa SerperDevTool; serve la chiave SERPER_API_KEY. Spiegato in 12. Gli strumenti: dare le mani agli agenti.
Sistema multi-agente
Più agenti, ognuno con un ruolo specifico, che collaborano su un lavoro passandosi i risultati. Spiegato in 3. Dal chatbot all'agente.
SQL
Structured Query Language: il linguaggio con cui si fanno domande a un database, per esempio SELECT SUM(incasso) FROM vendite. Spiegato in 26. Esempio 8 · Analisi di dati.
Stato (di un flow)
I dati che un flow porta con sé da un passo all'altro, per esempio l'argomento scelto e la bozza scritta. Si leggono e scrivono con self.state. Spiegato in 16. I flow: passi, condizioni e persone.
Stringa
Un testo nel codice, scritto tra virgolette: "Ricercatore". Spiegato in 8. Il tuo primo crew.
Strumento (tool)
Una funzione che l'agente può chiamare per agire fuori dal modello: cercare sul web, leggere un file, interrogare un database, inviare una email. Spiegato in 3. Dal chatbot all'agente.
Task
Un compito preciso da assegnare a un agente. Ha due testi obbligatori: description (cosa fare) ed expected_output (come deve essere il risultato). Spiegato in 4. Cos'è CrewAI.
Telemetria
Dati anonimi di utilizzo che un programma invia ai suoi sviluppatori. In CrewAI si disattiva con CREWAI_DISABLE_TELEMETRY=true. Spiegato in 6. Installare CrewAI passo passo.
Terminale
Finestra in cui si scrivono comandi testuali al computer invece di cliccare. Su Windows si chiama PowerShell o Prompt dei comandi, su macOS e Linux Terminale. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
Text-to-SQL
Tecnica in cui un modello traduce una domanda scritta in italiano in una query SQL, che poi un programma esegue sul database. Spiegato in 26. Esempio 8 · Analisi di dati.
Ticket
Una richiesta di assistenza registrata con un numero: l'email o il messaggio di un cliente che qualcuno deve prendere in carico e chiudere. Spiegato in 22. Esempio 4 · Assistenza clienti.
Token
Il pezzetto di testo con cui ragiona un modello: una parola corta, un pezzo di parola o un segno di punteggiatura. Secondo le stime di OpenAI, in inglese un token vale in media circa ¾ di parola. I servizi a pagamento contano (e fanno pagare) i token. Spiegato in 2. Cos'è un LLM, in parole semplici.
Trace
La registrazione dettagliata di un'esecuzione: ogni decisione, chiamata al modello e uso di strumenti, con tempi e token. Serve a capire cosa è successo. Spiegato in 17. Errori comuni, costi e sicurezza.
Traceback
Il messaggio che Python stampa quando un programma si ferma per un errore: elenca i file e le righe attraversati e, nell'ultima riga, il tipo di errore con la sua spiegazione. Spiegato in 17. Errori comuni, costi e sicurezza.
uv
Programma gratuito che installa Python e i pacchetti in modo rapido e ordinato. È lo strumento consigliato dalla documentazione di CrewAI. Spiegato in 5. Gli attrezzi: terminale, Python, uv, editor.
Variabile
Un nome che conserva un valore nel programma: citta = "Arezzo" mette il testo Arezzo nella variabile citta. Spiegato in 8. Il tuo primo crew.
Variabile d'ambiente
Un valore con un nome (per esempio OPENAI_API_KEY) che i programmi leggono dal sistema invece che dal codice. Serve a tenere i segreti fuori dai file di codice. Spiegato in 7. Scegliere il modello: online o sul tuo computer.
verbose
Opzione che fa stampare nel terminale ogni passaggio di agenti e task. Utile mentre impari e quando qualcosa non va. Spiegato in 8. Il tuo primo crew.
Web scraping
Leggere automaticamente il contenuto di una pagina web da un programma. In CrewAI: ScrapeWebsiteTool. Spiegato in 12. Gli strumenti: dare le mani agli agenti.
YAML
Formato di file di testo per scrivere configurazioni in modo leggibile, con rientri e coppie chiave: valore. Nei progetti CrewAI classici descrive agenti e task. Spiegato in 14. Il progetto ufficiale: crewai create e crewai run.

Corso indipendente, non affiliato a CrewAI Inc. Contenuti verificati su CrewAI 1.15.21 il 15 settembre 2026.