Recursos · Integración n8n

Nodo Supabase Vector Store n8nConfigura Supabase Vector Store en n8n.

Una búsqueda vectorial busca significado, no palabras. El nodo Supabase Vector Store n8n trabaja sobre una tabla de tu propio proyecto Supabase, con 2 parámetros y 5 modos que cubren inserción, búsqueda, actualización y consulta por un agente. Para quien prefiere quedarse con sus documentos.

Probar el nodo Supabase Vector Store en n8nVer los 2 parámetros

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

Por qué automatizar

¿Para qué sirve el nodo Supabase Vector Store n8n?

El nodo lee y escribe en una tabla de Supabase que guarda vectores, es decir representaciones numéricas de tus textos: así una búsqueda devuelve los fragmentos cercanos en significado a una pregunta, y no solo los que repiten las mismas palabras. Dentro de un flujo funciona como nodo de acción normal, ejecutándose en cada item de entrada, o como recurso que un modelo consulta. Un parámetro elige el comportamiento y el otro elige la tabla.

Primer escenario: documentación técnica que hay que poder preguntar. Un flujo recoge los manuales, los trocea y pasa el nodo a modo insert contra una tabla de Supabase. Otro flujo reutiliza el mismo nodo en modo load, con un Prompt y un Limit, y devuelve los fragmentos más cercanos a lo que preguntó quien escribe. Los documentos nunca salen del proyecto Supabase que ya tienes.

Segundo escenario: un asistente que decide solo cuándo consultar. Ahí el nodo va en modo retrieve-as-tool y se engancha al conector de herramientas de un AI Agent. El Name y la Description que escribes los lee el propio modelo antes de elegir la herramienta: una descripción floja es el motivo más repetido de que un agente ignore una base perfectamente cargada. Es el patrón de la plantilla pública 2621, donde el agente conversa con archivos guardados en Supabase.

Tercer escenario: mantener la base al día. Cambia un procedimiento, cambia una tarifa, y el fragmento viejo sigue en la tabla listo para salir. El modo update toma el ID de una entrada existente y la sustituye. Esa es la diferencia entre una base que envejece bien y otra que responde con las condiciones del año pasado.

Cuándo conviene otra cosa. Si lo que buscas es una fila por una clave conocida, un identificador exacto, una consulta normal a la tabla va más rápida y sale más barata que una búsqueda por similitud. Si una cadena solo necesita que le pasen documentos, el modo retrieve alimenta un retriever en vez de un agente. Y si quieres una respuesta redactada en lugar de fragmentos crudos, el Vector Store Question Answer Tool se coloca entre el agente y este nodo.

Los límites, antes de montar nada. El nodo cubre 5 modos y ninguno más: borrar filas o reindexar se hace en Supabase. No tiene puertos de subnodo, así que el modelo de embedding que convierte el texto en vectores se elige en otra parte del flujo, con un credential (unas credenciales guardadas una sola vez en n8n) de un proveedor como OpenAI o Google Gemini, que cobra sus propias llamadas. Además la tabla debe existir antes, creada desde el quickstart de vector store de Supabase, junto con la función de coincidencia que el nodo invoca. Para ver dónde encaja la pieza, la Reseña n8n y el Curso n8n cubren el resto de la cadena.

Conexión

¿Cómo se conecta Supabase con n8n?

  1. 01

    Activa la Data API y copia la URL del proyecto

    El credential entra por la Data API de Supabase, que tiene que estar activada. En el dashboard de Supabase abre el proyecto al que quieres que llegue n8n, entra en Integrations y luego en Data API, y copia el Project URL que aparece ahí. Ese valor va al campo Host de n8n. Esa misma pantalla te dice si la Data API está activa, así que mírala antes de culpar a la clave.

  2. 02

    Crea una clave secreta

    Sigue en Supabase y abre Project Settings y después API Keys. Crea una clave secreta, o revela una ya existente, y tenla a mano para pegarla. Es lo que n8n guarda en Secret Key. Los credentials que aún usan un secreto service_role heredado siguen funcionando, pero Supabase está retirando esas claves antiguas y dejan de servir a finales de 2026, así que crea una clave secreta nueva en vez de arrastrar la anterior.

  3. 03

    Guarda el credential en n8n

    En n8n abre Credentials, crea un credential de Supabase y pega el Host y la Secret Key. Un credential se guarda una vez y lo reutilizan todos los flujos de la instancia: la misma entrada sirve para este nodo y para el nodo Supabase normal. Guárdalo, abre el nodo vector store y elige tu tabla. En cuanto el credential responde, la lista de tablas se rellena sola y dejas de escribir nombres a mano.

Parámetros

¿Qué parámetros pide el nodo?

El nodo Supabase Vector Store 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

