Recursos · Integración n8n

Nodo Embeddings Hugging Face Inference n8nConfigura Embeddings Hugging Face Inference en n8n.

Ningún asistente encuentra nada en tus documentos si antes no se han convertido en vectores. El nodo Embeddings Hugging Face Inference n8n hace esa conversión, con 2 parámetros y sin entrada principal. Se engancha al puerto Embeddings de un nodo raíz, pensado para equipos que indexan su propia base.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo Embeddings Hugging Face Inference n8n?

El nodo llama al servicio Hugging Face Inference para convertir un texto en un embedding, es decir una serie de números que coloca ese texto en un espacio donde los significados parecidos quedan cerca unos de otros. Nunca se ejecuta solo: es un subnodo, un nodo pequeño que se engancha a otro más grande en lugar de cablearse en el flujo principal, y es ese nodo raíz quien le pide los vectores.

Primer uso: la indexación. Un vector store, la base que guarda los vectores, parte tus documentos y envía cada fragmento al nodo para recibir su representación numérica. En pantalla no pasa nada llamativo durante esa pasada, pero es lo que hace respondible una pregunta hecha tres días después. El catálogo cuenta 2 parámetros en el nodo, así que una vez creada la credencial queda poco que tocar.

Segundo uso: la búsqueda. El nodo raíz vectoriza la pregunta entrante por el mismo camino y compara el resultado con lo indexado. Aquí está la trampa que más cuesta: el modelo que indexó tiene que ser el que busca. Dos modelos distintos generan vectores que no se comparan, y la búsqueda devuelve ruido sin lanzar ningún error.

Tercer uso: aligerar la factura de un agente. Vectorizar una pregunta corta cuesta mucho menos que una llamada completa a un modelo de chat, de ahí la caché semántica colocada delante de un AI Agent para comprobar si una pregunta parecida ya tiene respuesta. La plantilla pública 10887 monta ese esquema con un Redis Vector Store y un OpenAI Chat Model.

¿Cuándo conviene otro subnodo? Si tu modelo de chat ya viene de un proveedor que pagas, por ejemplo OpenAI, dejar los embeddings en ese mismo sitio evita mantener dos credenciales. Este nodo gana cuando quieres un modelo de Hugging Face, tu propio endpoint de inferencia, o un proveedor elegido a mano en la colección Options.

Dos límites antes de construir. El nodo va por la versión 1 y no expone nada más que el nombre del modelo y sus opciones: ni tamaño de lote, ni dimensión, ni reintentos. Y como no tiene entrada principal, no puedes ejecutarlo suelto para ver qué devuelve, lanzas el nodo raíz y miras qué llega al store. Para una mirada más amplia sobre la plataforma está la Reseña n8n, y el Curso n8n recorre la cadena entera.

Conexión

¿Qué hay que conectar antes de lanzarlo?

  1. 01

    Crea la credencial de Hugging Face

    Entra en el menú Credentials de n8n y añade la credencial de Hugging Face que pide el nodo. Una credencial es el acceso que n8n guarda para un servicio: se crea una vez y todos los workflows de la instancia la reutilizan. La cuenta de Hugging Face asociada la factura el propio servicio según sus condiciones, y n8n no añade nada encima.

  2. 02

    Selecciónala en el nodo

    Coloca el nodo en el lienzo desde el puerto Embeddings de tu nodo raíz y elige la credencial en el campo superior del panel. Este nodo no tiene selector de autenticación, así que hay una sola decisión y ninguna más. Si ese campo queda vacío, quien se detiene en la ejecución es el nodo raíz, y por eso el mensaje de error parece señalar al nodo equivocado.

  3. 03

    Pasa un solo documento

    Antes de indexar una carpeta entera, manda un único item al nodo raíz y comprueba que en el store aparece un vector. Es la forma más rápida de detectar una credencial guardada pero nunca seleccionada, o un nombre de modelo mal escrito. Con esa pasada en verde, la misma rama procesa el resto de documentos sin más ajustes.

Conexiones

¿Dónde se engancha este nodo?

Los workflows de IA en n8n siguen un modelo de nodo raíz y subnodos: el nodo raíz recibe los items en el flujo principal y los subnodos se conectan a sus puertos, un tipo de subnodo por puerto. Este no tiene entrada principal, solo la salida que sigue.

Salida (dónde se conecta)

  • Embeddingsai_embedding
01EmbeddingsEs la razón de ser del nodo. El nodo raíz le pide vectores tanto al guardar un texto como al buscarlo, y la respuesta viaja sin aparecer nunca en la línea principal del workflow.

Es la razón de ser del nodo. El nodo raíz le pide vectores tanto al guardar un texto como al buscarlo, y la respuesta viaja sin aparecer nunca en la línea principal del workflow.

Parámetros clave

  • Required: hace falta un nodo raíz con puerto Embeddings; sin él, el subnodo se queda en el lienzo sin recibir nada.
