Macros de prompt

Una macro es una {{tag}} corta que Marinara reemplaza por un valor en vivo, como tu nombre o la fecha actual, cuando arma un prompt (las instrucciones enviadas a la IA). Esta guía enumera todas las macros integradas, dónde puedes escribirlas y los errores que debes evitar.

Dónde funcionan las macros

Cuando Marinara arma el texto que envía a la IA, cambia cada {{tag}} por su valor actual. No hay ningún interruptor para activar las macros. Cualquier campo que las admita siempre las resuelve. Los nombres de las macros integradas no distinguen mayúsculas de minúsculas, así que {{user}} y {{USER}} funcionan igual. El valor de una macro puede contener otra macro, y Marinara también resuelve esa.

Puedes escribir macros en estos lugares:

• Campos de personaje en el Character Editor (Editor de personaje): Description, Personality, Backstory, Appearance, Scenario, Example Dialogue, System Prompt, Post-History Instructions y el Depth Prompt.
• Campos de persona en el Persona Editor (Editor de persona) (los mismos campos de la tarjeta).
• Los campos Description y Content de las entradas de lorebook (libro de trasfondo).
• Secciones del preset de prompt en el Preset Editor (Editor de presets).
• Los campos Find, Replace y Trim de los scripts de regex.
• Plantillas de prompt de agente.
• El cuadro de mensaje del chat. Escribe {{roll:1d20}} en un mensaje y se resuelve antes de que el mensaje se envíe.

Las macros se ejecutan dentro de Marinara y no necesitan configuración ni API key (clave de API). Dos funciones dependen de otras partes de la app:

• Las variables de preset (el comodín {{NAME}}) necesitan un preset de prompt que las defina. Consulta Variables de preset.
• La macro de agente {{agent::TYPE}} solo muestra texto una vez que el agente correspondiente se ha ejecutado y ha producido una salida.

Macros de identidad, personaje y persona

Estas macros traen los nombres y los campos de la tarjeta de la persona que habla y del personaje que responde. El usuario eres tú (o tu persona activa). El personaje es el bot que responde.

Las macros de campos de personaje leen la tarjeta de personaje actual:

En un chat con un solo personaje, estas se resuelven contra ese personaje. En un chat grupal, se resuelven contra el primer personaje de forma predeterminada. Para repetir texto por cada personaje, ponlo dentro de un bloque de grupo entre corchetes. Consulta Prompts condicionales para los bloques de grupo.

{{group}} sigue al personaje que responde en ese momento, incluso durante las generaciones grupales individuales. Por ejemplo, si Pantalone está respondiendo en un grupo de Roleplay que contiene a Powers That Be, Maukie y Pantalone, {{group}} se resuelve como Powers That Be, Maukie. Una tarjeta de personaje permanece en esta lista aunque su nombre coincida con {{user}}.

El campo del nombre Phonetic tiene dos funciones. Define cómo pronuncia el nombre el text-to-speech. También alimenta a {{charNamePhonetic}} y {{userNamePhonetic}}. Lo encontrarás tanto en el Character Editor como en el Persona Editor.

Para referirte a un personaje que no está en el chat actual, copia el ID de su tarjeta y colócalo directamente entre llaves dobles, como {{V1StGXR8_Z5jdHi6B-myT}}. No incluyas los caracteres literales < o >. Marinara reemplaza la macro por el nombre del personaje. En los chats de Roleplay que usan un preset de prompt, también añade Description, Personality, Appearance, Backstory, Scenario y Example Dialogue de la tarjeta al prompt de sistema; en los demás chats, la macro solo se convierte en el nombre. Funciona en mensajes del chat y campos de prompt, y en los chats de Roleplay con preset también en entradas activadas de lorebook. Se excluyen los saludos iniciales de la tarjeta. Los lorebooks activados vinculados a esa tarjeta conservan sus reglas normales de palabras clave, constant, filtros, probabilidad y presupuesto de tokens. Si el personaje ya está en el chat, la macro se sigue reemplazando por su nombre, y su tarjeta no se añade por segunda vez.

Para referirte a una persona distinta de la activa, antepón persona- a su ID copiado, por ejemplo {{persona-P1StGXR8_Z5jdHi6B-myT}}. Marinara reemplaza la macro por el nombre de la persona y añade Description, Personality, Appearance, Backstory y Scenario de esa tarjeta al mismo contexto de ID Macro Cards. Los lorebooks activados vinculados a esa persona conservan sus reglas normales de activación.

Macros del modo de conversación

Estas cuatro macros solo funcionan en Conversation Mode. En todos los demás modos siempre se resuelven a nada, incluso cuando el mismo texto de tarjeta o de preset se comparte entre modos.