Operation Mode

mode

Lo que ves en n8n

Notas y casos de uso

Este selector manda sobre todo lo demás. Se ajusta primero, porque los campos de abajo cambian con él.

Parámetros clave

  • Operation Mode: insert escribe documentos, load devuelve los mejor clasificados, retrieve alimenta una cadena, retrieve-as-tool expone la base a un agente, update sustituye un documento por su ID.
  • Name y Description: obligatorios en modo herramienta, los lee el modelo antes de elegir la herramienta.
  • Prompt, Limit, Include Metadata, Rerank Results: el lado de la búsqueda, Prompt a menudo {{ $json.question }}.
  • ID: obligatorio en modo update.
  • Options: contiene Query Name, o sea match_documents tras el quickstart, y Metadata Filter.
Casos de uso
un flujo en insert que llena la base y otro en load que responde preguntas.
02

Table Name

tableName

Lo que ves en n8n

Notas y casos de uso

Todos los modos leen o escriben en una tabla, y aquí se indica cuál. Tiene que existir en Supabase antes de ejecutar, con la columna vectorial y la función de coincidencia del quickstart.

Parámetros clave

  • Table Name: obligatorio, en forma de resource locator, o sea un campo que ofrece una lista en cuanto el credential funciona y que también acepta un valor escrito o una expresión como {{ $json.table }} cuando la tabla cambia de un item a otro.
Casos de uso
una tabla por dominio, la documentación de producto por un lado y los procedimientos internos por otro, y luego cambiar de tabla en el selector en vez de filtrar una única base saturada en cada consulta.
Necesitas ayuda

¿Necesitas ayuda para automatizar Supabase Vector Store con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Lo que se pregunta después

01¿El nodo Supabase Vector Store n8n es gratis?
Sí, tanto en n8n Cloud como en una instancia propia. El nodo viene en el paquete de IA que se entrega con n8n: nada que instalar y ningún coste extra por parte de n8n, uses la oferta alojada por n8n o tu propia instalación con Docker o npm en Community Edition, bajo licencia Sustainable Use. Un flujo se comporta igual en ambos casos. Lo que sí cuesta está fuera de n8n: tu proyecto de Supabase y el proveedor del modelo de embedding que convierte tus textos en vectores, que factura sus propias llamadas de API según sus condiciones.
02¿Qué credenciales hace falta para conectarlo?
Un credential de Supabase, hecho con dos valores. El nodo se autentica con clave de API: rellenas un Host, que es la URL del proyecto copiada de la pantalla Data API, y una Secret Key creada en Project Settings y luego API Keys. La Data API tiene que estar activada en el proyecto o no conecta nada. Los credentials que todavía usan un secreto service_role heredado siguen funcionando, pero Supabase está retirando esas claves antiguas y dejan de servir a finales de 2026, así que crea una clave secreta nueva. El credential se guarda una vez y vale para todos los flujos.
03¿Qué límites tiene este nodo?
Hace cinco cosas y ahí se acaba. La versión 1 del nodo cubre insertar, recuperar varios documentos, ponerlos a disposición de una cadena, exponerse como herramienta de agente y actualizar por ID. Borrar entradas, cambiar el esquema o reindexar se hace dentro de Supabase, no aquí. El nodo también da por hecho que la tabla y la función de coincidencia ya existen, según el quickstart de vector store de Supabase, y unos ajustes distintos a los del quickstart cambian lo que hay que poner en los parámetros. Sin puertos de subnodo, nunca elige él el modelo de embedding.
04¿Qué hay que conectarle para que funcione?
Como mínimo un credential de Supabase y un modelo de embedding en el flujo, porque alguien tiene que producir los vectores antes de guardarlos o compararlos. Lo demás depende del modo. En insert le das documentos cargados y troceados antes. En retrieve-as-tool el nodo se enlaza al conector de herramientas de un agente de IA, con un Name y una Description claros. En retrieve, un retriever se coloca entre el nodo y una cadena. Para un primer montaje, insert y después load es lo más fácil de depurar, porque ves lo que vuelve.
05¿n8n o Make para una base vectorial?
Depende de dónde pueden vivir tus documentos y de cómo quieres pagar. n8n se auto-aloja con Docker o npm, o corre en n8n Cloud, así que una cadena de recuperación sobre documentos sensibles puede quedarse en una infraestructura que controlas, al lado del proyecto de Supabase que guarda los vectores. Make solo existe alojado, sin opción de auto-alojamiento, y factura por operación, lo que se lee distinto cuando una sola carga inicial toca miles de fragmentos. Los dos son visuales. Decide por el alojamiento, el control de los datos y el modelo de coste.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.

Misma plataforma

Otros docs útiles sobre este stack.

Ver todas las integraciones