n8n

n8n-nodes-stac es un paquete de nodo comunitario que añade el sub-nodo Stac Chat Model a n8n. Se conecta a la entrada Model de cualquier nodo raíz de IA — AI Agent, Basic LLM Chain, Question and Answer Chain — para que el workflow corra en tu stack en lugar de un proveedor cobrado por token.

El nodo habla con la misma superficie compatible con OpenAI que todo lo demás aquí, así que nada cambia en tu stack: la misma clave, la misma base URL, el mismo precio fijo mensual por más que el workflow se dispare.

Instala el nodo#

1. Abre Settings → Community nodes

   Necesitas ser el owner de la instancia. Consulta la guía de instalación de n8n si la sección no aparece.

2. Instala n8n-nodes-stac

   Haz clic en Install a community node, escribe el nombre del paquete, acepta el aviso de riesgos e instala. n8n recarga el registro de nodos por su cuenta — no hace falta reiniciar el contenedor.

3. O instálalo manualmente

   En una instancia self-hosted puedes saltarte la interfaz e instalar directamente en el directorio de nodos personalizados de n8n:

   bash

   cd ~/.n8n/nodes
   npm install n8n-nodes-stac

   Reinicia n8n después.

Crea la credencial#

El paquete trae un tipo de credencial, Stac API, compartido por todos sus nodos.

La autenticación es por bearer token (Authorization: Bearer <clave>), igual que en cualquier otro cliente de Stac. El botón Test de la credencial llama a GET /v1/models, así que una prueba en verde confirma la clave y la base URL de una sola vez.

Añádelo a un workflow#

1. Añade un nodo raíz de IA

   Un AI Agent es el punto de partida habitual, pero sirve cualquier nodo con entrada Model.

2. Conecta Stac Chat Model a su entrada Model

   Busca "Stac" en el panel de nodos — aparece en Language Models → Chat Models.

3. Elige el modelo

   El desplegable Model se rellena al editar desde GET /v1/models, así que lista exactamente lo que tu clave puede llamar — en la mayoría de los planes, una sola entrada: el modelo que corre tu stack.

Parámetros#

Todo excepto Model vive en Options y es opcional.

Cómo encaja en n8n#

El nodo construye el modelo con supplyModel de @n8n/ai-node-sdk, que n8n provee en runtime. Dos consecuencias que conviene conocer:

• Sin LangChain empaquetado. n8n-workflow y @n8n/ai-node-sdk son peer dependencies, así que el proceso mantiene una única instancia de @langchain/core en lugar de dos peleándose.
• Las ejecuciones las traza n8n mismo. Las llamadas al modelo aparecen en la vista de logs y tracing de n8n, con prompts y recuento de tokens, no solo como una llamada HTTP opaca.

Desarrollado y probado con n8n 2.36.9. Las versiones anteriores traen releases previas de ese SDK y no se han probado.

AI Assistant del editor#

Esto es distinto del node Chat Model de arriba: es el AI Assistant nativo de n8n — la función que arma, ejecuta e itera un workflow completo a partir de un prompt, dentro del propio editor, en vez de un node dentro de un workflow ya armado. También acepta un proveedor de modelo propio, compatible con OpenAI, así que se puede apuntar a tu stack.

1. Confirma los requisitos

   Necesitas una versión reciente de n8n self-hosted con soporte para el módulo instance-ai, y una sandbox corriendo — obligatoria para que el Assistant ejecute lo que construye. Consulta la documentación de setup de n8n para las opciones de sandbox.

2. Configura las variables de entorno de la instancia

   La misma clave de la tabla de arriba sirve aquí — no hace falta crear otra.

   bash

   N8N_ENABLED_MODULES=instance-ai   # súmala a los módulos ya habilitados
   N8N_INSTANCE_AI_MODEL_URL=https://api.trystac.com/v1
   N8N_INSTANCE_AI_MODEL_API_KEY=<la misma clave de la página API keys>

3. Reinicia la instancia

   El módulo solo se carga al arrancar n8n.

Solución de problemas#

• El desplegable de Model está vacío. La credencial no puede alcanzar GET {baseUrl}/models — clave incorrecta, base URL incorrecta, o la instancia sin salida a red. Ejecuta la prueba de la credencial para saber cuál.
• 401 invalid_api_key. La clave fue revocada o pertenece a un stack eliminado. Genera una nueva; consulta Errores.
• 429 en un workflow con mucho tráfico. Los límites de uso son por clave. Dale a n8n su propia clave para que una tormenta de reintentos en el workflow no limite tu aplicación.
• El nodo no aparece tras instalarlo. Comprueba que N8N_COMMUNITY_PACKAGES_ENABLED no esté en false y recarga el editor.

Recursos#

• n8n-nodes-stac en npm
• Código en GitHub
• Documentación de community nodes de n8n

Base de conocimiento#

Los nodes de agente de n8n siempre envían su propio mensaje system — el campo "System Message" viene rellenado aunque nunca lo edites. Por eso, para fundamentar las respuestas en tus documentos, la clave usada aquí debe tener la base de conocimiento activada:

1. En el panel de control, ve a Claves de API.
2. En la clave que usa la credencial de n8n, abre ⋮ → Configuración.
3. Activa Base de conocimiento y elige Activada.

Una clave en "automático" — el estado de las claves creadas antes de que existiera esta opción — nunca consulta la base desde n8n, precisamente porque el node envía system en cada solicitud. El síntoma es silencioso: el modelo responde como si no hubiera ningún documento, sin error.

La persona del agente sigue viniendo del campo "System Message" del node: el fragmento recuperado se añade después de él, no en su lugar.

Próximos pasos#

• Compatibilidad OpenAI — la superficie que habla el nodo y qué difiere de OpenAI.
• Autenticación — formato de la clave, alcance, rotación.
• Base de conocimientos — fundamenta las respuestas del workflow en tus documentos, sin ningún nodo de búsqueda en el canvas.