Editas estos campos en la pestaña Convo del Character Editor y del Persona Editor. Para la configuración completa, consulta Perfiles del modo de conversación.

Macros de colocación en la conversación

Conversation Mode inserta automáticamente varios bloques en el prompt por ti. Estas macros permiten que un preset mueva un bloque a donde tú coloques la macro. Cuando usas una, Marinara renderiza ese bloque en la macro y omite su inserción automática, para que el contenido nunca se duplique. Cada macro tiene uno o más alias; todos los alias se comportan igual.

Estas solo se aplican en Conversation Mode. En una conversación con un solo personaje, colocar tú mismo las biografías de los participantes con {{char_about}} / {{persona_about}} (ver arriba) funciona de la misma forma: Marinara omite entonces su bloque automático de "about me" de los participantes para que las biografías no se inserten dos veces. Las conversaciones grupales conservan el bloque automático de participantes porque cualquiera de las dos macros singulares cubre solo a un participante y no debe ocultar la biografía de todos los demás.

Macros de contexto

Estas macros describen el chat actual y la solicitud actual.

{{reasoning}} indica el nivel que recibe el modelo, una vez combinados tu preset, tu cuenta y los ajustes del chat. Maximum aparece como el nivel más alto que admite el modelo, así que puede leerse max, xhigh o high. Como off se lee como falso, {{#if reasoning}} conserva un bloque solo mientras el modelo piensa. Si tu preset o tu chat ya tiene una variable propia llamada reasoning, esa variable conserva el nombre.

El valor de {{lastGenerationType}} es una etiqueta simple. Los valores de ejemplo que se ven en la app incluyen normal, continue, regenerate, impersonate, guided, autonomous, turn_game, preview, game_setup, lorebook_scan y retry_agents. Esta lista puede crecer, así que trátala como ejemplos, no como un conjunto fijo.

{{gameStoryboardKeyframeCount}} se proporciona a los prompts del GM (director del juego) de Game Mode, incluido el Storyboard Game Prompt integrado. Es un objetivo narrativo, no una exigencia de exactamente ese número de párrafos. El planificador del storyboard (secuencia de viñetas) igualmente devuelve menos tomas cuando un turno no contiene suficientes momentos visuales distintos.

La macro {{agent::TYPE}} inserta la salida guardada de un agente (un ayudante en segundo plano que rellena cosas como un tracker de escena). La forma más fácil de añadirla es dentro del Preset Editor: haz clic en Add Section, abre el grupo Agent Sections y elige un agente. Marinara crea una sección que ya contiene la etiqueta {{agent::TYPE}} correcta. Esta macro se resuelve al final, así que el texto del agente no puede inyectar más macros en tu prompt.

Macros Outlet de lorebooks

{{outlet::name}} inserta contenido de las entradas de lorebook cuya Position es Outlet y cuyo Outlet name coincide exactamente con name. Los nombres de Outlet distinguen mayúsculas y minúsculas. Por ejemplo, {{outlet::character_rules}} no coincide con un Outlet llamado Character_Rules.

Las entradas Outlet siguen usando la activación normal de los lorebooks. Las palabras clave, el modo Constant, la probabilidad, los filtros, los tiempos, los límites de entradas y los presupuestos de tokens deciden si una entrada está activa para la generación actual. Las entradas activas con el mismo nombre de Outlet se unen según su Order, separadas por saltos de línea. Solo se insertan en la macro; no se añaden también en una posición normal del lorebook.

Usa las macros Outlet en secciones de prompt de los modos Conversation, Roleplay o Game. La macro funciona aunque aparezca antes del marcador de lorebook del preset, y un preset no necesita un marcador de lorebook si solo utiliza entradas Outlet. Un Outlet desconocido o inactivo se resuelve como texto vacío. Una entrada Outlet no puede expandir otra macro Outlet, por lo que los Outlets anidados no son recursivos.

Macro de tamaño de lorebook

{{lorebooksize::ID}} se resuelve como el número total de entradas del lorebook con ese ID. Reemplaza ID por el ID del lorebook, que puedes copiar desde el panel Lorebooks. Por ejemplo, si un lorebook tiene el ID V1StGXR8_Z5jdHi6B-myT y contiene 151 entradas, {{lorebooksize::V1StGXR8_Z5jdHi6B-myT}} se resuelve como 151.

Los IDs de lorebook desconocidos se resuelven como 0. El recuento incluye todas las entradas, estén activadas, desactivadas o en carpetas.

Usa esta macro en secciones de prompt, campos de tarjetas de personaje, contenido de entradas de lorebook o cualquier lugar donde se resuelvan macros.

Macro de inclusión de lorebook

{{include::ENTRY}} inserta el texto de una entrada de lorebook en el lugar donde escribes la macro. Guarda un fragmento de texto compartido, como las reglas de la casa, en una sola entrada y reutilízalo en otras entradas, secciones de prompt o tarjetas, para que solo haya una copia que editar. Reemplaza ENTRY por el ID o el nombre de la entrada. Los nombres no distinguen mayúsculas de minúsculas.

• Dentro de una entrada de lorebook, un nombre se busca en el propio lorebook de esa entrada.
• En cualquier otro lugar, un nombre se busca en los lorebooks que usa este chat: los añadidos al chat, los vinculados a sus personajes y a su persona, y los globales.
• Un ID encuentra la entrada en cualquier lorebook.

{{include::BOOK::ENTRY}} toma la entrada del lorebook que indiques por su ID o su nombre. Ese lorebook no tiene que estar añadido al chat, ni siquiera activado.

{{include::Rules of the arena}}
{{include::Shared lore::Rules of the arena}}

La entrada incluida no tiene que activarse, y puede estar desactivada, así que puedes tener entradas que existan solo para ser incluidas. Las macros del texto incluido funcionan como siempre, y ese texto también puede incluir otras entradas. Si una inclusión lleva de vuelta a una entrada dentro de la que ya está, como una entrada que se incluye a sí misma, esa inclusión se resuelve a nada en lugar de repetirse indefinidamente. Una entrada o un lorebook que no se encuentra también se resuelve a nada.

Escribe los nombres y los IDs como texto plano. Las macros dentro de ellos, como {{include::{{char}}}}, no se completan.

Macros de tiempo

Las macros de tiempo del mundo real leen un mismo instante compartido en cada resolución, por lo que siempre coinciden entre sí. La zona horaria viene del navegador.

Las macros .world_state funcionan en los prompts y en las plantillas de agentes. Leen la fecha y la hora del mundo que se muestran para el turno actual de la historia. Al cambiar de swipe, usan los valores del turno seleccionado; al regenerar, usan el estado de la historia desde el que parte la respuesta de reemplazo. Si falta un valor, queda vacío; nunca se sustituye por la fecha u hora actuales del mundo real. Los calendarios ficticios conservan su propio texto de fecha y hora. Para un día de la semana ficticio, añade en World State un campo personalizado llamado Weekday o Day of Week.

Por ejemplo, {{#if weekday.world_state == "Monday"}}Use the weekday routine.{{/if}} lee el día de la semana registrado en lugar del real.

Macros aleatorias y de dados

Estas macros añaden azar a tus prompts. Usa la macro aleatoria ({{random}}) para números y elecciones, y la macro de tirada ({{roll}}) para los dados.

Aquí tienes una elección aleatoria simple que puedes copiar:

{{random::The door creaks open.::A bell rings.::Someone laughs nearby.}}

Elecciones ponderadas

Añade un @number final a una opción para definir qué tan probable es. El número es un peso relativo. Cuanto mayor, más probable.

{{random::Common event@1::Rare event@0.25}}

En ese ejemplo el peso total es 1.25, así que las probabilidades son:

Reglas de ponderación:

• Un peso ausente cuenta como 1.
• Se permiten pesos decimales, como 0.5 o 0.01.
• Un peso de 0 mantiene la opción, pero nunca puede elegirse.
• Si todas las opciones tienen peso 0, la macro se resuelve a nada.
• Solo un @number final cuenta como peso. Un @ en otro lugar, como en una dirección de correo, se deja tal cual.

Variables dinámicas

Las variables permiten que una parte de tu prompt almacene un valor y que una parte posterior lo lea.

Las variables se resuelven de izquierda a derecha durante un mismo armado del prompt. Un valor definido pronto, por ejemplo en una entrada de lorebook que aparece primero, puede leerse más adelante en el mismo prompt. Marinara también las guarda en el chat actual, igual que las variables locales de SillyTavern: se conservan en turnos posteriores y tras reiniciar la app, mientras que otro chat tiene sus propios valores por separado.

Cualquier {{NAME}} que no sea una macro integrada se busca por nombre: primero entre las variables del preset y después entre las del chat. Si ninguna tiene ese nombre, la etiqueta queda en el texto exactamente como la escribiste. La variable del preset tiene prioridad cuando ambas usan el mismo nombre. Consulta Variables de preset para conocer esa parte.

Variables del chat

No necesitas usar {{setvar}} para crear una variable. La sección Chat Variables (variables del chat) del panel Chat Settings (ajustes del chat) te permite escribir directamente un nombre y un valor, y usar ese nombre donde funcionen las macros, incluso en tus propios mensajes. Añade char1 con el valor Mary, escribe {{char1}} walks in. y la IA lee "Mary walks in."

Reglas de las variables del chat:

• Los nombres admiten letras, números y guiones bajos, y deben empezar con una letra o un guion bajo. Los nombres de exactamente 21 caracteres están reservados para referencias a personajes. Un nombre con un punto o un guion todavía se puede establecer y leer con {{setvar}} y {{getvar}}, pero no se resuelve con la forma directa {{name}}.
• No puedes usar el nombre de una macro integrada. {{char}} siempre se refiere al personaje.
• Tu mensaje sigue mostrando la etiqueta que escribiste. El valor se sustituye al construir el prompt, así que cambiarlo más adelante también cambia los turnos anteriores que lo usaron.
• La sección también muestra las variables establecidas con {{setvar}}, porque comparten un mismo almacenamiento por chat.

Para conocer el panel, consulta Resumen de los ajustes del chat.

Macros de formato

Estas macros dan forma al texto que las rodea.

Mostrar llaves dobles literales

No hay carácter de escape para las macros. Si quieres que las llaves dobles se queden en el texto, usa un nombre que Marinara no conozca. Cualquier {{name}} desconocido se deja exactamente como se escribió, siempre que ninguna variable de preset ni del chat comparta ese nombre. Si necesitas una nota privada que nunca llegue a la IA, usa {{// like this}} en su lugar.

La referencia de macros y /macros

Cada campo con macros habilitadas tiene dos botones pequeños en su esquina:

• Expand editor (Ampliar editor) abre una ventana de edición más grande para ese campo.
• Macro reference (Referencia de macros) abre una ventana titulada Macro reference que lista todas las macros integradas por categoría, cada una con su sintaxis exacta. Esta lista se genera desde la misma fuente que usa el motor, así que siempre es precisa.

Estos campos también completan los nombres de las macros por ti. Escribe {{ch al final de una línea y el resto, ar}}, aparece en texto tenue. Pulsa Tab, o toca el texto tenue, para aceptarlo. Sigue escribiendo para ignorarlo. Para una macro que recibe un valor, como {{getvar::, se detiene donde escribes el valor.

También puedes escribir /macros en el cuadro de chat (la forma corta /macro también funciona). Imprime la lista completa de macros directamente en el chat como recordatorio rápido.

Condiciones con macros

Los bloques condicionales ({{#if ...}}) pueden combinar comparaciones con || (OR), && (AND) y paréntesis. Las listas de igualdad pueden usar la forma compacta {{#if character == "Maukie" || "Pantalone"}}. Consulta Prompts condicionales para la precedencia, ejemplos de chat grupal y la lista completa de operadores.

Una condición también puede consultar a tu Decision model (modelo de decisión) sobre la escena, por ejemplo {{#if decision:"The latest message moves the scene to a new place"}} para sí o no, y {{#if decision_choice:"The kind of scene in the latest message" == "combat"}} para elegir una opción. Sin Decision model o sin respuesta, se interpretan como no. Consulta Consultar al Decision model. Opciones que puedes añadir después de una declaración:

• sticky:3 cooldown:5 conserva un sí durante tres turnos y luego lo deja descansar cinco. Consulta Sticky y cooldown.
• until:"..." o while:"..." conserva un sí mientras lo permita una segunda declaración. Consulta Until y while.
• every:3 consulta una declaración solo cada tres turnos. Consulta Comprobar cada varios turnos.
• priority:high o priority:low elige qué declaraciones caben en un plan de prompt. Consulta Prioridad y Límites y costo.

Errores comunes

• No escribas variables dentro de un bloque {{random::...}}. Un {{setvar}} dentro de una opción aleatoria se ejecuta para cada opción antes de hacer la elección, no solo para la elegida.
• No uses una variable local como estado global. Solo persiste dentro del chat donde se definió.
• Una sección del prompt o entrada de lorebook que ejecute {{setvar}} sobrescribe una variable del chat con el mismo nombre, porque ambas usan un mismo almacenamiento por chat. Usa nombres distintos si quieres conservar las dos.
• {{prompt}} no es una macro. Si todo tu mensaje es {{prompt}}, Marinara abre el visor Peek Prompt en lugar de enviarlo. Consulta Peek Prompt.
• Los Custom Tools no usan texto {{macro}}. No pegues {{roll:1d20}} en un campo de herramienta esperando que se resuelva.
• La plantilla de prompt de Impersonate acepta solo unos pocos marcadores de posición, no la lista completa de macros. Sus nombres también difieren, así que una macro que funciona en una tarjeta puede no funcionar ahí.
• La salida de macro grande o muy anidada se corta de forma silenciosa. No hay error, así que mantén las expansiones de macro dentro de lo razonable.

Guías relacionadas

• Prompts condicionales
• Variables de preset
• Preset Editor y Prompt Manager
• Peek Prompt
• Crear y editar personajes
• Perfiles del modo de conversación