Conceptos

Storylines: agentes con estado, orquestados por grafos, que entregan un proceso

Una storyline es un grafo dirigido que un agente sigue con cada usuario final — cada nodo es un paso (con su propia tarea, conocimiento y herramientas), las salidas llevan condiciones, y el progreso, el perfil y las notas de cada persona se guardan y se retoman entre sesiones y canales. Convierte un agente que hace tareas puntuales en uno capaz de entregar por sí mismo un servicio de varios pasos.

También llamadoagente con estadomáquina de estados de agenteflujo de conversaciónrecorrido de agente guiadoflujo de trabajo de agenteflujo de trabajo con estadoflujo de trabajo conversacionalagente multipasoagente de cursoagente de onboardinggrafo de orquestación de agentesstateful agent

La mayoría de los agentes hacen tareas puntuales: responder una pregunta, reservar un hueco, recoger un dato. Se sitúan alrededor de un negocio y lo hacen más rápido. La enseñanza en sí, el coaching en sí, la consulta en sí — el núcleo de lo que el negocio vende — todavía necesita a una persona. Una storyline es lo que permite a un agente asumir ese núcleo: un proceso multipaso, con estado, que ejecuta con cada individuo, recordando dónde está y adaptándose sobre la marcha. La storyline de una escuela de idiomas no solo reserva la clase; la enseña.

storyline editor

Una storyline no es "un agente con más habilidades"

Esto es lo primero que hay que dejar claro, porque las dos cosas se parecen y no lo son. Una habilidad es una capacidad a la que el modelo puede recurrir; una storyline es un orden en el que ocurren las cosas.

Un agente con varias habilidadesUn agente ejecutando una storyline
SecuenciaCualquier habilidad, en cualquier momento — sin orden"No puedes llegar a B hasta que A esté hecho"
EstadoNo recuerda dónde estabasEl progreso de cada persona se guarda y se retoma
Qué lo dirigeEl modelo decide, en cada turnoEl grafo y sus condiciones deciden
DeterminismoEl orden vive en la cabeza del modeloEl orden se dibuja como un grafo — versionado, medible

Las habilidades responden a qué puede hacer un agente. Una storyline gobierna qué ocurre en qué orden, y dónde está esta persona concreta ahora mismo. Las dos no son rivales — una storyline es una capa por encima de las habilidades: cada nodo sigue colgando sus propias habilidades, conocimiento y herramientas. Y como la secuencia vive en un grafo explícito en lugar de en la memoria de trabajo del modelo, una storyline se mantiene fiable a medida que el proceso se alarga — el modelo solo tiene que manejar el paso actual, no recordar un procedimiento de doce pasos sin equivocarse.

Storyline frente a un flujo de trabajo

Como una storyline también es un grafo de pasos, es fácil archivarla junto a los constructores de flujos de trabajo — los Dify, n8n y Zapier del mundo. Son un tipo de cosa distinto. Un flujo de trabajo automatiza un proceso entre sistemas: una tubería fija que se dispara con un desencadenante y se ejecuta igual cada vez, moviendo datos de una herramienta a la siguiente. No tiene memoria de para quién se ejecutó, porque no se ejecuta para nadie — es fontanería de máquina a máquina.

El estado de una storyline es una persona. El progreso, el perfil y el lugar en el proceso de cada individuo se guardan y se retoman, de modo que el mismo grafo produce un camino distinto y retomable para cada usuario final, y el agente sostiene la conversación en cada paso en lugar de transportar datos entre aplicaciones. Un flujo de trabajo automatiza una tarea; una storyline entrega un servicio a alguien y lo recuerda.

Un flujo de trabajo (Dify, n8n, Zapier)Una storyline
Qué se mueve por élDatos, entre sistemasUna persona, a través de un proceso
EstadoSin estado — la misma ejecución cada vezCon estado — un camino guardado por individuo
Para quién se ejecutaPara nadie; lo disparan eventosUn usuario final concreto, recordado entre sesiones y canales
La unidad de trabajoUn paso de automatización ("llama a esta API")Un paso de conversación ("el agente maneja esta etapa")
Recurres a él cuandoDos sistemas necesitan hablar entre síUn servicio necesita ser entregado a personas a escala

La línea es sencilla: si el trabajo es "cuando ocurra X, haz Y con los datos", eso es un flujo de trabajo. Si el trabajo es "llevar a cada persona por esto y adaptarse a dónde está", eso es una storyline. Puedes usar ambos — un nodo de storyline puede recurrir a un flujo de trabajo para hacer el trabajo de máquina a máquina detrás de un paso.

