IA

Toda carta trae de serie una IA, el Narrador: el jugador dice algo y ella responde. A la gran mayoría de las cartas les basta con eso.

Si quieres que el Rey Rata de la bodega hable con su propio carácter, o que un duendecillo lleve las cuentas entre bastidores cada cinco turnos, añade otra IA.

Cada IA de más es una llamada más al modelo cada vez, y gasta más saldo. Antes de añadir una, piensa si de verdad necesita ser una IA aparte; muchas veces basta con una entrada de lore más.

Dónde vive una IA

Abajo en la carta y en cada módulo hay una fila IA, con una línea por cada IA, su nombre y su tipo. Una IA funciona en el sitio donde vive:

• Vive en la carta: está siempre
• Vive en un módulo: solo está mientras ese módulo está abierto
• Sin colocar: no funciona; se queda ahí guardada

Lo que sabe también depende de dónde vive: en la carta lee el lore de la carta; en un módulo, el de la carta más el de ese módulo. Si quieres que algunas entradas de lore las sepa solo esta IA y ninguna otra, ponlas en Solo ella lo sabe, en sus ajustes.

Puedes arrastrar la fila de una IA a otro módulo o a la carta: es como mudarla de casa.

Añade una IA

Añadir → Una llamada a IA. Se añade al módulo que estés viendo (si no hay ninguno seleccionado, a la carta), y a la derecha se abren sus ajustes. Lo primero, arriba, es elegir qué tipo de IA es. Si luego quieres cambiar algo, haz clic en su fila y se vuelven a abrir a la derecha.

Los cuatro tipos de IA

Tipo	Cuándo se ejecuta
Por turnos	Va al ritmo de los turnos del jugador: responde cada vez que el jugador habla; o se ejecuta entre bastidores cada pocos turnos; o espera a que otra IA termine de responder
Por interfaz	Espera a que la llame un botón de la interfaz del jugador
Por código	Elige su momento: cuando un valor cumple una condición, cuando termina un módulo, tras un rato de silencio
Personalizada	Lo que no se puede montar con el formulario. Reservas el hueco en el lienzo y el código lo hace funcionar (mira más abajo)

En Cuándo se activa, dentro de los ajustes, lo afinas:

• Cada vez que el jugador habla, responde: el típico «Narrador»
• Cada pocos turnos, entre bastidores: no le habla al jugador; va bien para resúmenes y contabilidad
• Justo después de que responda otra IA: espera a que termine la IA que elijas y entonces se ejecuta. Por ejemplo, el Narrador cuenta la historia y un personaje burlón remata con su comentario
• Llámala desde un botón de la interfaz del jugador: cuando la tengas lista, ve a la interfaz del jugador y añade a un botón el paso Llamar a una IA
• Cuando un valor cumple una condición: se ejecuta una vez en el momento en que la condición pasa de «no se cumple» a «se cumple»; si se sigue cumpliendo, no se repite
• Cuando termina una situación: al acabar una mazmorra, la lee y deja escrito algo para el siguiente sitio. Es el momento más habitual para una IA entre bastidores
• Tras un silencio, puede intervenir: con la partida abierta y tantos segundos sin que nadie hable, decide ella si mete una frase. Si no tiene nada que decir, se calla, pero cada vez que lo decide cuenta como una llamada

Personalizada: un hueco para el código

Hay IA que no se pueden montar con un formulario: dos personajes en escena con reglas que solo el código puede gestionar, o un director que solo habla según lo que pasa en la habitación. Para esos casos, elige Personalizada.

Al elegirla, la IA queda como un hueco reservado: tiene nombre, vive en un módulo y el lore de ese módulo es suyo, pero no se ejecuta sola: la pone en marcha el código. Tú no necesitas saber programar: pégale una nota adhesiva explicando qué debe hacer, y el Asistente IA o la IA externa que hayas conectado con «Conecta tu IA» lo escribirá.

Cuando esté escrito, al hacer clic en la fila verás en qué archivo y en qué línea está implementada; si todavía no, aquí no hay nada y pone «sin implementar».

Chat grupal

Cuando en un mismo sitio hay dos o más IA que le responden al jugador, se convierte en un Chat grupal · responden por turnos: el jugador dice algo y ellas responden una detrás de otra, cada una en su burbuja, con su nombre encima.

• En la carta: primero habla el Narrador y luego, por turnos, las demás IA de la carta
• En un módulo: si el módulo tiene sus propias IA, por defecto hablan ellas en lugar del Narrador. La fila del Narrador se ve más clara y, a la derecha, tiene un botón También la IA de la tarjeta: púlsalo y el Narrador se queda a hablar con ellas. Mientras el Narrador está, el botón cambia a Sin la IA de la tarjeta; púlsalo para que deje el sitio

Cuando el jugador regenera, en un chat grupal cada turno lo vuelve a decir la misma IA, sin cambiar a nadie de papel.

Context: lo que la IA lee en cada turno

Al pie de la carta, y de cada módulo, hay un bloque Context. Haz clic y a la derecha verás todo lo que la IA de ese sitio recibe en cada turno, y podrás decidir algunas cosas:

