Diseño de directores de juego con IA
Caché de prompts para campañas largas de RPG con IA
Compara la caché de prompts de OpenAI, Claude y Gemini: separa datos estables del estado de cada turno y mide uso y costo en campañas largas de RPG con IA.
Por qué una campaña larga se repite a sí misma
Un director de juego con IA puede necesitar las mismas reglas del entorno, los roles de los personajes y los límites de la narración en cada turno. La escena cambia cuando un jugador abre una puerta o interroga a un testigo, pero el mundo no se convierte en otro mundo. Volver a enviar ese material compartido suele ser necesario para obtener una respuesta coherente. La caché de prompts es una forma en que una API puede reutilizar trabajo con entradas repetidas; no es un mecanismo para que el juego recuerde un evento que nunca guardó.
Imagina una expedición en un barco volador buscando un mapa estelar perdido. Cada turno necesita la geografía del mar de nubes y la regla de que el muro de tormenta no puede cruzarse después del atardecer. La cubierta actual, los testigos, las pistas y la acción del jugador cambian. Esa distinción ofrece a los desarrolladores un punto de partida para examinar el comportamiento de la caché. Este es un ejemplo de diseño, no una optimización medida en Playworlds.
Coloca el material estable del mundo antes que los hechos cambiantes del turno
Una solicitud posible comienza con instrucciones duraderas: el rol del narrador en el juego, las restricciones establecidas del mundo, cómo se proporcionan los resultados de los dados y una breve descripción de los personajes recurrentes. Una sección posterior contiene la escena actual: qué cubierta es accesible, quién está presente, qué sabe el jugador y qué acción intentó. Colocar una lectura del reloj, un identificador de sesión o un nuevo mensaje del jugador antes que el material reutilizable puede cambiar el prefijo que la caché podría haber reutilizado.
No añadas contenido a un resumen solo para cumplir los requisitos de una caché. Incluye hechos que ayuden al narrador a tomar una decisión correcta y luego revisa las reglas de elegibilidad del proveedor. Si cambia una regla permanente, actualiza la fuente de verdad aunque la nueva versión necesite un procesamiento nuevo.
Qué significa un acierto de caché en distintas API
La documentación de la API de OpenAI describe la reutilización de un prefijo compartido de prompt e informa los tokens de entrada en caché en los datos de uso para modelos compatibles. Anthropic documenta la caché automática y puntos de interrupción explícitos, incluido un lugar para marcar el final del contenido estable. Gemini documenta la caché implícita y objetos de caché explícitos en su API Generate Content. Estos mecanismos difieren, por lo que un ejemplo copiado de una API no es una configuración de caché transferible.
Un acierto de caché puede reducir el procesamiento y el precio de la entrada elegible. No hace gratuitos los nuevos datos de la escena, ni elimina los costos de salida, ni demuestra que la respuesta sea correcta. La duración, la longitud mínima, las interfaces y la facturación varían según el proveedor y el modelo. Revisa la ruta exacta de la API antes de prometer un ahorro porcentual.
Una solicitud de ejemplo para la escena del barco volador
Mantén la sección compartida concisa: “Eres el director de juego para una expedición en un barco volador. Usa los hechos establecidos, preserva la elección del jugador y narra el resultado de reglas ya resueltas por el juego. El muro de tormenta no puede cruzarse después del atardecer. La navegante Iri planifica las rutas; su conocimiento actual se proporciona en cada turno.” Ese es un resumen de prompt ilustrativo, no un prompt de Playworlds ni una transcripción de una ejecución del modelo.
Añade el estado cambiante después: “Escena actual: la nave se acerca al muro de tormenta después del atardecer. Evento guardado: el jugador encontró el mapa estelar chamuscado en la sala de máquinas. Iri no ha visto el mapa desde la partida. Acción del jugador: mostrarle el mapa a Iri y preguntar quién entró en la sala de máquinas.” En el siguiente turno, conserva la sección compartida y reemplaza solo los hechos que realmente cambiaron. Valida la respuesta contra los eventos guardados antes de tratarla como una actualización de campaña.
Mide el costo por turno útil, no un descuento destacado
Para cada solicitud, registra el modelo y la interfaz, los tokens totales de entrada y salida, los tokens de entrada en caché o de lectura de caché, los tokens de escritura de caché cuando se cobran, el tiempo transcurrido y el resultado real de la tarea. Compara una secuencia normal de turnos con una versión cuyo prefijo estable se conserva deliberadamente. Si un turno necesita dos llamadas o un reintento, incluye ambos. Una solicitud aparentemente más barata no es un ahorro si una respuesta defectuosa obliga a otra generación.
Compara la fracción de entrada reutilizada y el costo de un turno completo. Verifica si la respuesta respeta el descubrimiento del mapa, la regla del muro de tormenta y el conocimiento de Iri. Los campos de uso muestran reutilización, no continuidad narrativa. Inspecciona la diferencia real en la solicitud antes de cambiar un prompt para corregir una ausencia de un acierto de caché.
Mantén la verdad del relato separada del diseño de la caché
Una campaña puede superar su resumen original del mundo. Si la tripulación disipa el muro de tormenta, una frase estable que dice que no puede cruzarse después del atardecer se vuelve incorrecta. El juego debe actualizar esa regla, versionar el resumen o mover la excepción al estado actual autorizado donde el narrador lo verá. Proteger una reutilización de caché no debe conservar una contradicción. Del mismo modo, un secreto que pertenece solo al director de juego no debería aparecer en un resumen visible para el jugador.
La caché del proveedor es una ayuda de procesamiento, no la base de datos de la campaña. Una aventura guardada necesita su propio registro de acciones aceptadas, tiradas, descubrimientos y cambios de personajes. Playworlds ofrece aventuras vinculadas a la cuenta y un narrador con IA, pero este artículo no afirma que su juego en vivo use una caché de prompts de un proveedor en particular. El ejemplo es un plan que un equipo de juego podría evaluar.
Una breve lista de verificación antes de optimizar
Primero, identifica los hechos que se repiten en varios turnos y colócalos en un resumen versionado y preciso. Segundo, coloca la acción del jugador y la escena actual después de ese resumen, y limita los secretos a las personas que pueden conocerlos. Tercero, registra la ruta exacta del proveedor y sus campos de uso de caché; compara turnos completos, incluidos reintentos y salida. Cuarto, prueba el relato por coherencia de los hechos y elección del jugador antes de considerar un éxito una factura más baja.
Si quieres experimentar el lado del jugador de una aventura continua con IA, explora la biblioteca de mundos de Playworlds y elige un entorno que le dé a tu personaje una razón para investigar. Para más información sobre cómo dar forma a una primera sesión, lee la guía de rol en solitario.