Recursos · Integración n8n

Nodo Character Text Splitter n8nConfigura Character Text Splitter en n8n.

Un informe de doscientas páginas no cabe entero en ninguna parte. El nodo Character Text Splitter n8n lo corta en fragmentos a partir de una secuencia de caracteres, con 3 parámetros que ajustar: Separator, Chunk Size y Chunk Overlap. Es un subnodo, o sea un ayudante que se engancha a otro nodo y nunca se ejecuta solo.

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

Por qué automatizar

¿Para qué sirve el nodo Character Text Splitter n8n?

Recoge el texto que le pasa un cargador de documentos y lo parte en fragmentos más pequeños, con una secuencia de caracteres como punto de corte y un número de caracteres como tamaño máximo. Cada fragmento repite el final del anterior, así una frase partida en dos sigue entendiéndose por los dos lados. El nodo no se ejecuta por su cuenta: se engancha al puerto Text Splitter de un nodo raíz, que es el nodo que recibe los items del flujo y dirige a sus ayudantes.

Primer escenario: una base de conocimiento alimentada con archivos. Un cargador lee un pliego o un manual interno, este nodo lo corta según Chunk Size, y los fragmentos se guardan para recuperarlos después. Si el fragmento es demasiado grande, la frase útil se pierde entre ruido. Si es demasiado pequeño, se corta el hilo del párrafo. Es el ajuste al que más veces vuelves.

Segundo escenario: el resumen de un documento extenso. Una cadena de resumen no lee cien páginas de una vez, lee los fragmentos que salen de aquí y los recompone. Ahí Separator se gana el sueldo: corta en una línea en blanco y cada fragmento empieza donde empieza un párrafo, no a mitad de palabra.

Tercer escenario: un asistente que responde con tus propios documentos. Una vez troceado y guardado el texto, un AI Agent busca el pasaje correcto antes de contestar, y el modelo de chat, de OpenAI o de otro proveedor, redacta. La calidad se decide al trocear, mucho antes de que el modelo vea nada.

¿Cuándo saltárselo? Cuando el texto ya llega troceado, un registro limpio por item, por ejemplo desde Google Sheets: cortar una celda que ya es corta solo añade un solape que no necesitabas. Y cuando la estructura pesa más que la longitud, encaja mejor un divisor que respete los límites de un código o de un markdown que un corte por caracteres.

Conviene conocer los límites antes de empezar. El nodo cuenta caracteres, no tokens del modelo, así que el tamaño que eliges es una aproximación de lo que el modelo leerá de verdad. No tiene entrada principal ni credencial, o sea que aquí nada habla con una API. Y expone 3 parámetros, ni uno más: lo demás pertenece al nodo raíz al que alimenta. Para situar n8n en conjunto, la Reseña n8n lo repasa, y el Curso n8n monta este tipo de flujo de principio a fin.

Conexiones

¿Dónde se engancha este subnodo?

n8n separa los nodos raíz, que reciben los items del flujo, de los subnodos, que se conectan a sus puertos y hacen una sola cosa cada uno. Este es un subnodo: solo tiene salida.

Salida (dónde se conecta)

  • Text Splitterai_textSplitter
01Text SplitterEl nodo se conecta al puerto Text Splitter de un nodo raíz y le entrega los fragmentos que ha generado. Arrastra el conector desde ese puerto, elige Character Text Splitter, y el nodo raíz deja de tratar el documento como un bloque único.

El nodo se conecta al puerto Text Splitter de un nodo raíz y le entrega los fragmentos que ha generado. Arrastra el conector desde ese puerto, elige Character Text Splitter, y el nodo raíz deja de tratar el documento como un bloque único.

Parámetros clave

  • Optional: un nodo raíz funciona sin divisor conectado, y empieza a usar uno en cuanto lo enganchas a este puerto.
  • Default Data Loader: el cargador que lee tus datos de documento, el sitio habitual para enganchar este divisor antes de guardar el texto.
  • Summarization Chain: el nodo raíz que resume textos largos y necesita el documento partido en pasadas legibles.
Casos de uso
un manual de procedimientos entra por Default Data Loader, se trocea aquí y acaba en un almacén que tu agente puede consultar.
Parámetros

¿Cómo se ajustan los 3 parámetros?

El nodo Character Text Splitter 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

Separator

separator

Lo que ves en n8n

Notas y casos de uso

Es la secuencia de caracteres que el nodo busca para decidir dónde cortar. Divide el documento en items separados justo en ese punto, de modo que el corte caiga en una frontera con sentido y no en mitad de una palabra.

Parámetros clave

  • Separator: un valor de texto que escribes, un salto de línea para prosa, una coma para una lista de entradas. Tíralo del item entrante con {{ $json.separator }} cuando cada tipo de documento tiene su propia frontera.
