Recursos · Integración n8n

Nodo Chroma Vector Store n8nConfigura Chroma Vector Store en n8n.

El nodo Chroma Vector Store n8n conecta una colección de Chroma con tu flujo de trabajo, para leer y para escribir. Un solo nodo, cuatro modos de operación y tres parámetros: el modo, la colección de destino y la elección entre una instancia autoalojada y Chroma Cloud.

Probar el nodo Chroma Vector Store en n8nVer los 3 parámetros

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

Por qué automatizar

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

Chroma es una base de datos vectorial y este nodo es la puerta de n8n hacia ella. Escribe documentos en forma de embeddings, la representación numérica de un texto que permite buscar por significado y no por palabras exactas, y los recupera ordenados por cercanía a una pregunta. Viene dentro del paquete de IA de n8n, se ejecuta sobre cada item entrante como cualquier nodo de acción y reúne cuatro trabajos distintos detrás de un único selector Operation Mode.

Empecemos por llenar la base. Con el modo insert, el nodo toma los documentos que llegan a su entrada y los escribe en la colección de Chroma elegida. Políticas internas, fichas de producto, respuestas tipo de atención al cliente: cualquier cosa que circule por el flujo como texto. El hábito que marca la diferencia es colgar esa rama de un disparador programado, para que la colección siga a la fuente en lugar de congelarse en la primera carga.

El segundo trabajo es la búsqueda a secas, sin ningún agente alrededor. El modo load, etiquetado Get Many, recibe un Prompt y devuelve los documentos más cercanos. Llega un mensaje a Slack, el nodo recupera los pasajes que responden, y la contestación sale con sus fuentes puestas. Lo mismo con un correo que entra por Gmail: primero se busca, después se redacta.

El tercero es el que casi todo el mundo viene a buscar. retrieve-as-tool convierte la colección en una herramienta, es decir en una capacidad que un agente puede invocar por su cuenta cuando cree que la necesita, y ese es el modo que se enchufa a un AI Agent. Los campos Name y Description pesan más de lo que parecen: la descripción es lo único que el modelo lee antes de decidir si llama a la herramienta. El modo retrieve hace ese mismo favor a una cadena en vez de a un agente.

¿Cuándo conviene otra cosa? Cuando la búsqueda es exacta. Un número de pedido, un identificador de cliente, un código de país: una búsqueda de fila corriente va más rápida, sale más barata y nunca devuelve un resultado aproximado. La similitud gana terreno en cuanto la pregunta está escrita en lenguaje humano y la respuesta vive dentro de un párrafo. Y ojo con el gasto: el proveedor de los embeddings, OpenAI u otro, factura sus propias llamadas de API; n8n no añade nada encima.

Los límites, para que no sorprendan luego. El nodo está en la versión 1 y expone esos cuatro modos, ni uno más: no borra documentos ni administra colecciones. El campo Chroma Collection es obligatorio, así que la colección existe antes de la primera ejecución. Y Chroma guarda lo que le das, de modo que un documento caducado se sigue encontrando hasta que la rama que lo escribió lo reemplace. Si todavía estás comparando plataformas antes de montar nada, la Reseña n8n entra en ese detalle.

Conexión

¿Cómo se conecta n8n con Chroma?

  1. 01

    Elige el tipo de autenticación

    Abre el nodo y empieza por el selector Authentication, porque de él depende qué credencial te pedirá n8n después. Hay dos opciones y ninguna más: chromaSelfHostedApi, etiquetada Self-Hosted, se conecta a una instancia de ChromaDB que mantienes tú, y chromaCloudApi, etiquetada Cloud, se conecta a Chroma Cloud. La correcta es la que coincide con el sitio donde ya viven los documentos.

  2. 02

    Crea la credencial una sola vez

    Una credencial en n8n es un conjunto de datos de conexión guardado aparte del flujo. Créala desde el menú Credentials, o desde el propio nodo con la opción Create New, y queda reutilizable: cualquier otro flujo que toque la misma instancia de Chroma apunta a esa única entrada. ¿Hay que cambiar una clave más adelante? Se cambia en un sitio, no nodo por nodo.

  3. 03

    Selecciona la colección

    Último paso, el campo Chroma Collection. Es un resource locator, el control de n8n que deja elegir de una lista, pegar un identificador o componer el valor con una expresión como {{ $json.collection }} cuando el nombre viene de un nodo anterior. El campo es obligatorio y la lista solo se rellena con una credencial válida: por eso este paso va el tercero y no el primero.

Parámetros

¿Qué parámetros hay que ajustar en el nodo?

El nodo Chroma Vector Store tiene 3 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 decide qué es el nodo aquí: escritor, búsqueda o herramienta de un nodo de IA. Se ajusta el primero.

Parámetros clave

  • Operation Mode: load (Get Many) devuelve documentos ordenados, insert (Insert Documents) los escribe, retrieve (Retrieve Documents (As Vector Store for Chain/Tool)) sirve a una cadena, retrieve-as-tool (Retrieve Documents (As Tool for AI Agent)) sirve a un agente.
  • Prompt y Limit: el texto buscado, a menudo {{ $json.question }}, y cuántos resultados vuelven.
  • Name y Description: lo que ve un agente, por ejemplo company_knowledge_base.
  • Include Metadata, Rerank Results, Options, ID: los metadatos, una segunda ordenación, las opciones y una entrada.
