Esta guía le lleva a través de cada paso de la migración de sus flujos de trabajo de n8n a JieGou. Ya sea que tenga 5 flujos de trabajo o 500, el proceso es el mismo — y la mayor parte está automatizado.
Tiempo estimado: 1–2 horas para un despliegue típico de 20–50 flujos de trabajo.
Prerrequisitos
Antes de comenzar:
- Acceso a n8n — Necesitará acceso de admin para exportar flujos de trabajo (auto-alojado o nube)
- Cuenta de JieGou — Regístrese gratis o despliegue el kit de inicio Docker Compose para entornos air-gapped
- Credenciales de integración — Claves API o tokens OAuth para cualquier servicio al que se conecten sus flujos de trabajo de n8n (Slack, Gmail, GitHub, etc.)
Paso 1: Exporte sus flujos de trabajo de n8n
Opción A: Exportar todos los flujos de trabajo (recomendado)
- Abra su instancia de n8n
- Vaya a Configuración → Exportar todos los flujos de trabajo
- Descargue el archivo JSON — contiene cada flujo de trabajo en su instancia
El archivo exportado se ve así:
[
{
"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": { ... }
},
...
]Opción B: Exportar flujos de trabajo individuales
- Abra el flujo de trabajo que quiere migrar
- Haga clic en el menú ⋮ → Descargar
- Guarde el archivo JSON
Puede importar flujos de trabajo uno a uno o en lotes.
Lo que se exporta
| Incluido | No incluido |
|---|---|
| Nombre y estructura del flujo de trabajo | Valores de credenciales (claves API, tokens) |
| Tipos de nodos y configuración | Historial de ejecución |
| Conexiones entre nodos | Variables de entorno |
| Etiquetas y anotaciones | Paquetes de nodos personalizados |
| Parámetros estáticos |
Importante: n8n nunca exporta valores de credenciales por razones de seguridad. Configurará nuevas credenciales en JieGou como conexiones de servidor MCP.
Paso 2: Regístrese en JieGou
Nube (más rápido)
- Vaya a console.jiegou.ai
- Regístrese con Google, GitHub o email
- Elija su departamento (la herramienta de importación funciona desde cualquier departamento)
- Llegará al panel — navegue a Integraciones → Migraciones
Auto-alojado (Docker Compose)
Para entornos regulados que necesitan que los datos permanezcan en las instalaciones:
# Clone el kit de inicio
git clone https://github.com/JieGouAI/self-hosted.git
cd self-hosted
# Configure
cp .env.example .env
# Edite .env con sus credenciales de Firebase y claves API de LLM
# Inicie
docker compose up -dLa consola estará disponible en http://localhost:3000.
Despliegue híbrido VPC (Enterprise)
Para equipos que necesitan la conveniencia de la nube con procesamiento de datos en las instalaciones:
- Contacte sales@jiegou.ai para la configuración del agente VPC
- El plano de control (consola, programación, monitoreo) se ejecuta en la nube de JieGou
- La ejecución de flujos de trabajo ocurre dentro de su VPC — los datos nunca salen de su red
- Vea nuestro artículo sobre despliegue híbrido para detalles de arquitectura
Paso 3: Use el asistente de importación
- Navegue a
/migrations/n8nen su consola de JieGou - Verá el Asistente de importación de n8n — un proceso de tres pasos
Subir
- Pegue su JSON de flujo de trabajo de n8n directamente en el área de texto, o
- Suba el archivo
.jsonusando el selector de archivos
Haga clic en Previsualizar conversión para analizar el flujo de trabajo.
Lo que sucede durante el análisis
La herramienta de importación:
- Analiza el JSON del flujo de trabajo de n8n (valida estructura, extrae nodos y conexiones)
- Mapea cada tipo de nodo de n8n al tipo de paso de JieGou más cercano
- Detecta nodos disparadores (webhooks, programaciones, disparadores manuales) y los convierte a entradas de flujo de trabajo
- Identifica nodos de integración y sugiere servidores MCP coincidentes
- Construye el grafo de conexiones (preservando orden de ejecución y lógica de ramificación)
- Genera un reporte de conversión con advertencias para todo lo que necesite atención manual
Paso 4: Revise y ajuste los mapeos
Después del análisis, verá un reporte de conversión detallado.
Tarjetas de resumen
La parte superior del reporte muestra cuatro métricas:
- Total de nodos — Cuántos nodos de n8n había en el flujo de trabajo
- Mapeados — Nodos que se convirtieron limpiamente a tipos de paso de JieGou
- Omitidos — Nodos que no necesitan conversión (ej., NoOp, StickyNote)
- Advertencias — Elementos que necesitan su atención
Tabla de mapeo de nodos
Cada nodo de n8n se muestra con su estado de conversión:
| Estado | Significado | Acción requerida |
|---|---|---|
| Mapeado | Convertido limpiamente a un paso de JieGou | Ninguna — verifique que el paso se vea bien |
| Parcial | Convertido pero algunos parámetros necesitan revisión manual | Verifique la configuración del paso |
| Manual | No hay conversión automática disponible | Construya el paso equivalente manualmente |
| Omitido | El tipo de nodo no necesita conversión | Ninguna |
Cómo se mapean los nodos de n8n a pasos de JieGou
| Nodo n8n | Paso JieGou | Notas |
|---|---|---|
Set / Code / Function | Paso LLM | La IA realiza la transformación en lugar de código |
IF / Switch / Filter | Paso de condición | Mapeo directo — misma lógica de ramificación |
SplitInBatches | Paso de bucle | Mapeo directo — itera sobre entrada de array |
Merge / Aggregate | Paso agregador | Combina salidas de ramas paralelas |
HTTP Request | Paso LLM + Herramienta MCP | Usa el servidor MCP HTTP para llamadas API |
Slack / Gmail / GitHub | Paso LLM + Servidor MCP | Usa la integración de servidor MCP correspondiente |
Webhook (disparador) | Entrada de flujo de trabajo | Se convierte en el esquema de entrada del flujo de trabajo |
Schedule Trigger | Programación | Configure por separado en Programaciones de JieGou |
OpenAI / LangChain Agent | Paso LLM | BYOK multi-proveedor — traiga su propia clave |
Postgres / MySQL | Paso LLM + Servidor MCP | Usa el servidor MCP de base de datos |
Google Sheets | Paso LLM + Servidor MCP | Usa el servidor MCP de Google Sheets |
Entendiendo las advertencias
Las advertencias se clasifican en tres categorías:
- 🔴 Error — Algo no puede ser convertido automáticamente. Ejemplo: “El nodo de función personalizada usa paquetes npm no disponibles en JieGou”
- 🟡 Advertencia — La conversión tuvo éxito pero necesita verificación. Ejemplo: “Nodo de Slack detectado — configure el servidor MCP de Slack para esta integración”
- 🔵 Info — Contexto útil. Ejemplo: “Disparador webhook convertido a esquema de entrada de flujo de trabajo”
Advertencias comunes y cómo resolverlas:
| Advertencia | Resolución |
|---|---|
| ”Configure el servidor MCP de [X]“ | Vaya a Biblioteca → Integraciones, instale el servidor MCP y conecte sus credenciales |
| ”Expresión compleja puede necesitar ajuste” | Revise la configuración del prompt/paso — las expresiones de n8n como {{$json.field}} se convierten a mapeos de entrada |
| ”Nodo de código personalizado” | Revise el prompt LLM generado — describe lo que hacía el código, y el LLM realizará la misma tarea |
| ”Tipo de nodo no soportado” | Construya el equivalente manualmente o verifique si un servidor MCP proporciona la funcionalidad |
Paso 5: Configure sus servidores MCP
Los servidores MCP (Model Context Protocol) reemplazan los nodos de integración integrados de n8n. Cada servidor MCP proporciona herramientas que los pasos LLM pueden usar.
Instale servidores MCP
- Vaya a Biblioteca → Integraciones
- Busque la integración que necesita (ej., “Slack”, “GitHub”, “PostgreSQL”)
- Haga clic en Instalar para agregarlo a su cuenta
- Conecte con su clave API o credenciales OAuth
Mapee credenciales de n8n a servidores MCP
| Credencial n8n | Servidor MCP de JieGou | Método de conexión |
|---|---|---|
| Slack OAuth | Servidor MCP de Slack | OAuth 2.0 (vía Klavis) |
| Gmail API | Servidor MCP de Gmail | OAuth 2.0 (vía Klavis) |
| GitHub Token | Servidor MCP de GitHub | Token de acceso personal |
| Postgres Connection | Servidor MCP de PostgreSQL | Cadena de conexión |
| HTTP Header Auth | Servidor MCP HTTP | Clave API / Token Bearer |
| OpenAI API Key | Configuración BYOK de cuenta | Clave API en Key Vault |
| AWS Credentials | Servidor MCP de AWS | Clave de acceso + secreto |
| Google Sheets OAuth | Servidor MCP de Google Sheets | Cuenta de servicio u OAuth |
Verifique acceso a herramientas
Después de instalar servidores MCP:
- Abra el flujo de trabajo importado
- Verifique cada paso LLM que usa herramientas MCP
- Verifique que el servidor MCP correcto esté seleccionado
- Pruebe la conexión con una ejecución manual rápida
Paso 6: Pruebe con un bakeoff
Antes de entrar en producción, ejecute tanto su flujo de trabajo de n8n como el de JieGou en paralelo para comparar la calidad de salida.
Cree un bakeoff
- Vaya a Bakeoffs → Nuevo Bakeoff
- Seleccione modo Flujo de trabajo vs. Flujo de trabajo
- Agregue su flujo de trabajo de JieGou como Brazo A
- Para el Brazo B, tiene dos opciones:
- Ejecute su flujo de trabajo de n8n por separado y pegue la salida
- Cree una segunda variante del flujo de trabajo de JieGou con diferentes configuraciones de LLM
Genere entradas de prueba
- Haga clic en Generar entradas — JieGou crea datos de prueba sintéticos que coinciden con el esquema de entrada de su flujo de trabajo
- O proporcione entradas reales de su historial de ejecución de n8n
- Recomendamos 5–10 entradas diversas para una comparación significativa
Revise resultados
El bakeoff ejecuta ambos brazos en cada entrada y proporciona:
- Evaluación LLM-as-judge — Un evaluador de IA puntúa cada salida en precisión, completitud y relevancia
- Confianza estadística — Desviación estándar e intervalos de confianza del 95%
- Comparación lado a lado — Vea las salidas una junto a la otra para revisión manual
Qué buscar
- Formato de salida — ¿El flujo de trabajo de JieGou produce salida en el mismo formato que esperan sus sistemas posteriores?
- Completitud de datos — ¿Están todos los campos poblados? ¿Falta información?
- Casos extremos — ¿Cómo manejan ambos entradas vacías, payloads grandes o datos inusuales?
- Manejo de errores — ¿Qué sucede cuando una llamada API falla?
Paso 7: Entre en producción
Una vez que está seguro de la conversión:
Migre gradualmente
- Comience con flujos de trabajo de bajo riesgo — notificaciones internas, generación de reportes, sincronización de datos
- Monitoree por 48 horas — verifique los registros de ejecución en el historial de ejecuciones de JieGou
- Mueva flujos de trabajo críticos — integraciones orientadas al cliente, procesamiento de pagos, pipelines de datos
- Descomisione n8n — una vez que todos los flujos de trabajo estén verificados, apague su instancia de n8n
Configure la programación
Si sus flujos de trabajo de n8n usaban disparadores de programación:
- Vaya a Automatizar → Programaciones
- Cree una nueva programación para cada flujo de trabajo
- Configure la expresión cron (JieGou soporta la misma sintaxis cron que n8n)
- Establezca la zona horaria y parámetros de entrada
Configure disparadores webhook
Si sus flujos de trabajo de n8n usaban disparadores webhook:
- Vaya a Automatizar → Disparadores
- Cree un nuevo disparador webhook
- Copie la nueva URL del webhook
- Actualice la URL del webhook en sus sistemas ascendentes (ej., Stripe, GitHub, Slack)
Habilite el monitoreo
- Alertas de ejecución — Configure notificaciones para ejecuciones fallidas
- Registro de auditoría — Todas las ejecuciones de flujos de trabajo se registran automáticamente con 30 tipos de acciones
- Evidencia SOC 2 — Exporte evidencia de cumplimiento desde el Panel de cumplimiento
Solución de problemas
Error “JSON inválido” durante la subida
- Verifique que el archivo sea JSON válido (intente pegarlo en jsonlint.com)
- Si exportó múltiples flujos de trabajo, el archivo es un array JSON — la herramienta de importación maneja tanto flujos de trabajo individuales como arrays
- Verifique caracteres BOM o problemas de codificación (guarde como UTF-8)
Nodo marcado como “Requiere manual”
Esto significa que la herramienta de importación no pudo convertir automáticamente este tipo de nodo. Casos comunes:
- Nodos de función personalizada con dependencias npm complejas → Reescriba la lógica como un prompt LLM o use el servidor MCP HTTP para llamar una API externa
- Nodos FTP / SFTP → Use el servidor MCP de sistema de archivos o un servicio de transferencia de archivos basado en HTTP
- Nodos XML → Los pasos LLM manejan el análisis XML nativamente — describa la transformación en el prompt
El flujo de trabajo falla después de la importación
- Verifique la página de detalle de ejecución para el error específico
- Causas comunes:
- Servidor MCP no configurado (instale desde Biblioteca → Integraciones)
- Desajuste de esquema de entrada (verifique la configuración de entrada del flujo de trabajo)
- Clave BYOK faltante para el proveedor LLM (agregue en Configuración de cuenta → Claves API)
Diferencias de rendimiento
Los flujos de trabajo de JieGou son nativos de IA — en lugar de ejecutar código en una VM, usan pasos LLM para realizar transformaciones. Esto significa:
- La latencia puede ser mayor para transformaciones de datos simples (llamadas LLM vs. código en memoria)
- La calidad puede ser mayor para procesamiento de datos no estructurados (comprensión LLM vs. regex/código)
- El mantenimiento es menor — no hay código que depurar cuando las APIs cambian
Si la latencia es crítica, use el Paso de condición para omitir llamadas LLM en operaciones determinísticas y reserve los pasos LLM para tareas que se beneficien de la IA.
Lista de verificación de migración
Use esta lista para rastrear su progreso de migración:
- Exportar todos los flujos de trabajo de n8n como JSON
- Crear cuenta de JieGou (nube, auto-alojado o híbrido)
- Subir flujos de trabajo al asistente de importación
- Revisar reportes de conversión para cada flujo de trabajo
- Instalar servidores MCP requeridos desde Biblioteca → Integraciones
- Configurar credenciales de servidores MCP
- Ejecutar bakeoffs para flujos de trabajo críticos
- Configurar programaciones para flujos de trabajo con disparador cron
- Actualizar URLs de webhook en sistemas ascendentes
- Monitorear ejecución por 48 horas
- Descomisionar instancia de n8n
- Exportar evidencia SOC 2 para pista de auditoría
¿Necesita ayuda?
- Herramienta de importación: console.jiegou.ai/migrations/n8n
- Integraciones MCP: console.jiegou.ai/integrations
- Comunidad: community.jiegou.ai
- Soporte Enterprise: sales@jiegou.ai
- Detalles de seguridad: Por qué construimos despliegue híbrido