Importar un workflow de n8n — un agente de IA que responde mensajes de chat
Un workflow de n8n — un disparador de chat, un AI Agent, un OpenAI Chat Model y una Simple Memory — importado por aggrega import en un Aggregate, una Release y un Manifest que se compilan para Docker Compose tal como están escritos.
Importar un workflow de n8n lo recorre paso a paso: el comando, los archivos que escribe, la compilación y una ejecución de lo que compila. Esta carpeta contiene cada etapa de ese recorrido:
| carpeta | qué contiene |
|---|---|
source/ | el workflow, support-agent.json; el .aggrega-config.yaml que convierte la carpeta en un espacio de trabajo; e import-answers.yaml, la respuesta a lo que ningún workflow puede contener, que pide una importación para Kubernetes |
draft/ | los archivos que escribió aggrega import support-agent.json --target compose, sin cambios, y lo que imprimió: stdout.txt en la salida estándar, import.txt en la salida de error estándar |
source/support-agent.json está escrito para este ejemplo, con la forma en que n8n exporta un workflow.
En un checkout del repositorio de la documentación, check.sh vuelve a ejecutar la importación, compara lo que escribe e imprime con draft/, compara los bloques que cita el recorrido con estos archivos, y valida y compila lo que escribió la importación. Necesita el catálogo de la biblioteca estándar (dónde conseguir uno) descargado junto a este repositorio, o su directorio indicado en AGGREGA_CATALOG_DIRS.
Generar el ejemplo
Puedes ejecutar la importación de este ejemplo con los comandos de abajo, o hacer que tu asistente de IA la ejecute por ti.
Escribe el ejemplo en una carpeta nueva con su nombre:
aggrega scaffold --example import-n8nDespués imprime los comandos que hay que ejecutar a continuación. El primero entra en la carpeta nueva:
cd import-n8nCompilación
La importación redacta los borradores de los archivos Aggrega junto al proyecto, en source/, y obtiene lo que la compilación necesita. Evalúa el proyecto frente al catálogo de la biblioteca estándar, que el registro predeterminado del espacio de trabajo publica como una instantánea firmada: la primera importación la obtiene, la verifica, la guarda en la caché de contenido del espacio de trabajo y la nombra por su digest en el registro que escribe junto a los borradores. Un espacio de trabajo que nombra sus propias carpetas de catálogo — en AGGREGA_CATALOG_DIRS, o bajo workspace.catalog_dirs — importa en cambio con respecto a ellas:
cd sourceaggrega import support-agent.json --target composeaggrega validate --release release.yamlaggrega build --release release.yamlCómo ejecutar lo que escribe la compilación se explica en el recorrido enlazado arriba.
Con un asistente de IA
Un asistente de IA configurado con las herramientas de Aggrega puede hacer lo mismo: pégale este prompt.
Usa solo las herramientas de Aggrega y no crees tú ninguna carpeta. Si la carpeta del espacio de trabajo aún no contiene una carpeta `import-n8n`, llama una vez a la herramienta `scaffold` con `example` establecido en `import-n8n` y sin `dir`: escribe el ejemplo en una nueva carpeta `import-n8n`, cuya carpeta `source` contiene lo que este ejemplo importa. Después llama a la herramienta `import` con `workspace_root` establecido en `import-n8n/source`, `source` establecido en `support-agent.json` y `target` establecido en `compose`: lee las respuestas que necesita de `import-answers.yaml`, junto a `support-agent.json`, escribe sus borradores en `import-n8n/source` y descarga lo que necesitan. Después llama a la herramienta `validate` con `workspace_root` establecido en `import-n8n/source` y `release` establecido en `release.yaml`, y a la herramienta `build` con `workspace_root` establecido en `import-n8n/source`, `release` establecido en `release.yaml` y `write` establecido en true. Dime qué archivos escribió la compilación; están en `import-n8n/source/dist/`.Probarlo
Con el stack en ejecución tal como lo ejecuta la guía paso a paso — las credenciales almacenadas y el workflow activo —, abre http://127.0.0.1:5678 para el editor de n8n y envía al disparador de chat un mensaje con el usuario y la contraseña que almacena, leídos de CHAT_USER y CHAT_PASSWORD en la entrada estándar de curl:
printf 'user = "%s:%s"\n' "$CHAT_USER" "$CHAT_PASSWORD" | curl --config - -sS -i -X POST \ http://127.0.0.1:5678/webhook/a3c9e1f2-4b5d-4e6f-8a7b-9c0d1e2f3a04/chat -H 'Content-Type: application/json' \ -d '{"action": "sendMessage", "sessionId": "s1", "chatInput": "In one short sentence: what does a support plan cover?"}'HTTP/1.1 500 Internal Server Error[… omitted: the response's other headers]
{"message":"Error in workflow"}La ejecución almacenó un marcador de posición para la clave de OpenAI, así que el workflow se detuvo en su llamada al modelo, y su ejecución en el editor muestra el rechazo de OpenAI: Incorrect API key provided: sk-place*****************-key.
Importado con --target helm y aplicado a Kubernetes, n8n acepta el mismo mensaje en la misma dirección una vez que las credenciales están almacenadas y el workflow activado en la instancia en ejecución, como muestra la guía paso a paso, y que un puerto local se redirige a su Service; la ejecución obtuvo allí la misma respuesta:
kubectl port-forward -n <namespace> svc/n8n-default 5678:5678