Construye una storyline

Para qué sirve una storyline

Un agente simple hace una cosa bien. Una storyline permite que un agente ejecute todo un proceso multipaso con cada persona — enseñar un curso, guiar un programa de coaching, llevar una solicitud hasta una decisión — y recordar dónde está cada individuo, entre sesiones y canales. Si la idea es nueva para ti, empieza por la página de concepto de Storylines; esta página es el cómo.

Las storylines son una capacidad Pro. Una vez activada para tu tenant, encontrarás el editor de storylines en la consola. También puedes construir storylines mediante la API (/v1/storylines), que es como un wizard de configuración o un asistente puede generarte una.

La forma de una storyline

Una storyline es un grafo. Dibujas nodos y los conectas con salidas.

Cada nodo es un paso. Para ese paso configuras:

• una tarea — qué debería estar haciendo el agente aquí (puedes insertar {dimension} o {blackboard.key} y se rellena con los valores actuales de la persona);
• su conocimiento, habilidades y herramientas — añadidos sobre el conjunto base del agente, o, con el interruptor avanzado, sustituyéndolos solo para este paso;
• una frase de apertura opcional que el agente dice al entrar en el paso (déjala en blanco para cambiar en silencio);
• si es el paso de entrada y si es un paso terminal (final).

La identidad y los límites de seguridad del agente nunca cambian entre nodos — solo cambian la tarea, el conocimiento y las herramientas.

Cómo avanza un paso: condiciones de salida

Cada salida de un nodo lleva una condición. Hay cinco tipos, y elegir el correcto importa:

• Regla — un umbral sobre una dimensión o un valor guardado, construido eligiendo un campo, un operador y un número (listening ≥ 70 and attempts ≥ 3). Determinista, gratis, sin llamada al modelo. Úsala para las decisiones que deben ser fiables.
• Elección del usuario — un botón que la persona pulsa. Bueno para "¿listo para continuar?" o para ramificar según una preferencia clara.
• IA — una frase que describe un criterio difuso ("cuando el estudiante pueda formar una frase en pasado sin ayuda"), que el modelo juzga. También escribes cuándo comprobarlo, para que no se juzgue en cada turno. Úsala para juicios, no para compuertas que necesitas exactas.
• Callback — espera una señal de un sistema externo (véase abajo).
• Ir a storyline — salta a una storyline distinta (ramificando por resultado, o encadenando grados).

Cuando más de una salida podría dispararse, se evalúan de arriba abajo — así que pon primero las deterministas.

Dimensiones: el perfil que viaja con una persona

Bajo los ajustes de la storyline defines dimensiones para tu materia — para un curso de idiomas, listening, speaking, reading, writing, cada una de 0 a 100. Estas se acumulan en la persona a lo largo de las storylines (así que se arrastran de grado a grado), y cada una puede marcarse visible para el usuario o reservarse solo para tus ojos. Las dimensiones se escriben de tres maneras: la IA puede puntuarlas periódicamente, una regla puede fijarlas, o un callback de un tercero puede reportarlas.

Junto a las dimensiones, cada inscripción tiene una pizarra (blackboard) — un cuaderno de notas de forma libre con anotaciones de traspaso que se pasan de un nodo al siguiente. Se reinicia cuando la persona pasa a una nueva storyline.

Incorporar a un tercero (callbacks)

Un nodo puede traspasar a una persona a un sistema externo y actuar sobre lo que reporta de vuelta — un test puntuado, una comprobación KYC, un minijuego incrustado. Hay dos formas:

• Backend — los datos salen a una herramienta y un resultado regresa de forma invisible.
• Redirigir y esperar — la conversación muestra un enlace, se bloquea, y se reanuda cuando el paso externo termina (como funciona una ventana de pago). Si la persona cancela o expira el tiempo, ese es un resultado distinto sobre el que puedes ramificar.

La consola da a cada callback una URL y un nombre de señal para entregar al tercero. Los resultados se verifican con un token de corta duración vinculado a esa persona y a ese paso, aplicado una sola vez (las repeticiones se ignoran), y cualquier dimensión que reporten se comprueba contra tu esquema — un sistema externo no puede escribir un campo que no definiste. Trata cualquier cosa que escriba un callback como datos, no como instrucciones.

Publicar, versiones y cambiar una storyline en vivo

Una storyline sigue siendo un borrador hasta que la publicas. Publicar primero valida el grafo — sin entrada faltante, sin callejones sin salida, nada inalcanzable, sin objetivos colgantes o desconocidos — y bloquea si algo está mal. Publicar congela una versión inmutable; cualquiera que ya vaya a medias se mantiene fijado a la versión con la que empezó, así que un cambio nunca interrumpe a alguien a mitad de camino.

Cuando borras o cambias un nodo en el que hay gente actualmente, eliges qué les ocurre: moverlos a otro nodo (seguro), devolverlos al inicio, o borrar su progreso. Las dos últimas pierden el progreso de un usuario, así que la consola te pide confirmación y muestra a cuántas personas afecta.

Probarla antes de que esté en vivo

El editor tiene dos formas de probar. Un recorrido lógico traza el grafo sin llamar al modelo (gratis, instantáneo) para comprobar alcanzabilidad y condiciones. Una ejecución en vivo pasa realmente mensajes por el modelo (usa tu cuota, y el editor lo indica) para sentir la cosa real.