Casos de uso
una rama en insert refresca la colección cada noche y otra en retrieve-as-tool sirve a un agente.
02

Authentication

authentication

Lo que ves en n8n

Notas y casos de uso

Aquí no se habla de búsqueda: este parámetro dice a qué Chroma debe llegar el nodo y, por tanto, qué tipo de credencial muestra n8n debajo.

Parámetros clave

  • Authentication: chromaSelfHostedApi (Self-Hosted) conecta con una instancia de ChromaDB autoalojada, chromaCloudApi (Cloud) conecta con Chroma Cloud.
Casos de uso
un equipo que guarda los documentos en sus propios servidores se queda en Self-Hosted y nada sale de la red. Una estructura pequeña, sin servidor que mantener, elige Cloud y encuentra el mismo comportamiento del nodo. Cambiar más tarde consiste en crear la otra credencial: el modo, el prompt y la colección se quedan como estaban.
03

Chroma Collection

chromaCollection

Lo que ves en n8n

Notas y casos de uso

Una instancia de Chroma aloja varias colecciones y este campo señala cuál lee o alimenta el nodo. Es obligatorio: vacío, detiene el nodo antes de hacer nada.

Parámetros clave

  • Chroma Collection: un resource locator, así que el valor sale de la lista, de un identificador pegado o de una expresión como {{ $json.collection }}.
Casos de uso
una colección por idioma o por cliente convierte este único campo en la lógica de reparto. El flujo calcula el nombre antes, lo mete en la expresión y una sola rama atiende a todos, en lugar de duplicar el nodo para cada público.
Necesitas ayuda

¿Necesitas ayuda para automatizar Chroma Vector Store con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Chroma Vector Store en n8n, preguntas frecuentes

01¿El nodo Chroma Vector Store viene incluido en n8n?
Sí. Pertenece al paquete de IA de n8n y llega con n8n, tanto en n8n Cloud como en una instancia autoalojada: nada que instalar, ningún sobrecoste por el lado de n8n, y un flujo se comporta igual en los dos sitios. Lo que sí cuesta está fuera. El proveedor cuyos embeddings uses factura sus propias llamadas de API según sus condiciones. Chroma, por su parte, es una instancia que alojas tú o una cuenta de Chroma Cloud, según la opción elegida en el selector Authentication. Así que el nodo es gratuito, los servicios de alrededor siguen su propia tarifa y n8n no se lleva nada por el camino.
02¿Qué hace falta para que el nodo Chroma Vector Store n8n funcione?
Tres cosas, y encajan con los tres parámetros. Primero una elección en Authentication: Self-Hosted para una instancia de ChromaDB que gestionas tú, Cloud para Chroma Cloud. Esa elección determina el tipo de credencial. Después la credencial en sí, creada una vez desde el menú Credentials y reutilizada por todos los flujos que tocan la misma instancia. Y por último una colección, elegida en el campo Chroma Collection o construida con una expresión; es obligatoria, y un valor vacío detiene la ejecución. Con esos tres puntos resueltos solo queda elegir el modo de operación, que manda sobre el resto del panel.
03¿Qué límites tiene el nodo?
Está en la versión 1 y el selector Operation Mode ofrece cuatro opciones: Get Many, Insert Documents, Retrieve Documents como base vectorial para una cadena o herramienta, y Retrieve Documents como herramienta para un agente. Lo que se sale de esos cuatro modos se sale del nodo. Ninguno borra documentos ni administra colecciones, de modo que la colección tiene que existir antes de la primera ejecución, y por eso mismo el campo Chroma Collection es obligatorio y no opcional. Del lado de la lectura la superficie de ajuste es corta a propósito: un Prompt, un Limit, Include Metadata, Rerank Results, una colección Options y un ID para una entrada concreta.
04¿Qué se le enchufa dentro de un flujo de IA?
Nada, y esa es la respuesta útil. Los flujos de IA de n8n se construyen con un nodo raíz y subnodos, esos nodos pequeños que se conectan a sus puertos y nunca se ejecutan solos. Este no es un padre de ese tipo: funciona como un nodo de acción normal, una vez por cada item entrante. En los dos modos Retrieve es él quien se conecta a otro sitio, ya sea como base vectorial de una cadena o como herramienta que un agente invoca cuando considera que la pregunta pide un documento. En Get Many e Insert Documents se queda como un paso más de la línea, recibe items y pasa el resultado.
05¿n8n o Make para un flujo con Chroma?
Depende de dónde pueden vivir los documentos. Make es una plataforma alojada, sin opción de autoalojamiento y facturada por operación: cómoda cuando nadie quiere mantener un servidor y basta con un editor visual predecible. n8n funciona igual de bien con Chroma Cloud que contra una instancia de ChromaDB puesta dentro de la red interna, y ese punto decide en cuanto los documentos son contratos, historiales o expedientes delicados. Hay otro detalle práctico: un flujo de recuperación se repite mucho mientras se ajusta, y una facturación por operación se nota más justo en ese momento. Ninguna respuesta es falsa, decide la restricción.
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