Ce guide vous accompagne à travers chaque étape de la migration de vos workflows n8n vers JieGou. Que vous ayez 5 workflows ou 500, le processus est le même — et la majeure partie est automatisée.
Estimation de temps : 1 à 2 heures pour un déploiement typique de 20 à 50 workflows.
Prérequis
Avant de commencer :
- Accès n8n — Vous aurez besoin d’un accès admin pour exporter les workflows (auto-hébergé ou cloud)
- Compte JieGou — Inscrivez-vous gratuitement ou déployez le kit de démarrage Docker Compose pour les environnements air-gapped
- Identifiants d’intégration — Clés API ou tokens OAuth pour tous les services auxquels vos workflows n8n se connectent (Slack, Gmail, GitHub, etc.)
Étape 1 : Exportez vos workflows n8n
Option A : Exporter tous les workflows (recommandé)
- Ouvrez votre instance n8n
- Allez dans Paramètres → Exporter tous les workflows
- Téléchargez le fichier JSON — il contient chaque workflow de votre instance
Le fichier exporté ressemble à ceci :
[
{
"name": "Lead Enrichment Pipeline",
"nodes": [
{ "name": "Webhook", "type": "n8n-nodes-base.webhook", ... },
{ "name": "HTTP Request", "type": "n8n-nodes-base.httpRequest", ... },
{ "name": "Set", "type": "n8n-nodes-base.set", ... }
],
"connections": { ... }
},
...
]Option B : Exporter des workflows individuels
- Ouvrez le workflow que vous souhaitez migrer
- Cliquez sur le menu … → Télécharger
- Sauvegardez le fichier JSON
Vous pouvez importer les workflows un par un ou par lot.
Ce qui est exporté
| Inclus | Non inclus |
|---|---|
| Nom et structure du workflow | Valeurs des identifiants (clés API, tokens) |
| Types de nœuds et configuration | Historique d’exécution |
| Connexions entre nœuds | Variables d’environnement |
| Tags et annotations | Packages de nœuds personnalisés |
| Paramètres statiques |
Important : n8n n’exporte jamais les valeurs des identifiants pour des raisons de sécurité. Vous configurerez de nouveaux identifiants dans JieGou comme connexions de serveur MCP.
Étape 2 : Inscrivez-vous sur JieGou
Cloud (le plus rapide)
- Allez sur console.jiegou.ai
- Inscrivez-vous avec Google, GitHub ou email
- Choisissez votre département (l’outil d’import fonctionne depuis n’importe quel département)
- Vous arriverez sur le tableau de bord — naviguez vers Intégrations → Migrations
Auto-hébergé (Docker Compose)
Pour les environnements réglementés où les données doivent rester sur site :
# Cloner le kit de démarrage
git clone https://github.com/JieGouAI/self-hosted.git
cd self-hosted
# Configurer
cp .env.example .env
# Éditez .env avec vos identifiants Firebase et clés API LLM
# Démarrer
docker compose up -dLa console sera disponible à http://localhost:3000.
Déploiement VPC hybride (Enterprise)
Pour les équipes qui veulent la commodité du cloud avec le traitement des données sur site :
- Contactez sales@jiegou.ai pour la configuration de l’agent VPC
- Le plan de contrôle (console, planification, monitoring) s’exécute dans le cloud JieGou
- L’exécution des workflows se fait dans votre VPC — les données ne quittent jamais votre réseau
- Consultez notre article sur le déploiement hybride pour les détails d’architecture
Étape 3 : Utilisez l’assistant d’import
- Naviguez vers
/migrations/n8ndans votre console JieGou - Vous verrez l’assistant d’import n8n — un processus en trois étapes
Téléchargement
- Collez votre JSON de workflow n8n directement dans la zone de texte, ou
- Téléchargez le fichier
.jsonvia le sélecteur de fichiers
Cliquez sur Prévisualiser la conversion pour analyser le workflow.
Ce qui se passe pendant l’analyse
L’outil d’import :
- Parse le JSON du workflow n8n (valide la structure, extrait les nœuds et connexions)
- Mappe chaque type de nœud n8n vers le type d’étape JieGou le plus proche
- Détecte les nœuds de déclenchement (webhooks, planifications, déclencheurs manuels) et les convertit en entrées de workflow
- Identifie les nœuds d’intégration et suggère les serveurs MCP correspondants
- Construit le graphe de connexions (en préservant l’ordre d’exécution et la logique de branchement)
- Génère un rapport de conversion avec des avertissements pour tout ce qui nécessite une attention manuelle
Étape 4 : Vérifiez et ajustez les mappages
Après l’analyse, vous verrez un rapport de conversion détaillé.
Cartes de résumé
Le haut du rapport affiche quatre métriques :
- Total des nœuds — Combien de nœuds n8n étaient dans le workflow
- Mappés — Nœuds convertis proprement en types d’étapes JieGou
- Ignorés — Nœuds qui n’ont pas besoin de conversion (par ex., NoOp, StickyNote)
- Avertissements — Éléments nécessitant votre attention
Tableau de mappage des nœuds
Chaque nœud n8n est affiché avec son statut de conversion :
| Statut | Signification | Action requise |
|---|---|---|
| Mappé | Converti proprement en étape JieGou | Aucune — vérifiez que l’étape semble correcte |
| Partiel | Converti mais certains paramètres nécessitent une revue manuelle | Vérifiez la configuration de l’étape |
| Manuel | Pas de conversion automatique disponible | Construisez l’étape équivalente manuellement |
| Ignoré | Le type de nœud n’a pas besoin de conversion | Aucune |
Comment les nœuds n8n se mappent aux étapes JieGou
| Nœud n8n | Étape JieGou | Notes |
|---|---|---|
Set / Code / Function | Étape LLM | L’IA effectue la transformation au lieu du code |
IF / Switch / Filter | Étape Condition | Mappage direct — même logique de branchement |
SplitInBatches | Étape Boucle | Mappage direct — itère sur l’entrée tableau |
Merge / Aggregate | Étape Agrégateur | Combine les sorties des branches parallèles |
HTTP Request | Étape LLM + Outil MCP | Utilise le serveur MCP HTTP pour les appels API |
Slack / Gmail / GitHub | Étape LLM + Serveur MCP | Utilise le serveur MCP d’intégration correspondant |
Webhook (déclencheur) | Entrée de workflow | Devient le schéma d’entrée du workflow |
Schedule Trigger | Planification | À configurer séparément dans les Planifications JieGou |
OpenAI / LangChain Agent | Étape LLM | Multi-fournisseur BYOK — apportez votre propre clé |
Postgres / MySQL | Étape LLM + Serveur MCP | Utilise le serveur MCP de base de données |
Google Sheets | Étape LLM + Serveur MCP | Utilise le serveur MCP Google Sheets |
Comprendre les avertissements
Les avertissements se répartissent en trois catégories :
- Erreur — Quelque chose ne peut pas être converti automatiquement. Exemple : « Le nœud de fonction personnalisé utilise des packages npm non disponibles dans JieGou »
- Avertissement — La conversion a réussi mais nécessite une vérification. Exemple : « Nœud Slack détecté — configurez le serveur MCP Slack pour cette intégration »
- Info — Contexte utile. Exemple : « Le déclencheur webhook a été converti en schéma d’entrée de workflow »
Avertissements courants et comment les résoudre :
| Avertissement | Résolution |
|---|---|
| « Configurer le serveur MCP [X] » | Allez dans Bibliothèque → Intégrations, installez le serveur MCP et connectez vos identifiants |
| « L’expression complexe peut nécessiter un ajustement » | Vérifiez le prompt/la configuration de l’étape — les expressions n8n comme {{$json.field}} sont converties en mappages d’entrée |
| « Nœud de code personnalisé » | Vérifiez le prompt LLM généré — il décrit ce que le code faisait, et le LLM effectuera la même tâche |
| « Type de nœud non supporté » | Construisez l’équivalent manuellement ou vérifiez si un serveur MCP fournit la fonctionnalité |
Étape 5 : Configurez vos serveurs MCP
Les serveurs MCP (Model Context Protocol) remplacent les nœuds d’intégration intégrés de n8n. Chaque serveur MCP fournit des outils que les étapes LLM peuvent utiliser.
Installer les serveurs MCP
- Allez dans Bibliothèque → Intégrations
- Recherchez l’intégration dont vous avez besoin (par ex., « Slack », « GitHub », « PostgreSQL »)
- Cliquez sur Installer pour l’ajouter à votre compte
- Connectez avec votre clé API ou vos identifiants OAuth
Mapper les identifiants n8n aux serveurs MCP
| Identifiant n8n | Serveur MCP JieGou | Méthode de connexion |
|---|---|---|
| Slack OAuth | Serveur MCP Slack | OAuth 2.0 (via Klavis) |
| Gmail API | Serveur MCP Gmail | OAuth 2.0 (via Klavis) |
| GitHub Token | Serveur MCP GitHub | Token d’accès personnel |
| Postgres Connection | Serveur MCP PostgreSQL | Chaîne de connexion |
| HTTP Header Auth | Serveur MCP HTTP | Clé API / Token Bearer |
| OpenAI API Key | Paramètres BYOK du compte | Clé API dans le Key Vault |
| AWS Credentials | Serveur MCP AWS | Clé d’accès + secret |
| Google Sheets OAuth | Serveur MCP Google Sheets | Compte de service ou OAuth |
Vérifier l’accès aux outils
Après avoir installé les serveurs MCP :
- Ouvrez le workflow importé
- Vérifiez chaque étape LLM qui utilise des outils MCP
- Vérifiez que le bon serveur MCP est sélectionné
- Testez la connexion avec une exécution manuelle rapide
Étape 6 : Testez avec un bakeoff
Avant de passer en production, exécutez votre workflow n8n et votre workflow JieGou côte à côte pour comparer la qualité des sorties.
Créer un bakeoff
- Allez dans Bakeoffs → Nouveau Bakeoff
- Sélectionnez le mode Workflow vs. Workflow
- Ajoutez votre workflow JieGou comme Bras A
- Pour le Bras B, vous avez deux options :
- Exécutez votre workflow n8n séparément et collez la sortie
- Créez une seconde variante de workflow JieGou avec des paramètres LLM différents
Générer des entrées de test
- Cliquez sur Générer des entrées — JieGou crée des données de test synthétiques correspondant au schéma d’entrée de votre workflow
- Ou fournissez des entrées réelles de votre historique d’exécution n8n
- Nous recommandons 5 à 10 entrées diverses pour une comparaison significative
Examiner les résultats
Le bakeoff exécute les deux bras sur chaque entrée et fournit :
- Évaluation LLM-as-judge — Un évaluateur IA note chaque sortie sur la précision, la complétude et la pertinence
- Confiance statistique — Écart-type et intervalles de confiance à 95 %
- Comparaison côte à côte — Visualisez les sorties l’une à côté de l’autre pour une revue manuelle
Ce qu’il faut surveiller
- Format de sortie — Le workflow JieGou produit-il la sortie dans le format attendu par vos systèmes en aval ?
- Complétude des données — Tous les champs sont-ils remplis ? Des informations manquantes ?
- Cas limites — Comment les deux gèrent-ils les entrées vides, les grandes charges utiles ou les données inhabituelles ?
- Gestion des erreurs — Que se passe-t-il quand un appel API échoue ?
Étape 7 : Passez en production
Une fois que vous êtes confiant dans la conversion :
Basculez progressivement
- Commencez par les workflows à faible risque — notifications internes, génération de rapports, synchronisation de données
- Surveillez pendant 48 heures — vérifiez les logs d’exécution dans l’historique d’exécution de JieGou
- Déplacez les workflows critiques — intégrations client, traitement des paiements, pipelines de données
- Décommissionnez n8n — une fois tous les workflows vérifiés, arrêtez votre instance n8n
Configurer la planification
Si vos workflows n8n utilisaient des déclencheurs planifiés :
- Allez dans Automatiser → Planifications
- Créez une nouvelle planification pour chaque workflow
- Configurez l’expression cron (JieGou supporte la même syntaxe cron que n8n)
- Définissez le fuseau horaire et les paramètres d’entrée
Configurer les déclencheurs webhook
Si vos workflows n8n utilisaient des déclencheurs webhook :
- Allez dans Automatiser → Déclencheurs
- Créez un nouveau déclencheur webhook
- Copiez la nouvelle URL de webhook
- Mettez à jour l’URL de webhook dans vos systèmes en amont (par ex., Stripe, GitHub, Slack)
Activer le monitoring
- Alertes d’exécution — Configurez des notifications pour les exécutions échouées
- Journalisation d’audit — Toutes les exécutions de workflow sont automatiquement journalisées avec 30 types d’actions
- Preuves SOC 2 — Exportez les preuves de conformité depuis le tableau de bord de conformité
Dépannage
Erreur « JSON invalide » lors du téléchargement
- Vérifiez que le fichier est du JSON valide (essayez de le coller dans jsonlint.com)
- Si vous avez exporté plusieurs workflows, le fichier est un tableau JSON — l’outil d’import gère les workflows uniques et les tableaux
- Vérifiez les caractères BOM ou les problèmes d’encodage (sauvegardez en UTF-8)
Nœud marqué comme « Manuel requis »
Cela signifie que l’outil d’import n’a pas pu convertir automatiquement ce type de nœud. Cas courants :
- Nœuds Function personnalisés avec des dépendances npm complexes → Réécrivez la logique comme prompt LLM ou utilisez le serveur MCP HTTP pour appeler une API externe
- Nœuds FTP / SFTP → Utilisez le serveur MCP filesystem ou un service de transfert de fichiers basé sur HTTP
- Nœuds XML → Les étapes LLM gèrent nativement le parsing XML — décrivez la transformation dans le prompt
L’exécution du workflow échoue après l’import
- Vérifiez la page de détail de l’exécution pour l’erreur spécifique
- Causes courantes :
- Serveur MCP non configuré (installez depuis Bibliothèque → Intégrations)
- Incompatibilité du schéma d’entrée (vérifiez la configuration d’entrée du workflow)
- Clé BYOK manquante pour le fournisseur LLM (ajoutez dans Paramètres du compte → Clés API)
Différences de performance
Les workflows JieGou sont IA-natifs — au lieu d’exécuter du code dans une VM, ils utilisent des étapes LLM pour effectuer les transformations. Cela signifie :
- La latence peut être plus élevée pour les transformations de données simples (appels LLM vs. code en mémoire)
- La qualité peut être plus élevée pour le traitement de données non structurées (compréhension LLM vs. regex/code)
- La maintenance est plus faible — pas de code à débuguer quand les API changent
Si la latence est critique, utilisez l’Étape Condition pour contourner les appels LLM pour les opérations déterministes et réservez les étapes LLM aux tâches qui bénéficient de l’IA.
Checklist de migration
Utilisez cette checklist pour suivre votre progression de migration :
- Exporter tous les workflows n8n en JSON
- Créer un compte JieGou (cloud, auto-hébergé ou hybride)
- Télécharger les workflows dans l’assistant d’import
- Vérifier les rapports de conversion pour chaque workflow
- Installer les serveurs MCP requis depuis Bibliothèque → Intégrations
- Configurer les identifiants des serveurs MCP
- Exécuter des bakeoffs pour les workflows critiques
- Configurer les planifications pour les workflows déclenchés par cron
- Mettre à jour les URL de webhook dans les systèmes en amont
- Surveiller l’exécution pendant 48 heures
- Décommissionner l’instance n8n
- Exporter les preuves SOC 2 pour la piste d’audit
Besoin d’aide ?
- Outil d’import : console.jiegou.ai/migrations/n8n
- Intégrations MCP : console.jiegou.ai/integrations
- Communauté : community.jiegou.ai
- Support Enterprise : sales@jiegou.ai
- Détails de sécurité : Pourquoi nous avons construit le déploiement hybride