Casos de uso
una exportación de preguntas frecuentes donde cada respuesta ocupa su párrafo se corta limpia en una línea en blanco, y cada fragmento abarca una sola pregunta.
02

Chunk Size

chunkSize

Lo que ves en n8n

Notas y casos de uso

Chunk Size pone el techo a lo que cabe en un fragmento. Es el número máximo de caracteres por fragmento, y decide cuánto contexto viaja junto cuando ese trozo se guarda o se vuelve a leer.

Parámetros clave

  • Chunk Size: un número de caracteres, escrito a mano o gobernado por una expresión como {{ $json.chunkSize }} cuando notas breves e informes largos comparten el mismo flujo.
Casos de uso
un manual de producto troceado fino devuelve pasajes precisos en una búsqueda, mientras que el mismo manual troceado grueso da a una cadena de resumen menos pasadas y más completas.
03

Chunk Overlap

chunkOverlap

Lo que ves en n8n

Notas y casos de uso

El solape es el final de un fragmento repetido al principio del siguiente. Este ajuste fija el número de caracteres compartidos entre fragmentos consecutivos, para que una frase partida por la mitad conserve su sentido a ambos lados.

Parámetros clave

  • Chunk Overlap: un recuento de caracteres, bastante por debajo de Chunk Size para que los fragmentos sigan siendo distintos, o variable por documento con {{ $json.chunkOverlap }}.
Casos de uso
una cláusula de contrato que cruza la frontera entre dos fragmentos mantiene sus primeras palabras en el siguiente, y una búsqueda sobre esa cláusula la encuentra entera.
Necesitas ayuda

¿Necesitas ayuda para automatizar Character Text Splitter con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

Character Text Splitter en n8n, resuelto

01¿El nodo Character Text Splitter viene incluido en n8n?
Sí. Forma parte del paquete de IA de n8n, @n8n/n8n-nodes-langchain, que se entrega con n8n. No hay nada que instalar ni sobrecoste alguno por el lado de n8n, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition bajo licencia Sustainable Use. El flujo se comporta igual en los dos casos. Este nodo no hace llamadas de API por su cuenta, así que tampoco añade coste de proveedor. Lo que se factura en un flujo de IA viene del proveedor del modelo conectado más arriba, OpenAI, Anthropic, Google o Mistral, con sus propias condiciones.
02¿Qué hace falta para que funcione el nodo Character Text Splitter n8n?
Nada que autenticar. Este nodo no tiene credencial, es decir el acceso guardado en n8n para entrar en un servicio, ni selector Authentication. Ninguna cuenta que conectar, ninguna clave que pegar, ningún permiso que aprobar. La credencial la lleva el subnodo de modelo conectado en otro punto del mismo montaje. Lo que sí necesita es un nodo raíz al que engancharse por su puerto Text Splitter, porque no tiene entrada principal y nunca corre solo. Conéctalo a un Default Data Loader o a una Summarization Chain, ajusta los 3 parámetros y funciona desde la primera ejecución.
03¿Qué límites tiene este nodo?
Corta por caracteres, y solo por caracteres. El separador es una frontera de texto que eliges tú, de modo que la estructura que no esté marcada por esa frontera se ignora: el nodo no distingue un título de una nota al pie. Cuenta caracteres y no tokens del modelo, así que Chunk Size es una aproximación de lo que un modelo leerá realmente. Expone 3 parámetros y ninguno más, sin vista previa de los fragmentos antes de que salgan. La página describe la versión 1 del nodo, la máxima del catálogo; un flujo antiguo puede mostrar una versión anterior con menos opciones.
04¿Por qué divisor empezar y qué hay que conectar como mínimo?
Empieza por este cuando el texto tiene un separador evidente que puedes nombrar, una línea en blanco entre párrafos o un delimitador entre registros. El cableado mínimo son dos nodos: un nodo raíz que acepte un puerto Text Splitter, o sea un Default Data Loader que lea tus documentos o una Summarization Chain que los digiera, más este nodo en ese puerto. Lo que el nodo raíz pida en sus otros puertos, un modelo de chat por ejemplo, es asunto suyo. Ajusta primero Chunk Size, luego Chunk Overlap, y corrige el Separator viendo cómo salen los fragmentos.
05¿n8n o Make para trocear documentos?
Depende de dónde tengan que vivir tus datos. n8n se autoaloja con Docker o npm, o se usa en n8n Cloud, con el mismo flujo en ambos casos, así que los documentos pueden procesarse en una infraestructura que tú controlas. Make solo existe alojado, sin opción de autoalojamiento, y factura por operación, lo que cambia la cuenta cuando un documento se convierte en cientos de fragmentos. En la construcción, los dos ofrecen un lienzo visual. n8n cuando pesan el control del dato y el coste por volumen, Make cuando prima una plataforma gestionada entera.
Hack'celeration Lab

Recibe nuestros tips de integración cada semana.

Sin spam. Cancela cuando quieras.