Recursos · Integración n8n

Nodo Embeddings Google Vertex n8nConfigura Embeddings Google Vertex en n8n.

Un texto tiene que convertirse en números antes de que una base vectorial sepa encontrarlo. El nodo Embeddings Google Vertex n8n fabrica esos embeddings, vectores que miden el significado. Cabe en 2 parámetros y se engancha a un solo puerto. Para quien monta una base de conocimiento.

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

Por qué automatizar

¿Para qué sirve de verdad el nodo Embeddings Google Vertex n8n?

Es un subnodo, es decir una pieza que nunca se ejecuta sola y se engancha a un nodo raíz. Su trabajo cabe en una frase: manda un texto a Google Vertex y recibe un embedding, una lista de números que coloca ese texto en un mapa de significados. Después, un vector store, la base de datos pensada para guardar esos números, los usa para encontrar párrafos que dicen lo mismo con otras palabras.

Piensa en una inmobiliaria con sus condiciones de alquiler repartidas en varios documentos. La búsqueda por palabra clave falla en cuanto alguien pregunta de otra manera. Pasa esos textos por este nodo, guarda los vectores en una base vectorial, y una pregunta sobre la fianza llega al párrafo que habla de depósito. Con una condición: el mismo modelo al indexar y al preguntar, porque si no los números dejan de compararse.

Segundo uso, el asistente interno. El nodo raíz lleva la conversación, este convierte cada pregunta en vector sin que se note, y la base devuelve los fragmentos útiles antes de que se redacte la respuesta. Ese circuito se monta a menudo alrededor del nodo AI Agent, con el contexto recuperado colgando de él.

Tercera vía, sin chat de por medio: clasificar. Llegan fichas de producto desde una hoja de cálculo, se convierten en vectores, se comparan con unos pocos ejemplos ya etiquetados en la base y se devuelve la etiqueta más cercana. Aquí no hace falta ningún modelo de conversación. Es aritmética sobre el significado, y funciona en un flujo programado que lee Google Sheets y publica el resultado en Slack.

¿Cuándo elegir otra cosa? Si la cuenta que ya tienes abierta está en otro proveedor, el lado OpenAI del ecosistema cubre lo mismo, y cambiar más tarde obliga a reindexar todo lo guardado. Mejor decidirlo al principio. Y si tus textos nunca necesitan búsqueda por significado, un filtro sobre campos basta.

Conviene conocer los límites antes de empezar. Este nodo expone 2 parámetros, Project ID y Model Name, y nada más: sin control de lote, sin dimensión de vector, sin opción de reintento en el panel. Al no tener entrada principal, no se puede probar pulsando sobre él. Y Google factura las llamadas a la API de Vertex según tu contrato con ellos, n8n no añade nada encima. Para una mirada general a la plataforma, la Reseña n8n responde aparte.

Conexión

¿Cómo se autentica el nodo contra Google Cloud?

  1. 01

    Crea un credential de cuenta de servicio de Google

    La autenticación va por una cuenta de servicio de Google, el tipo de credential documentado para este nodo. En n8n, abre el menú Credentials, crea un credential de cuenta de servicio de Google y ponle un nombre que reconozcas dentro de unos meses. Un credential es un acceso guardado una sola vez y reutilizado por todos los flujos de la instancia, así que este paso no se repite aunque montes varias bases de conocimiento.

  2. 02

    Señala tu proyecto en el nodo

    De vuelta en el panel, rellena Project ID con el proyecto de Google Cloud donde vive tu acceso a Vertex. El campo es un resource locator: n8n puede listar los proyectos que ve el credential, o escribes el identificador a mano cuando la lista se hace larga. Elige el proyecto al que pertenece la cuenta de servicio, porque si no la llamada apunta a un proyecto sobre el que no tiene permisos.

  3. 03

    Engancha el nodo y ejecuta el padre

    Arrastra una conexión desde este nodo hasta el puerto de embeddings de un nodo raíz, una base vectorial o un agente. Después ejecuta ese padre. Como un subnodo no tiene entrada principal, el registro de ejecución muestra su actividad dentro del padre y no como paso independiente. Texto que entra y un array largo de números que sale: el credential funciona.

Conexiones

¿Dónde se engancha este nodo?

n8n reparte el trabajo de IA entre nodos raíz, que están en el flujo principal y reciben los items, y subnodos enganchados a un puerto, que solo despiertan cuando el raíz los necesita.

Salida (dónde se conecta)

  • Embeddingsai_embedding
01EmbeddingsEl nodo ofrece este puerto y ninguno más, y es una salida: no acepta conexiones entrantes, entrega vectores a quien se los pida. Colócalo en el lienzo y arrastra su conector hasta la ranura de embeddings del padre.

El nodo ofrece este puerto y ninguno más, y es una salida: no acepta conexiones entrantes, entrega vectores a quien se los pida. Colócalo en el lienzo y arrastra su conector hasta la ranura de embeddings del padre.

