Créer une équipe d'agents IA autonomes avec CrewAI et Ollama¶
Résumé
Apprenez à orchestrer une équipe d'agents IA autonomes sur votre propre machine, en combinant le framework Python CrewAI et les modèles locaux gérés par Ollama. Idéal pour automatiser des tâches complexes nécessitant recherche et synthèse, sans dépendre de services cloud payants.
| Propriété | Valeur |
|---|---|
| Difficulté | Intermédiaire |
| OS / Environnement | Multi-plateforme (Linux recommandé) |
| Dernière mise à jour | 2026-06-28 |
Contexte¶
Dans le domaine de l'intelligence artificielle, on passe progressivement d'un modèle de simple "chatbot" (une conversation avec un seul modèle) à des systèmes "multi-agents". Ces systèmes permettent à plusieurs IA spécialisées de collaborer : un agent cherche des informations, un autre les analyse, et un troisième rédige le rapport final.
CrewAI est un framework populaire pour orchestrer ces équipes virtuelles (ou "crews"). Couplé à Ollama, il vous permet d'exécuter l'ensemble de l'équipe localement, de manière gratuite et privée.
Prérequis¶
- Ollama installé sur votre machine (voir le tutoriel dédié).
- Python 3.10 ou supérieur installé.
- Un environnement virtuel Python configuré.
Procédure¶
Étape 1 : Préparation du modèle local avec Ollama¶
CrewAI va envoyer des requêtes au modèle local. Pour des tâches de raisonnement ("agentiques"), il est conseillé d'utiliser un modèle performant comme llama3 ou mistral.
- Ouvrez un terminal.
- Téléchargez et démarrez le modèle avec Ollama :
Note : Une fois le prompt >>> affiché, vous pouvez quitter avec Ctrl+D. Le modèle restera disponible en arrière-plan via l'API locale d'Ollama.
Étape 2 : Installation des bibliothèques Python¶
Dans votre environnement de développement, installez le framework CrewAI et les outils nécessaires pour communiquer avec Ollama.
# Créer et activer un environnement virtuel (optionnel mais recommandé)
python3 -m venv env_agents
source env_agents/bin/activate # Sur Linux/macOS
# .\env_agents\Scripts\activate # Sur Windows
# Installer CrewAI et LangChain Community (pour l'intégration Ollama)
pip install crewai langchain-community
Étape 3 : Création du script de l'équipe (Crew)¶
Nous allons créer un scénario simple : - Un Chercheur (Researcher) chargé de trouver des informations sur un sujet technique. - Un Rédacteur (Writer) chargé de synthétiser ces informations en un court paragraphe.
Créez un fichier equipe_ia.py et copiez le code suivant :
Étape 4 : Exécution et observation¶
Lancez le script depuis votre terminal :
Vous verrez dans la console le "raisonnement" de vos agents (grâce à verbose=True). Le Chercheur va d'abord traiter sa tâche en sollicitant le modèle Ollama, puis il passera ses conclusions au Rédacteur qui formulera la réponse finale.
Problème fréquent¶
Erreur de connexion (Connection refused)
Si vous obtenez une erreur de type Connection refused ou Failed to connect to localhost:11434, cela signifie que le service Ollama ne tourne pas en arrière-plan. Assurez-vous d'avoir bien démarré Ollama ou lancé un ollama run <modele> avant d'exécuter votre script Python.
Glossaire¶
- Agent
- Dans CrewAI, une entité autonome avec un rôle, un objectif et une histoire (backstory) spécifique, capable d'interagir avec un LLM.
- Task (Tâche)
- Une mission précise assignée à un agent, avec une description claire de ce qui est attendu comme résultat (
expected_output). - Crew (Équipe)
- L'ensemble des agents et des tâches orchestrés pour atteindre un but commun, selon un processus défini (séquentiel, hiérarchique, etc.).
Ressources¶
- Documentation officielle CrewAI — Concepts de base et orchestration avancée.
- Site officiel Ollama — Téléchargement et gestion des modèles locaux.