A tu agente le entra el capítulo actual —más el bloque de persona y estilo,
si tu manual lo trae, que acompaña a todos los capítulos—, nunca los demás
capítulos. Lo que escribiste en el capítulo 4 no existe para él mientras la
conversación está en el 1. Si una regla tiene que valer siempre, escríbela en
cada capítulo donde importe.
Qué lleva un capítulo
Estos son los campos reales, con el nombre que verá tu asistente:chapter_label— el título. Va sin número («Calificación», no «2. Calificación»): el orden lo lleva otro campo.role— quién es tu agente en este capítulo.thought_chain— el guion. Es lo que tu agente ejecuta paso a paso. Aquí vive todo lo importante.context— información de apoyo y reglas del capítulo.examples— ejemplos de conversación. La IA de OptiMind ya no los escribe, pero si tu manual los trae, tu agente los sigue viendo.display_order— el número del capítulo en el embudo. Empieza en 1.execute_once— capítulo de un solo disparo (el saludo, típicamente).advance_to— a qué capítulo salta automáticamente un capítuloexecute_once.advance_condition— cuándo toca pasar al siguiente, descrito como conducta observable del cliente.
Dos números que no son el mismo
Esta es la confusión que más manuales rompe:
Tu asistente lee ambos. Tú solo tienes que saber que el número que pones en
una línea de avance es el
display_order, y que el chapter_index no se
calcula ni se deduce de la posición del capítulo: se copia tal cual del manual
que se acaba de leer.
Cómo avanza el embudo
Hay una sola forma de que tu agente decida cambiar de capítulo: una línea literal dentro del texto del capítulo. Lo natural es escribirla enthought_chain, pero funciona igual desde el rol, el contexto, los ejemplos o
la condición de avance:
execute_once, más abajo.
Detalles que conviene saber:
- El destino tiene que existir. Si el manual no tiene un capítulo con ese número, el avance se rechaza y la conversación se queda donde estaba.
- El avance se aplica al entregar la respuesta. Un turno que se interrumpe (el cliente escribe encima) no avanza.
advance_conditionllega a tu agente con su rótulo y una instrucción fija: cuando se cumpla, que llame aadvance_chapter. Escríbela como algo que se ve —«el cliente dio su distrito»—, nunca como una intención —«parece interesado»—: una intención no se cumple nunca, o se cumple siempre.execute_oncehace que el capítulo se ejecute una vez y avance solo, sin que haga falta ninguna línea, si tu agente no armó ya un avance en ese mismo turno. El destino es suadvance_to; si no lo tiene, el capítulo siguiente.- El último capítulo no avanza. Tu agente recibe un aviso explícito de que es el final del manual, aunque el cliente cierre la compra ahí mismo.
Enviar un archivo desde el manual
Para que tu agente mande un archivo de tu Librería, se escribe un marcador en el punto exacto del guion donde debe salir. Dentro del marcador va la frase de envío del archivo, tal cual la escribiste al vincularlo:- Escribe la frase exacta. Es la que exigen el validador del generador y el editor del panel: un marcador que no nombre una frase viva se pinta como mención rota. (A la hora de entregar, tu agente también acierta si escribes el nombre exacto del fichero, pero esa tolerancia no te la reconoce el resto del producto.)
- Ningún
###llega al cliente. Si la frase no resuelve, el marcador desaparece del mensaje y no sale ningún archivo — sin error visible. - Si desvinculas el archivo de tu agente, los marcadores que lo nombraban se quedan sin nada que resolver. El texto del manual no se toca solo.
Un pasaje que salga tal cual
Tu agente reparte su respuesta en varias burbujas cortas. Si tienes un texto que debe salir entero y sin retocar —unos datos de pago, unas condiciones—, envuélvelo:Los precios no se escriben aquí: viven en el catálogo, y tu agente los lee de
ahí. Ver El catálogo de productos.
Cómo se guarda: un lote, diez versiones
Cada vez que se guarda el manual, OptiMind inserta una versión nueva y conserva solo las 10 más recientes. La número 11 empuja a la 1 fuera del Historial. El guardado es atómico: o entran todos los cambios o no entra ninguno. No hay manuales a medio escribir. Y justo después de guardar, el puente relee el manual y devuelve un resumen verificado de los capítulos —clave, título, orden y el tamaño de cada campo—, para que el cambio quede confirmado por lectura y no de palabra. El texto nuevo, si quieres verlo, se pide aparte.Si esa relectura falla, la respuesta lo dice (
verified: false) y significa
una cosa concreta: el guardado sí se aplicó. Reintentar quemaría otra
versión del Historial para nada.El ciclo completo
1
Leer
2
Proponer
3
Guardar
4
Comprobar
5
Volver atrás
Trampas reales
- El campo
contextva fusionado. Los puntos clave dejaron de ser un campo aparte: hoy viven dentro decontext, marcados con los rótulosCONTEXTO:yPUNTOS CLAVE:. Reescribircontextsin conservar esos rótulos borra el bloque de reglas sin avisar. - Borrar un capítulo no renumera el resto. Es normal quedarse con capítulos 1, 2 y 4. Lo que no es normal es dejar líneas de avance apuntando al capítulo que ya no existe: ese avance se rechaza y el embudo se para. Cuando borres uno, revisa quién lo nombraba.
- Un capítulo nuevo sin número de embudo es invisible. Si se crea sin
display_order, el embudo no puede llegar a él ni con una línea de avance — y aun así, al leer el manual verás un número calculado por su posición, así que a simple vista parece correcto. Pide siempre que el capítulo nuevo nazca con su número. - Conviven tres formas del documento por dentro (el bloque de persona, el formato completo y uno antiguo y comprimido de agentes migrados). El servidor respeta la forma de cada capítulo al editarlo y funde los cambios sobre el capítulo vivo — por eso los archivos, herramientas y el color del capítulo sobreviven a una edición aunque el editor no los mande de vuelta. Reconstruir el manual desde cero, en cambio, los perdería.
- Restaurar una versión antigua después de haber añadido o borrado capítulos puede dejar los adjuntos de un capítulo (archivos, herramientas, color) colgando de otro. La restauración te lo advierte; conviene mirarlo en el panel.
- Borrar un capítulo corre las claves internas de los que van detrás. Crear no: los capítulos nuevos se añaden al final y no mueven a nadie. Da igual si tu asistente trabaja bien, porque releerá el manual antes de la siguiente escritura. Si ves que edita «de memoria» dos veces seguidas, párale.
Con la IA de OptiMind
Dos funciones escriben manual por ti y consumen créditos de tu saldo:- Generar un borrador completo desde la descripción de tu negocio.
- Optimizar los capítulos que le indiques.
Probarlo antes de confiar
Se puede simular un chat nuevo o un mensaje entrante y ver responder a tu agente por el pipeline real.Qué necesita tu conexión
Leer el manual y su historial viene activado de serie. Guardar no: es una escritura destructiva y hay que pedirla en la URL con la que conectas. Lo mismo vale para generar y optimizar con IA, para las simulaciones y para la Librería de archivos.Todas las herramientas
Qué hace exactamente cada una, y cuáles son destructivas.
Seguridad
Qué ve tu asistente, qué queda auditado y qué nunca puede hacer.