Una base vectorial en modo raíz es el padre habitual, porque necesita vectores tanto para escribir documentos como para releerlos. Un AI Agent llega a esos mismos vectores por la base que consulta, no por un enlace directo aquí.

Parámetros clave

  • Required: un nodo raíz que espera embeddings no arranca sin un subnodo enganchado, así que el puerto se llena o el flujo se detiene.
Casos de uso
un solo nodo para una sola base mantiene la colección coherente, porque todo se midió con el mismo modelo.
Parámetros

¿Qué controlan los 2 parámetros?

El nodo Embeddings Google Vertex 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

Project ID

projectId

Lo que ves en n8n

Notas y casos de uso

Señala el proyecto de Google Cloud sobre el que se autorizan y se facturan las llamadas de embedding. Sin él, el nodo tiene credential pero no sabe con qué proyecto hablar, y la ejecución se corta antes de convertir un solo texto.

Parámetros clave

  • Project ID: obligatorio y construido como resource locator, así que eliges tu proyecto de Google Cloud en la lista que n8n trae con el credential, o escribes el identificador directamente.
Casos de uso
los equipos que mantienen un proyecto de pruebas al lado del de producción cambian este campo, y solo este, el día que la base de conocimiento pasa a uso real.
02

Model Name

modelName

Lo que ves en n8n

Notas y casos de uso

Decide qué modelo de Vertex fabrica los vectores. Dos documentos procesados por modelos distintos dejan de ser comparables, así que este valor es el primero que conviene apuntar al crear un índice.

Parámetros clave

  • Model Name: campo de texto libre, no obligatorio, que acepta un identificador de modelo sacado de la referencia de la API de embeddings de texto de Google Vertex, enlazada en la descripción del nodo.
Casos de uso
cambiar el modelo en un índice que ya guarda miles de vectores obliga a reconstruirlo entero, así que prueba un valor nuevo sobre una copia, nunca sobre la base que un asistente consulta en vivo.
Necesitas ayuda

¿Necesitas ayuda para automatizar Embeddings Google Vertex con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Preguntas que llegan después

01¿El nodo Embeddings Google Vertex n8n viene incluido en n8n?
Sí. Forma parte del paquete de IA que se entrega con n8n, así que ya está disponible en n8n Cloud y en una instancia autoalojada con la Community Edition, bajo licencia Sustainable Use. No hay nada que instalar ni coste adicional por el lado de n8n, sea cual sea el alojamiento. Lo que sí se paga está en otro sitio: Google factura las llamadas a la API de Vertex que hace el nodo, según el contrato que tengas con ellos, y n8n no añade nada a esa factura. Un flujo montado en n8n Cloud se comporta igual al moverlo a una instalación con Docker.
02¿Qué hace falta para que funcione?
Un credential de cuenta de servicio de Google, el método de autenticación documentado para este nodo, y un identificador de proyecto de Google Cloud para rellenar Project ID. El credential se crea una vez desde el menú Credentials y lo reutilizan todos los flujos de la instancia. También hace falta un padre: este es un subnodo sin entrada principal, por lo que nunca aparece como un paso autónomo dentro de un flujo. Engánchalo al puerto de embeddings de una base vectorial o de otro nodo raíz y se pone a trabajar en cuanto ese nodo se ejecuta.
03¿Qué límites tiene este nodo?
Hace una sola cosa y expone 2 parámetros para ajustarla, Project ID y Model Name. La versión 1 no ofrece tamaño de lote, ni dimensión de vector, ni tiempo de espera desde el panel. Tampoco se prueba por separado: un subnodo sin entrada principal no tiene nada que procesar por su cuenta, así que cada comprobación pasa por el nodo raíz y su registro de ejecución. Y no guarda nada. Los vectores que produce viven en la base vectorial conectada, que es la pieza que se configura para la persistencia, el índice y la búsqueda.
04¿Qué hay que conectar como mínimo para empezar?
Un nodo raíz y este. Coge una base vectorial en modo raíz, engancha este nodo a su puerto de embeddings y la cadena de indexación ya funciona: el texto entra en la base y los vectores se escriben a su lado. Después añade la lectura. Un segundo flujo consulta la misma base y los fragmentos alimentan a un agente o a un simple aviso. Empieza con pocos documentos, un puñado en vez de un archivo entero, y comprueba que una pregunta hecha con tus palabras devuelve el párrafo correcto antes de ampliar la colección.
05¿n8n o Make para un flujo de embeddings con Vertex?
Depende de dónde quieras que vivan los datos. n8n se autoaloja con Docker o npm, así que los textos pasan por tu máquina antes de la llamada a Vertex, y el mismo flujo funciona igual en n8n Cloud. Make solo existe alojado, sin opción de autoalojamiento, y se factura por operación, lo que cambia las cuentas en cuanto un flujo indexa documentos en volumen. La lógica visual también difiere: n8n dibuja los subnodos como piezas colgadas del nodo raíz, algo que encaja con el trabajo de IA y deja leer de un vistazo la cadena de embeddings, base y agente.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.