Las piezas

  • Los nodos son pasos. Cada nodo reconfigura el mismo agente para ese paso: su propio prompt de tarea, bases de conocimiento, habilidades y herramientas (añadidas sobre la base del agente, o sustituyéndola). La identidad y los límites de seguridad del agente nunca cambian entre nodos.
  • Las salidas son cómo avanza un nodo, y cada una lleva una condición: una regla sobre el perfil (listening ≥ 70), el usuario pulsando un botón, un juicio de IA sobre un criterio difuso ("cuando pueda formar la frase sin ayuda"), una señal de un sistema externo, o un salto a otra storyline.
  • Un perfil viaja con la persona — dimensiones que defines por materia (listening, speaking, reading, writing para un idioma; algo totalmente distinto para historia), acumuladas a lo largo de las storylines, más un cuaderno de notas de forma libre con anotaciones de traspaso que se pasan de un nodo al siguiente.
  • El encadenamiento enlaza storylines de principio a fin — el grado 1 desemboca en el grado 2 — para que puedas hacer crecer un gran recorrido sin construirlo todo de golpe, y ramificar a una storyline distinta según el resultado (un usuario que no aprueba el examen pasa a la vía de refuerzo, no al siguiente grado).

El progreso es por persona, no por chat, así que alguien puede irse a mitad y retomar exactamente donde estaba — en la web, en Telegram o WhatsApp, donde vuelva.

Patrones de orquestación

Una storyline se ejecuta como un único token recorriendo el grafo, y ese mismo modelo expresa toda forma común de control de flujo. El orden vive en el grafo — versionado e inspeccionable — no en la memoria de corto plazo del modelo, así que se mantiene fiable a medida que el proceso se hace más largo y ramificado.

Ramificación — if / else / switch. Un nodo con varias salidas de regla, probadas de arriba abajo; gana la primera cuya condición se cumple. Determinista, evaluada sobre el estado guardado, sin conjeturas del modelo.

Bucle — reintentar con un tope. Una arista de retorno y un contador: cada intento incrementa una dimensión, y una regla lo topa y encamina. Los reintentos están acotados por el estado que el propio grafo escribió, no por confiar en que el modelo lleve la cuenta.

Paralelo — hacer todo / unión AND. Varios subflujos que la persona completa en cualquier orden, cada uno con sus propios pasos distintos; la storyline solo avanza una vez que cada rama ha terminado.

Lo que hace que esto sea determinista es que una salida puede fijar o incrementar parte del perfil al tomarse — una marca de finalización, un conteo de reintentos, un resultado de encaminamiento. Las ramas y uniones leen entonces del estado que el propio grafo escribió un paso antes, nunca del recuerdo que un LLM tenga de lo que pasó. El modelo maneja la conversación en el paso actual; el grafo maneja qué ocurre a continuación.

Pasos que se expanden en planes

Algunos pasos dependen demasiado de la situación como para escribirlos por completo de antemano. Un paso de «reunir los documentos», por ejemplo, es un checklist distinto para un fundador chino que vive en Estados Unidos que para uno alemán que vive en su país. Marca ese paso como expandible y, cuando un usuario llegue a él, el agente ofrecerá expandirlo — para ese usuario, sobre la marcha — en un subplan temporal generado por el Dynamic Planner: con sus propios pasos, sus checklists y su progreso visible. El plan se ejecuta anidado: tu storyline se detiene en ese paso, el plan se ejecuta y, cuando termina, la storyline se reanuda exactamente donde se había quedado. Dos reglas mantienen los papeles claros: una storyline escrita por ti siempre tiene prioridad sobre cualquier cosa generada, y toda expansión se ofrece, nunca se impone — el usuario confirma primero. (El Dynamic Planner es una capacidad Pro y tiene su propia página de concepto, que cubre también cómo se disparan los planes fuera de las storylines.)

Incorporar sistemas externos

Un nodo puede traspasar a un tercero y actuar sobre lo que devuelve: una evaluación puntuada, una comprobación KYC, un minijuego incrustado. Ese resultado — una puntuación, un veredicto, una confirmación de pago — puede actualizar el perfil o satisfacer una salida. Dos formas: un traspaso de backend (los datos salen a una herramienta y un resultado regresa, de forma invisible) y un traspaso de redirigir y esperar (la conversación muestra un enlace, se bloquea, y se reanuda cuando el paso externo termina — como lo hace un flujo de pago).

