Appendici
BFonti e prossimi passi
Tutte le fonti usate per scrivere il corso, divise per argomento, con a cosa ti servono e la data di verifica. Poi i passi per continuare: flow in produzione, CrewAI AMP, la community e come restare aggiornato.
Questo corso non inventa nulla: ogni comando, parametro e numero viene da una fonte che puoi aprire anche tu. Qui le trovi tutte, raggruppate per argomento, con una riga che dice quando ti conviene aprirle. È anche la tua cassetta degli attrezzi per il dopo: CrewAI cambia spesso, e le fonti ufficiali sono l'unico modo sicuro per stare al passo.
Tutti i link sono stati controllati il 15 settembre 2026, con CrewAI 1.15.21, la versione più recente pubblicata su PyPI in quella data. Il codice degli esempi è stato provato con quella versione in un ambiente di laboratorio. Se leggi il corso molto dopo, alcune pagine potrebbero essere cambiate: la documentazione ufficiale vale più di questo corso.
La documentazione ufficiale di CrewAI#
La documentazione sta su docs.crewai.com ed è in inglese. Se l'inglese ti mette in difficoltà, il traduttore del browser funziona bene su queste pagine; i nomi di parametri e comandi però non vanno tradotti. Il sito a volte mostra una pagina di controllo anti-robot prima del contenuto: basta attendere qualche secondo.
Per cominciare#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| Introduction | Il quadro generale: crew, flow e perché la documentazione consiglia di partire da un flow per le applicazioni vere (capitolo 4). | 15/09/2026 |
| Installation | Requisiti di Python, installazione con uv, struttura dei progetti generati, problemi noti su Windows (capitoli 5 e 6). | 15/09/2026 |
| Quickstart | Il primo progetto ufficiale, costruito come flow con una crew dentro (capitolo 14). | 15/09/2026 |
| llms.txt | L'indice di tutte le pagine della documentazione, versione per versione: utile per trovare la pagina giusta o la versione che corrisponde alla tua installazione. | 15/09/2026 |
I mattoni#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| Agents | Tutti i parametri di un agente, i valori predefiniti e l'uso di un agente da solo con kickoff (capitolo 9). | 15/09/2026 |
| Tasks | Descrizione, risultato atteso, context, output strutturato, guardrail, file di uscita (capitoli 10 e 13). | 15/09/2026 |
| Crews | I parametri della crew, i modi di avviarla e l'oggetto CrewOutput (capitoli 8 e 11). | 15/09/2026 |
| Processes | Differenza tra processo sequenziale e gerarchico (capitolo 11). | 15/09/2026 |
| Hierarchical process | Come impostare il manager, con manager_llm o con un agente scritto da te (capitolo 11, esempio 9). | 15/09/2026 |
| LLMs | Come scrivere il nome del modello, quali provider sono integrati e quali richiedono pacchetti in più (capitolo 7). | 15/09/2026 |
| LLM connections | Esempi di collegamento a provider diversi, compreso Ollama (capitolo 7). | 15/09/2026 |
Strumenti#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| Tools | Come funzionano gli strumenti, la cache, gli errori degli strumenti (capitolo 12). | 15/09/2026 |
| Create custom tools | Scrivere strumenti propri con @tool o BaseTool (capitolo 12, esempio 8). | 15/09/2026 |
| Tools overview | Il catalogo degli strumenti pronti. Attenzione: elenca ancora CodeInterpreterTool, che nella versione 1.15.21 non esiste più. | 15/09/2026 |
| MCP overview | Collegare agli agenti i server MCP già pronti (capitolo 12). | 15/09/2026 |
Memoria, flow e persone nel processo#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| Memory | La memoria unificata, i valori predefiniti e come usarla con modelli locali (capitolo 15). | 15/09/2026 |
| Knowledge | Collegare documenti agli agenti, dove vengono salvati, come cambiare l'embedder (capitolo 15). | 15/09/2026 |
| Flows | Stato, @start, @listen, @router, persistenza (capitolo 16). | 15/09/2026 |
| Human input on execution | Far intervenire una persona prima che un task chiuda il risultato con human_input=True (capitolo 13). Nei flow lo stesso principio si ottiene con @human_feedback, descritto nella pagina Flows (capitolo 16). | 15/09/2026 |
Riga di comando, sicurezza e aggiornamenti#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| CLI | Tutti i comandi crewai (capitoli 6 e 14). Alcune opzioni elencate sono più vecchie di quelle reali: in caso di dubbio usa crewai --help. | 15/09/2026 |
| Telemetry | Quali dati anonimi invia CrewAI e come disattivarli (capitolo 6). | 15/09/2026 |
| Upgrading CrewAI | Come aggiornare un progetto e quali impostazioni sono cambiate tra le versioni (capitolo 17). | 15/09/2026 |
| Changelog | L'elenco delle novità di ogni versione: il primo posto da guardare quando esce un aggiornamento. | 15/09/2026 |
Casi d'uso ed esempi#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| Evaluating use cases | La guida ufficiale per capire se un problema si presta a una crew o a un flow; è uno dei segnali della classifica. | 15/09/2026 |
| Examples | La pagina che presenta gli esempi ufficiali più rappresentativi. | 15/09/2026 |
| NL2SQLTool | Lo strumento ufficiale per interrogare un database scrivendo in linguaggio naturale (variante dell'esempio 8). | 15/09/2026 |
Codice, pacchetti e skill ufficiali#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| GitHub: crewAIInc/crewAI | Il codice sorgente del framework, con licenza MIT. Quando la documentazione e il comportamento reale non coincidono, il codice ha l'ultima parola. | 15/09/2026 |
| GitHub: releases | Le note di rilascio di ogni versione, con la data. La 1.15.21 è uscita il 9 settembre 2026. | 15/09/2026 |
| PyPI: crewai | Il pacchetto che installi: numero di versione più recente e versioni di Python supportate (da 3.10 a 3.13). | 15/09/2026 |
| PyPI: crewai-tools | Il pacchetto degli strumenti pronti, che arriva installando crewai[tools]. | 15/09/2026 |
| GitHub: crewAIInc/skills | Le skill ufficiali per gli assistenti di programmazione (come progettare agenti e task): il corso ne ha seguito i consigli, per esempio non moltiplicare gli agenti senza motivo. | 15/09/2026 |
| GitHub: crewAI-examples | Il repository degli esempi ufficiali, fonte di idee per i dieci esempi. Attenzione: l'ultimo aggiornamento è del 20 aprile 2026 e usa una versione vecchia di CrewAI con la struttura YAML, quindi il codice va adattato. | 15/09/2026 |
Se usi un assistente di programmazione, la documentazione indica questo comando per installare le skill ufficiali:
npx skills add crewaiinc/skillsCorsi e dati usati per la classifica#
La classifica dei casi d'uso combina segnali diversi. Queste sono le fonti esterne, con i loro limiti: i sondaggi parlano di agenti in generale, non solo di CrewAI, e i numeri pubblicati dalle aziende non sono verificati in modo indipendente.
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| DeepLearning.AI: Multi AI Agent Systems with crewAI | Corso breve in inglese con casi pratici: articoli, assistenza clienti, eventi, analisi finanziaria, candidature di lavoro. | 15/09/2026 |
| DeepLearning.AI: Practical Multi AI Agents and Advanced Use Cases with crewAI | Il secondo corso: pianificazione di progetti, pipeline di vendita, analisi dei dati di supporto, contenuti su larga scala. | 15/09/2026 |
| LangChain: State of Agent Engineering | Sondaggio su 1.340 persone (fine 2025): assistenza clienti e ricerca con analisi dati sono gli usi principali. | 15/09/2026 |
| LangChain: State of AI Agents | Sondaggio del 2024 su oltre 1.300 professionisti: ricerca e sintesi al primo posto. | 15/09/2026 |
| CrewAI: The State of Agentic AI in 2026 | Sondaggio di CrewAI su 500 dirigenti di grandi aziende: in quali reparti gli agenti hanno più impatto. | 15/09/2026 |
| PwC: AI Agent Survey | Sondaggio del 2025 su 308 dirigenti statunitensi: assistenza clienti, vendite e marketing, IT. | 15/09/2026 |
| CrewAI: Lessons from 2 billion agentic workflows | Il dato sulle esecuzioni totali pubblicato da CrewAI (senza divisione per caso d'uso) e l'esempio delle pipeline di vendita. | 15/09/2026 |
Strumenti e norme citati negli esempi#
| Fonte | A cosa ti serve | Verificata |
|---|---|---|
| Documentazione di uv | Tutto su uv, lo strumento che installa Python e i pacchetti ed esegue gli script del corso (capitolo 5). | 15/09/2026 |
| Ollama | Scaricare Ollama e i modelli da usare gratis sul tuo computer (capitolo 7). | 15/09/2026 |
| Serper | Creare la chiave per SerperDevTool, la ricerca web usata in molti esempi. | 15/09/2026 |
| Python: modulo csv | Leggere e scrivere file CSV con la libreria standard (esempio 8). | 15/09/2026 |
| Python: modulo sqlite3 | Usare un piccolo database SQLite senza installare nulla (variante dell'esempio 8). | 15/09/2026 |
| Regolamento (UE) 2024/1689 (AI Act) | Il testo ufficiale del regolamento europeo sull'intelligenza artificiale; l'Allegato III elenca i sistemi ad alto rischio (esempio 10). | 15/09/2026 |
| Regolamento (UE) 2026/1744 (Omnibus digitale sull'IA) | Le modifiche all'AI Act dell'8 luglio 2026, compreso il rinvio delle date per i sistemi ad alto rischio (esempio 10). | 15/09/2026 |
| Regolamento (UE) 2016/679 (GDPR) | Il regolamento europeo sulla protezione dei dati personali (esempio 10 e capitolo 17). | 15/09/2026 |
EUR-Lex a volte mostra una breve verifica del browser prima del testo. Per le norme cerca sempre la «versione consolidata», che include le modifiche successive.
Prossimi passi#
1. Porta un esempio in produzione con un flow#
La documentazione ufficiale lo dice senza giri di parole: per qualsiasi applicazione destinata a un uso reale, parti da un 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. glossario. Scegli l'esempio del corso più vicino al tuo lavoro e trasformalo: la crew diventa un passo del flow, lo stato conserva gli ingressi e i risultati, un router decide cosa fare se il risultato non va bene, una persona approva prima delle azioni irreversibili (capitolo 16). Con il decoratore @persist lo stato viene salvato e un flow interrotto può ripartire. Prima di usarlo sul serio rileggi il capitolo 17 su costi e sicurezza.
2. Valuta CrewAI AMP, senza fretta#
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. glossario è la piattaforma commerciale di CrewAI Inc. per pubblicare, monitorare e scalare crew e flow: esecuzioni via API, tracce delle esecuzioni, un editor visuale chiamato Crew Studio. Esiste anche un'edizione da installare sui propri server, CrewAI Factory. Ci si registra su app.crewai.com e dal terminale si pubblica con i comandi crewai login e crewai deploy create. La documentazione della piattaforma descrive le funzioni; prezzi e limiti vanno controllati sul sito, perché la documentazione non li riporta. Il framework resta gratuito e open source anche se non usi AMP.
3. Chiedi alla community#
Il forum ufficiale della community di CrewAI è il posto per fare domande, cercare chi ha già avuto il tuo stesso errore e vedere progetti di altri. Quando chiedi aiuto, indica sempre la versione di CrewAI (crewai version), il sistema operativo, il modello che usi e il messaggio d'errore completo. Non incollare mai il tuo file .env né le chiavi API.
4. Resta aggiornato#
CrewAI esce con nuove versioni anche più volte al mese: tra fine agosto e il 9 settembre 2026 ne sono uscite quattro. Un metodo semplice:
- Una volta al mese guarda il changelog o le release su GitHub. Su GitHub puoi anche seguire il progetto (pulsante Watch, opzione Releases) e ricevere un avviso a ogni versione.
- Negli script del corso la versione è bloccata (
crewai[tools]==1.15.21): così funzionano sempre allo stesso modo. Per provare una versione nuova cambia quel numero in una copia dello script e verifica che tutto funzioni prima di usarla ovunque. - Per aggiornare la CLI installata con uv usa
uv tool install crewai --upgrade. In un progetto,crewai installnon aggiorna nulla: installa esattamente le versioni già registrate. Per aggiornare, la guida ufficiale indicauv add "crewai[tools]>=X.Y.Z"seguito dacrewai install. - Diffida dei tutorial vecchi: comandi come
pip install crewai, strumenti comeCodeInterpreterToolo progetti concrew.pygenerati di default appartengono a versioni superate. Se un esempio trovato online non funziona, confronta la sua data con quella del changelog.
- La documentazione ufficiale, il codice su GitHub e PyPI sono le fonti che contano; il corso le ha verificate il 15 settembre 2026 con CrewAI 1.15.21.
- Esempi ufficiali, corsi e sondaggi danno idee e contesto, ma possono essere datati o parziali.
- Il passo naturale dopo il corso è trasformare una crew in un flow con stato, controlli e approvazione umana.
- AMP serve per pubblicare e monitorare; il framework resta gratuito anche senza.
- Resta aggiornato con changelog e release, e aggiorna la versione degli script solo dopo averla provata.
Buon lavoro con la tua prima squadra di agenti.
Corso indipendente, non affiliato a CrewAI Inc. Contenuti verificati su CrewAI 1.15.21 il 15 settembre 2026.