• Historial de conversación: Todo lo que quepa (por defecto: manda todo lo que puede y solo quita lo más antiguo cuando no cabe), Últimos N (más barato, pero la IA olvida lo anterior) o Resumen + últimos N, que pliega en un resumen los turnos que se salen y lo envía delante. Con esta opción también puedes rellenar Qué debe conservar el resumen, por ejemplo «Conserva cada promesa hecha y quién le debe a quién». El resumen se actualiza en segundo plano con un modelo barato y suele costar al jugador bastante menos de 1 mushie cada vez
• Nota fijada: una frase que va cerca del final de la conversación en cada turno, justo donde la IA hace más caso. Ahí van los recordatorios de estilo y las reglas que deben durar
• Presupuesto de contexto: cuánto puede leer la IA por turno. Por defecto sigue el ajuste del jugador. Si activas Fijar a esta carta, manda el tuyo
• Qué lee la IA en cada turno: todo en el orden en que la IA lo recibe (lore fijo, historial, lore que espera una palabra clave, variables), con una estimación de tokens. Si la IA olvida cosas o se va por las ramas, mira aquí primero
• En Avanzado también están Alcance de palabras clave, Disparos en cascada y Variables mostradas a la IA: Todas, Solo cambiadas o Ninguna

El interruptor de Seguimiento inteligente está en Ajustes de la carta, y también aparece al hacer clic en la fila de la IA de la carta. Es el mismo interruptor en los dos sitios.

Qué recuerda

En los ajustes de cada IA está la parte de memoria y de lo que tiene conectado:

• Recuerda toda la conversación, solo recuerda lo dicho aquí, comparte memoria con…: es el mismo sistema que la memoria de los módulos
• Mensajes recientes que lee: por ejemplo, a la IA de una escena de combate le bastan los últimos 10. Sale más barato y no se despista con una charla de hace trescientos turnos
• ＋ Conectar una: le pasa algo de otro sitio para que lo lea. Puede ser lo vivido en un módulo, lo que escribió una IA entre bastidores, las variables de un módulo o las palabras literales de un módulo. Lo vivido se puede pasar como Lo vivió (el protagonista lo vivió en persona) o como Archivo (un registro que encontró, no algo que vivió). Las palabras literales salen caras; si te sirve lo vivido, no uses las literales

Lo que escribe una IA entre bastidores llega a las demás justo por aquí. En el lienzo lo verás como «escribe para…» y «recibe lo que escribe…».

Las IA Por interfaz y las que intervienen tras un silencio no tienen esta parte de conexiones. Lo que ve una IA por interfaz se elige en Lo que ve, dentro de Formato de respuesta, más abajo; la que interviene tras un silencio lee sola la conversación reciente.

Modelo

El Modelo está por defecto en Seguir la elección del jugador. También puedes fijarle uno a una IA concreta, por ejemplo un modelo más charlatán para el Rey Rata. Si el jugador no puede usar el modelo que elegiste, se vuelve automáticamente al que eligió él, y la carta no se queda colgada.

Formato de respuesta: que la IA conteste en orden

En los ajustes de la IA, debajo de Dónde está, hay una sección plegada: Formato de respuesta. Casi nunca hace falta, pero sirve para hacer minijuegos.

Por ejemplo, el «Champiñón Adivino» de la taberna: el jugador pulsa un botón y tiene que responder dos cosas, la Suerte (que solo puede ser Gran suerte / Buena suerte / Un poco de mala suerte) y el Número de la suerte (del 1 al 9). La suerte se la dice al jugador, y el número de la suerte se guarda en una variable.

• Lo que ve: elige algunas variables para que las vea, cuántos mensajes recientes lee y si Recuerda sus propias respuestas
• Fragmentos de prompt (solo mientras se cumplan): por ejemplo, «Cuando Achispamiento ≥ 5, añadir: esta noche el Champiñón Adivino ha bebido de más y no dice nada a derechas»
• Respuesta: por defecto responde solo con texto. Si añades campos, responde en JSON; cada campo tiene un tipo (Texto / Número / Una de… / Lista) y un destino: Sus palabras, Variable (Poner / Sumar / Añadir a la lista), Un evento de la historia, o Solo se devuelve
• Dónde van sus palabras: A la historia (por defecto), Solo de vuelta a la interfaz o Un canal de la interfaz
• Si falla: cuántos segundos esperar como máximo, cuántas veces reintentar, cuántos segundos de espera entre llamadas, y unas frases de reserva (se elige una al azar). Si marcas Si sigue fallando, elegir una opción permitida al azar, los campos «Una de…» darán una respuesta válida aunque el modelo se declare en huelga

Lo que devuelve el modelo se revisa: los «Una de…» solo pueden ser una de las opciones, los números se ajustan al rango, y si algo no cuadra se le vuelve a preguntar una vez con una pista; si tampoco funciona, se usan las frases de reserva.

Si sabes programar, en el código de la interfaz de la carta puedes llamarla directamente con api.callAi("Champiñón Adivino", input) y recibes { text, fields }. Los detalles, en Avanzado: referencia de la API.

Tabla de IA

Cuando la carta tiene más de una IA, Vista → Tabla de IA muestra una tabla grande: para cada entrada de lore y cada variable, qué IA la ve y qué IA puede cambiarla. Con muchas IA es fácil liarse, y esta tabla te ayuda a comprobar que el Rey Rata no sabe nada que no debería saber.

Cuando algo no encaja

Si los ajustes de una IA están incompletos, el lienzo te dice qué falla bajo Así conectado no puede funcionar, por ejemplo:

• No elegiste «Cuándo se activa», así que nunca se va a ejecutar
• Una IA entre bastidores no tiene nada conectado: todo lo que escriba será inventado, y encima cuesta dinero
• La IA a la que espera no le responde al jugador, así que se quedará esperando para siempre

Cuando lo arregles, acuérdate de probar la carta: en la línea de tiempo de la prueba cada IA tiene su propia fila, y ves quién habló y quién despertó pero se quedó callada.