Casos de uso
un Default Data Loader trocea un PDF, el store llama a este nodo fragmento a fragmento y luego un agente responde con lo indexado.
Parámetros

¿Qué parámetros se tocan de verdad?

El nodo Embeddings Hugging Face Inference tiene 2 parámetros. Para cada uno: el nodo tal como lo configuras en n8n, qué cambia el parámetro y nuestras notas de campo.

01

Model Name

modelName

Lo que ves en n8n

Notas y casos de uso

Este campo indica el modelo a usar de la biblioteca de Hugging Face. Decide cómo se convierte el texto en vectores, así que debe ser el mismo en la rama que indexa y en la que consulta.

Parámetros clave

  • Model Name: el nombre del modelo a usar de la biblioteca de Hugging Face, escrito como texto, o traído de un nodo anterior con {{ $json.model }} cuando el workflow cambia de modelo según el cliente.
Casos de uso
una base de soporte indexada una vez con un modelo concreto y consultada cada día por un agente que repite ese mismo valor.
02

Options

options

Lo que ves en n8n

Notas y casos de uso

Options es la colección que se abre con Add Option cuando la llamada por defecto se queda corta. Cerrada, el nodo consulta Hugging Face Inference solo con el nombre del modelo, y eso basta en casi toda indexación.

Parámetros clave

  • Custom Inference Endpoint: la URL de un modelo desplegado por ti en Hugging Face; en cuanto está rellena, n8n ignora Model Name y llama a esa dirección.
  • Provider: elige quién sirve la inferencia, desde hf-inference hasta groq, together, cohere o replicate, con auto dejando la decisión abierta.
Casos de uso
un equipo con su modelo detrás de un endpoint propio apunta el nodo a esa URL y deja intacto el resto de la cadena.
Necesitas ayuda

¿Necesitas ayuda para automatizar Embeddings Hugging Face Inference con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Las preguntas que vienen después

01¿El nodo Embeddings Hugging Face Inference viene incluido en n8n?
Sí. Forma parte del paquete de IA que se entrega con n8n, así que está disponible tanto en n8n Cloud como en una instancia autoalojada, sin instalar nada y sin coste extra por parte de n8n. El autoalojamiento va por Docker o npm, en Community Edition con licencia Sustainable Use, y un workflow se comporta igual en los dos escenarios. Lo que sí se factura está al otro lado: el servicio Hugging Face Inference cobra sus propias llamadas de API según sus condiciones, e indexar una base grande genera muchas. El nodo no cambia eso, solo decide qué modelo recibe el texto.
02¿Qué hace falta para que funcione?
Una credencial de Hugging Face, creada una sola vez en el menú Credentials de n8n y reutilizable después en todos los workflows de la instancia. El nodo no tiene selector de autenticación, así que no hay método que elegir, solo la credencial que enlazar. También hace falta un nodo raíz con puerto Embeddings, porque esto es un subnodo: sin entrada principal, sin ejecución aislada, responde únicamente cuando un vector store o una cadena le pide vectores. Si una ejecución no produce nada, revisa primero la credencial y después que el subnodo esté realmente conectado al puerto y no simplemente colocado al lado.
03¿Qué límites tiene este nodo?
Se mantiene deliberadamente pequeño. El catálogo indica versión 1 y 2 parámetros, el nombre del modelo y una colección Options con Custom Inference Endpoint y Provider dentro. No hay tamaño de lote, ni dimensión, ni reintentos que ajustar desde el panel. Tampoco se prueba por separado al no tener entrada principal: ejecutas el nodo raíz y lees lo que ha llegado al store. Una última restricción viene de los embeddings y no de n8n, el modelo que indexa y el que busca tienen que coincidir, de modo que cambiar Model Name sobre un store ya lleno obliga a reindexar ese contenido.
04¿A qué se conecta el nodo Embeddings Hugging Face Inference n8n?
Al puerto Embeddings de un nodo raíz, que en la práctica es un vector store o una cadena que guarda y recupera texto. Empezar por Simple Vector Store acorta la primera prueba, porque no hay que aprovisionar nada fuera de n8n para ver si la indexación funciona. Cuando la rama ya está validada, cambiar a Supabase Vector Store o Redis Vector Store mueve los vectores sin tocar este nodo. En el lado de la consulta, el mismo subnodo lo reutiliza el nodo raíz que alimenta a un agente, así que una única configuración cubre indexar y buscar.
05¿n8n o Make para este tipo de workflow de IA?
La respuesta honesta depende de tres criterios. El alojamiento primero: n8n corre en tu propio servidor con Docker o npm además de en n8n Cloud, mientras que Make solo existe alojado, lo que decide rápido cuando los documentos no pueden salir de tu infraestructura. El modelo de coste después, porque Make factura por operación y una pasada de indexación sobre una base documental multiplica esas operaciones. El control de los datos al final, casi siempre determinante en un sector regulado. Make sigue siendo agradable de montar visualmente, y muchos workflows nunca chocan con esas restricciones.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.