Dónde encaja

Las storylines convienen a cualquier negocio cuyo servicio central sea una conversación estructurada, por etapas y por persona: tutoría y práctica de idiomas, coaching y programas de responsabilidad, asesoría por etapas y venta guiada, recepción de solicitudes y precalificación, certificación y formación. Allá donde el valor esté hoy limitado por las horas de una persona, una storyline permite que un agente ejecute ese proceso para miles de personas a la vez — mientras que las partes que genuinamente necesitan a un humano se quedan con el humano.

Las storylines son una capacidad Pro, activada por tenant. Se crean como un grafo en la consola (o mediante la API, para que un asistente o un wizard pueda construir una), se versionan y se publican, con los usuarios en curso fijados a la versión con la que empezaron.

Preguntas frecuentes

¿En qué se diferencia esto de escribir simplemente un prompt de sistema más largo?
Un prompt lo describe todo de golpe y confía en que el modelo lleve la cuenta; una storyline le entrega al agente solo el paso en el que está la persona, y guarda su progreso fuera del modelo. Por eso una storyline se sigue comportando bien en el turno veinte, o cuando alguien vuelve una semana después por otro canal.
¿Qué pasa cuando un cliente se sale del tema en mitad de un flujo?
El agente responde a la pregunta y se queda en el mismo paso — salirse del tema no hace avanzar el flujo ni marca nada como recogido. Cuando la persona vuelve a la tarea, la storyline retoma exactamente donde estaba.
¿Puedo cambiar una storyline mientras ya hay gente dentro de ella?
Sí. La ejecución de cada persona queda fijada a la versión publicada con la que empezó, así que editar y volver a publicar no molesta a nadie a mitad de flujo. Tú decides cuándo migrar las ejecuciones existentes a la nueva versión.
¿Ven los usuarios finales que están dentro de una storyline?
Eso lo eliges tú, flujo por flujo: puede ser completamente invisible, mostrar solo el nombre, mostrar un mapa recortado de dónde están, o mostrar el mapa completo de pasos con el progreso. En los modos recortados no se envía al navegador nada sobre los pasos futuros ni sobre las ramas no tomadas.
¿Y si el cliente no termina nunca?
Su progreso simplemente espera — pertenece a la persona o al caso, no a una sesión del navegador. Puedes ver quién está atascado y dónde, que suele ser justo lo interesante: una solicitud sin terminar es un lead sobre el que puedes actuar en lugar de un abandono silencioso.
¿Quieres ver cómo funciona por dentro?Construye una storyline
Ponerlo en marcha
Construir una base de conocimiento

Casi todo lo que un agente necesita saber ya está escrito — en tu web y en los PDF que tu equipo ya envía a los clientes. Importar desde una URL cubre la mitad pública; subir archivos cubre el resto.

Índice estructurado

Un índice estructurado es una pequeña tabla que un agente construye a partir de los campos que tus documentos ya contienen — título, precio, nivel, enlace, imagen — junto con la búsqueda vectorial que utiliza para el significado. La búsqueda vectorial encuentra pasajes que se asemejan a la pregunta; no puede contar, filtrar por número ni agrupar. El índice estructurado responde a esas preguntas y permite al agente citar un enlace o un identificador exactamente en lugar de reconstruirlo a partir de un fragmento.

Dynamic Planner

El Dynamic Planner observa la conversación y, cuando un usuario persigue una tarea genuinamente multipaso dentro del dominio del agente y se le nota que no sabe cómo seguir, ofrece expandir esa tarea en una storyline temporal — un plan paso a paso, guiado por un checklist, que el agente ejecuta después un paso enfocado cada vez, con un progreso que el usuario puede ver. La planificación ocurre una sola vez, bajo validación; la ejecución es determinista.

Escritura de textos extensos

La escritura de textos extensos es un agente que produce un documento completo y de múltiples secciones —un informe de presentación, un informe de entrada al mercado, un memorando de debida diligencia— planificando primero el esquema, solicitando cualquier información necesaria antes de comenzar, investigando cada sección en función de su material y fuentes públicas, y redactando sección por sección en un trabajo que sobrevive a un reinicio. Lo edita en un lienzo junto al chat, reescribe cualquier pasaje seleccionándolo, y se conserva cada versión.