Un recomendador de juegos de mesa para tu propia colección compara los juegos que tienes con el número de jugadores, el tiempo disponible y las preferencias de esta noche. Shelf Night lee esa colección desde Google Sheets, registra una partida terminada tras confirmarla y utiliza el historial para evitar repeticiones recientes.
Sois cuatro alrededor de la mesa, tenéis una hora para jugar y Azul y Cascadia en la estantería. La primera selección incluye ambos. Tras registrar una partida de Cascadia, la siguiente consulta lo excluye y deja Azul.
El objetivo: Cascadia queda registrado en el historial de partidas y Shelf Night recomienda Azul cuando pides evitar repeticiones recientes.
Las capturas de Google Sheets muestran nuestro archivo de prueba conectado. Las capturas de Quickchat AI utilizan la aplicación local para mostrar las respuestas y los resultados de las acciones registrados por nuestro agente de prueba en funcionamiento real.
Primero configurarás la lectura de la colección y después añadirás el registro de partidas confirmadas y la comprobación de juegos recientes. Verificarás tanto la fila guardada como la respuesta.
Descarga el kit inicial de Shelf Night. Contiene dos archivos de hoja de cálculo con valores separados por tabulaciones, las instrucciones completas, tres recetas de acciones y una lista de comprobación de pruebas. Son archivos de referencia editables, no una importación automática del agente. Las capturas y los ajustes que puedes copiar usan etiquetas de interfaz en inglés.
Sigue los pasos para preparar la colección, conectar la hoja de cálculo, obtener una recomendación, registrar una partida y evitar repeticiones.
¿Qué sabrá tu selector para noches de juegos?
Shelf Night combina datos registrados sobre los juegos con las preferencias de tu casa. La hoja contiene ambos en columnas separadas para que el asistente pueda explicar en qué se basa cada recomendación.
La propiedad, el número de jugadores y el tiempo previsto descartan distintos tipos de sugerencias inadecuadas.
El ejemplo usa dos juegos básicos reales y dos casos límite deliberados. Las editoriales indican que Azul es para 2–4 jugadores y Cascadia para 1–4 jugadores. Nuestra familia ficticia reserva 60 minutos para cualquiera de los dos, incluida la preparación y la explicación. Es nuestra previsión, no una garantía de duración de la editorial.
Comprueba la edición de tu estantería. Imágenes de producto: Next Move Games / Asmodee y Alderac Entertainment Group / Flatout Games. La duración publicada y el tiempo que prevé tu grupo son valores distintos.
Necesitas una cuenta de Quickchat AI, una cuenta de Google que pueda autorizar la conexión con Sheets y unos cuantos juegos que catalogar. La cuenta de BoardGameGeek es opcional. Consulta los límites actuales de créditos de IA y acciones de tu cuenta; las conversaciones y Simulation Testing consumen créditos.
Paso 1: ¿Cómo preparas tu colección de juegos de mesa?
Empieza con una colección pequeña que puedas comprobar a simple vista. Registra un identificador estable, la propiedad, el rango de jugadores y un tiempo previsto para cada juego antes de pedir al asistente que elija.
- Abre
Collection.tsvdel kit. Conserva los nombres y el orden de las cabeceras. Sustituye las filas de ejemplo por las tuyas más adelante, cuando funcione la primera prueba. - Asigna a cada caja un
game_idestable, comoSHELF-001. Incluye la edición o expansión en el título cuando afecte a las reglas. No trates una expansión como un juego independiente. - Copia el número de jugadores de la caja, el reglamento o la editorial. Establece
planning_minutessegún el tiempo que necesita tu grupo, incluida la explicación. Deja en blanco los valores sin verificar. - Elige tus propias etiquetas de
complexity, comolightomedium. Registra la propiedad explícitamente. Una entrada de la lista de deseos debe tenerownedenFALSE.
| Juego de ejemplo | Jugadores | Tiempo previsto | En propiedad | Qué enseña |
|---|---|---|---|---|
Azul, SHELF-001 | 2–4 | 60 minutos | TRUE | Un candidato con datos completos |
Cascadia (juego básico), SHELF-002 | 1–4 | 60 minutos | TRUE | Un candidato que registraremos y excluiremos después |
Ejemplo de la lista de deseos, SHELF-003 | 2–4 | 45 minutos | FALSE | Un juego puede encajar sin que lo tengas |
Juego de viaje sin catalogar, SHELF-004 | Mínimo 2; máximo desconocido | Desconocido | TRUE | Los datos que faltan deben seguir siendo desconocidos |
La colección inicial tiene dos candidatos completos, una fila de un juego que no tienes y una entrada incompleta. Cada exclusión se puede comprobar en los datos de origen.
Las columnas restantes son source_url, last_played y language_note. Conserva el enlace de la fuente cuando esté disponible, usa las notas de idioma para tu edición y deja que una fórmula rellene last_played en el paso 5. Tener un juego en propiedad no garantiza que la caja esté físicamente en casa: dile al asistente que excluya los que hayas prestado.
¿Puedes empezar con una exportación de tu colección de BoardGameGeek?
Sí. Inicia sesión en tu cuenta de BGG, abre tu colección y usa la descarga de la colección para los juegos que tienes. Guarda el CSV original por separado, revisa sus cabeceras reales y transfiere los valores pertinentes a esta plantilla. Completa los números de jugadores o las estimaciones de tiempo que falten con tu propia edición en vez de pedir al modelo que los adivine.
Las condiciones oficiales de acceso de BGG distinguen entre descargar tu propia colección con la sesión iniciada y el acceso automatizado registrado mediante API. Esta receta usa una exportación o introducción manual. No requiere una conexión con la API de BGG ni sincroniza los cambios de BGG.
Paso 2: ¿Cómo conectas Google Sheets al asistente?
Usa la hoja de cálculo creada por la conexión de Quickchat AI con Google Sheets. Su permiso de archivo no se extiende automáticamente a cualquier hoja de cálculo que ya tengas en Drive.
- Crea una cuenta de Quickchat AI. Usa el agente inicial o elige Add new AI Agent → Set up manually. Llámalo Shelf Night.
- Abre Your Website → Install → Availability and access. Desactiva Widget & Embed access y establece Chat Page Access → Nobody. Mantén esta primera versión dentro de tu AI Preview con sesión autenticada.
- Abre Actions & MCPs → Add Action → Google Sheets y completa la autorización de Google. La integración solicita el permiso limitado
drive.filey crea una hoja de cálculo con una pestaña Leads. - Desactiva la acción generada
log_lead_to_google_sheetmientras la adaptas. Conserva su nombre para que la conexión pueda seguir reconociéndola. Elige Open sheet y cambia el nombre del archivo a Shelf Night. - Cambia el nombre de Leads a Plays, sustituye sus antiguas cabeceras pegando
Plays.tsven A1 y añade una pestaña Collection. Mantén al menos 501 filas en Plays y 101 en Collection. - En File → Settings, elige la configuración regional United States para las fórmulas del kit separadas por comas. Aplica el formato Plain text a la columna A de Plays antes de introducir fechas. Pega
Collection.tsven Collection!A1, dejando que se calculen las fórmulas de la columna I. Inmoviliza y pon en negrita cada fila de cabeceras; ensancha las columnas o ajusta el texto para que los valores sean legibles.
Las vistas compactas de este artículo ocultan temporalmente las columnas C:F, H y J para que se lean bien el juego, la propiedad y la fecha de la última partida. La pestaña Collection original, de diez columnas, y el rango A:J de la acción permanecen intactos.
Configura ambos controles de acceso antes de conectar tu colección. El tutorial usa la AI Preview del panel.
La guía de conexión con Google Sheets explica las pantallas de autorización. No incluyas comentarios personales de BGG ni datos de la colección que no sean pertinentes en este pequeño archivo de demostración.
Paso 3: ¿Cómo obtienes una recomendación de tu propia estantería?
Añade una acción de solo lectura y dale al agente reglas para usar su respuesta. Esto basta para conseguir tu primera selección útil; la acción de registro puede seguir desactivada.
Lee la colección
Abre Actions & MCPs → Add Action → API Action → Create manually. Llama a la acción Read Shelf Night collection, establece When to run → AI decides e introduce:
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101
Headers
Authorization: Bearer {{google_sheets_access_token}}
Sustituye YOUR_CREATED_SHEET_ID por el identificador que ya figura en la URL de la acción inicial desactivada. Usa el token integrado de Google Sheets de Add AI Data → System Tokens; déjalo como variable, en lugar de pegar un token de acceso. Mantén fijos el identificador del archivo y el rango, sin parámetros de entrada, cuerpo ni parámetros de consulta. Deja Response filter vacío.
Usa esta API Action Description:
Read the collection before recommending games. Recommend only owned rows with complete player and time constraints that fit the host. Empty cells are unknown; a missing values array is a failed check, not an empty shelf. Use only returned facts and owner notes.
Lee juntas la cabecera y las filas de la colección. Mantén la hoja de cálculo y el rango fuera del control de la conversación.
Guarda y activa la acción. Ejecuta Test Response y compara values con la hoja. El endpoint values.get de Google devuelve de forma predeterminada valores de celda con formato; los números y los booleanos pueden llegar como cadenas, y las celdas vacías al final pueden omitirse. Una fila corta no da permiso para inventar los valores que faltan.
Dale sus reglas a Shelf Night
Abre Identity → Main Prompt, pega main-prompt.txt del kit y guarda. Su regla de selección es concreta: volver a leer la colección, exigir la propiedad y las restricciones completas, devolver como máximo tres coincidencias y explicar cualquier dato que falte.
El Main Prompt explica cómo elegir. Estos dos recortes muestran su ubicación y las instrucciones iniciales; la acción aporta la colección actual.
En AI Preview, pregunta:
Four players, 60 minutes, something light. What do we own that fits?
La primera respuesta útil: Azul y Cascadia cumplen las condiciones registradas de propiedad, jugadores y tiempo.
Con los datos de ejemplo, Azul y Cascadia cumplen los requisitos. La fila de la lista de deseos no cumple el de propiedad; al juego de viaje le faltan datos. Abre la conversación guardada en Inbox, despliega su llamada a la acción e inspecciona los valores devueltos. Usa View logs en la tarjeta de la acción para ver el registro completo de la solicitud.
Compara la respuesta con los datos en los que se basa. Un marcador de acción indica que hubo una llamada; su resultado indica qué recibió realmente el asistente.
Deja que ChatGPT o Claude preparen los ajustes
La conexión de gestión de cuentas de Quickchat AI puede preparar el Main Prompt y las acciones HTTP. Conéctala desde la ficha oficial de ChatGPT o la ficha de Claude, siguiendo la guía de gestión de cuentas. Adjunta el kit y envía:
Use Quickchat AI to prepare Shelf Night from the attached main-prompt.txt and action-recipes.json. Identify the intended Agent before changing it. Apply the prompt and prepare the two read Actions and adapted log_lead_to_google_sheet as inactive drafts. Preserve the starter Action's name. Use the actual spreadsheet ID from my Google Sheets connection. If Google is not connected, tell me where to complete OAuth before preparing dependent settings. Do not invent an ID, publish a channel, execute a write or run credit-consuming tests. Show me the saved configuration and remaining manual steps.
Tú sigues teniendo que autorizar Google, rellenar la hoja y verificar las filas reales. Preparar los ajustes mediante un asistente no completa esos pasos.
Paso 4: ¿Cómo registras una partida terminada de un juego de mesa?
Mantén una fila por partida terminada y exige confirmación antes de añadirla. Sugerir Cascadia nunca debería contar como haber jugado a Cascadia.
La fecha y el identificador del juego vinculan una sesión terminada con la siguiente selección.
Añade una acción de lectura para el registro de partidas
Crea una segunda acción llamada Read Shelf Night plays con los mismos ajustes GET y la misma cabecera de token que la primera, cambiando el rango a:
https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501
Establece su descripción en:
Read recorded plays when excluding repeats, before logging a confirmed play, after an append, and whenever a write result is uncertain. Match stable game IDs. An absent play is not proof that a game was never played.
Guárdala y actívala. Un registro vacío debería devolver al menos la cabecera: played_date, game_id, players, duration_minutes, note.
Adapta la acción inicial para añadir una partida
Edita la acción inicial desactivada y conserva el nombre log_lead_to_google_sheet. Sustituye los antiguos parámetros de contactos, el cuerpo de la solicitud, la descripción y el mensaje de procesamiento. El nombre heredado es solo un identificador; ahora esta acción registrará partidas.
En What to ask the user first, añade:
Copia los parámetros de la partida y la solicitud para añadir una fila
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
played_date | Text | Sí | Fecha exacta confirmada en formato YYYY-MM-DD. Pregunta en lugar de adivinar una fecha relativa. |
game_id | Text | Sí | Identificador exacto devuelto por Collection y confirmado por quien organiza. |
players | Number | Sí | Número confirmado de personas que jugaron. |
duration_minutes | Number | Sí | Duración real confirmada, no el tiempo previsto. |
note | Text | No | Nota factual opcional proporcionada por quien organiza. Vacía si se omite. |
Para note, elige Default value → Empty value. Usa AI decides y deja Response filter vacío. Configura la solicitud y Query Params así:
POST https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A:E:append
Query Params
valueInputOption: RAW
insertDataOption: OVERWRITE
includeValuesInResponse: true
Headers
Authorization: Bearer {{google_sheets_access_token}}
Content-Type: application/json
En Body, mantén activado el modo JSON y sustituye el cuerpo anterior de la acción inicial por:
{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}
El orden de los valores debe coincidir con las cinco columnas. RAW almacena el texto proporcionado literalmente, por lo que una nota que empiece por = no se convierte en una fórmula. El endpoint append busca la siguiente fila después de la tabla; OVERWRITE rellena esa fila vacía existente y conserva su formato y el rango de la fórmula de la última partida. La referencia de append de Google explica las opciones. Mantén Plays como un único registro continuo sin otra tabla al lado.
Copia la descripción de la operación de añadir desde action-recipes.json. Exige una confirmación aparte, una comprobación de duplicados, una sola adición y una lectura posterior. Establece el mensaje de procesamiento en Recording the confirmed play..., guarda y activa la acción. Usar Test Response en este POST puede añadir una fila real.
Juega, comunícalo y confirma
Envía esto en AI Preview:
We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.
El asistente debe mostrar los campos propuestos y esperar. Comprueba que Plays no haya cambiado antes de confirmar.
Shelf Night pide confirmación. La pestaña Plays real todavía contiene solo la fila de cabeceras.
Responde «Confirmo». Revisa el resultado de la operación de añadir una fila para comprobar updates.updatedRows: 1, su updatedRange y la lectura posterior. La hoja real debe contener 2026-11-08, SHELF-002, 4, 52 y una nota vacía.
La partida confirmada aparece una sola vez en Plays, bajo las mismas cinco cabeceras. El agente volvió a leer el registro antes de comunicar que se había guardado.
La operación append devolvió una fila actualizada. El rango devuelto coincide con la fila rellenada que se ve en Google Sheets.
La confirmación y las comprobaciones de duplicados son instrucciones del agente, no una restricción atómica de base de datos. Si una solicitud agota el tiempo de espera, inspecciona el registro antes de reintentarlo. Dos conversaciones simultáneas aún pueden añadir el mismo informe; este pequeño registro personal no implementa un sistema de reservas ni un bloqueo de transacciones.
Paso 5: ¿Cómo evitas los juegos a los que habéis jugado recientemente?
Lee el historial de partidas usando una fecha de corte explícita. En el ejemplo, excluir los juegos jugados a partir del 2026-11-01, inclusive, elimina Cascadia y mantiene Azul.
El kit también añade una fórmula de última partida en Collection!I2 y la extiende hacia abajo por las filas de ejemplo:
=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")
Busca coincidencias con el identificador estable del juego, ordena las fechas ISO de longitud fija de más reciente a más antigua y devuelve la última fecha registrada. Así, una sesión antigua comunicada con retraso no se convierte en la partida más reciente. Si no hay ninguna coincidencia, la celda queda en blanco.
Tras introducir la partida de Cascadia, comprueba que Collection!I3 muestra 2026-11-08. Si la fórmula aparece como texto literal, restablece el formato Automático de esa celda y vuelve a introducirla. Mantén las fechas de Plays como texto sin formato y comprueba la configuración regional y los nombres exactos de las pestañas si la fórmula da error. Google documenta la función FILTER que se usa para seleccionar las filas coincidentes.
Collection!I3 calcula la última partida registrada de Cascadia a partir de Plays. La celda seleccionada muestra tanto la fórmula como su resultado, 2026-11-08.
Inicia una conversación nueva y pregunta:
Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.
La nueva consulta excluye la partida registrada de Cascadia y devuelve Azul. Una celda last_played vacía significa que no hay ninguna partida registrada en este historial.
Los rangos de lectura iniciales abarcan 100 juegos y 500 partidas, sin contar las cabeceras. A medida que crezca el archivo, mantén las acciones de lectura y los rangos de las fórmulas alineados con los registros reales. Mantén el ajuste de append en insertDataOption: OVERWRITE para que una nueva entrada no desplace la fila inicial de la fórmula más allá de la partida que acabas de registrar.
Paso 6: ¿Cómo compruebas que las recomendaciones se basan en datos?
Prueba los casos en los que tu colección no puede ofrecer una respuesta. Un selector útil debería explicar el límite y dejarte decidir qué cambiar.
Pide algo para seis jugadores, 60 minutos y ligero. Ninguna de las filas completas de juegos en propiedad admite seis, y el máximo del juego de viaje es desconocido. El asistente no debería tomar el número de jugadores de una expansión de Cascadia ni recomendar algo de la lista de deseos.
Una respuesta sin coincidencias mantiene visibles las restricciones originales. Añade un juego verificado para seis jugadores o cambia el plan de la noche.
Usa Testing → Simulation Testing para hacer comprobaciones repetibles e inspecciona los resultados de las acciones junto con las respuestas. Mantén el intercambio de confirmación en una sola conversación para que «Confirmo» apruebe una propuesta concreta.
Las comprobaciones guardadas de la colección cubren una recomendación normal, seis jugadores, un juego que no tienes y datos incompletos. Revisa los resultados de las acciones correspondientes además de las puntuaciones.
| Prueba esto | Comprueba esto |
|---|---|
| Cuatro jugadores, 60 minutos, ligero | Solo Azul y Cascadia, con motivos basados en los datos registrados |
| Seis jugadores | Ninguna opción verificada; sin inventar capacidad |
| Recomienda el ejemplo de la lista de deseos | La exclusión por propiedad sigue vigente |
| ¿Cuánto dura el juego de viaje? | El tiempo que falta sigue siendo desconocido |
| Comunica una partida, antes de confirmar | Ninguna fila nueva en Plays |
| Confirma y vuelve a confirmar | Una fila en esta prueba, sin una segunda adición |
| Excluye partidas a partir del 2026-11-01, inclusive | Cascadia queda excluido tras registrar la partida |
Las cuatro comprobaciones de la colección se superaron en Simulation Testing. También verificamos la confirmación por separado, una única fila añadida, el resultado de su fórmula, una confirmación repetida sin otra inserción y una nueva recomendación que excluía Cascadia. Repite la lista de comprobación del kit con tu propio archivo antes de sustituir las filas de ejemplo.
Cuando superes esas comprobaciones, sustituye las filas de ejemplo por tu colección. La próxima vez que os sentéis a jugar, dale a Shelf Night el número de jugadores, el tiempo y lo que os apetece, elige entre las opciones devueltas y registra la partida al terminar. Cada noche registrada aporta un poco más de contexto a la siguiente elección.
Si buscas otro proyecto basado en una colección, el selector de juegos pendientes de Steam usa la misma idea con tiempo de juego registrado y notas personales. La guía del constructor de acciones de API explica cómo adaptar este patrón a otras fuentes de datos.
Preguntas frecuentes
¿Puede un recomendador de juegos de mesa sugerir solo juegos que tengo?
Sí. Esta configuración lee tu pestaña Collection antes de recomendar y exige que owned sea TRUE. Comprueba los límites de jugadores registrados y tu tiempo previsto, y después explica cada coincidencia. Mantén actualizados los datos de propiedad y edición.
¿Puedo usar mi colección de BoardGameGeek sin una clave de API?
Sí. Empieza con un CSV de tu colección de BGG descargado manualmente o introduce unos pocos juegos en la plantilla. Revisa las columnas exportadas y completa los datos que falten con los de tu edición. Este flujo no llama a la API de BGG ni sincroniza tu colección automáticamente.
¿Hay una plantilla de hoja de cálculo para colecciones de juegos de mesa?
El kit inicial de Shelf Night incluye Collection.tsv, Plays.tsv, fórmulas para la última partida, tres recetas de acciones, un Main Prompt y una lista de comprobación de pruebas. Pega los archivos de las pestañas en la hoja de cálculo creada por la conexión de Quickchat AI con Google Sheets.
¿La estimación de tiempo incluye la explicación y la preparación?
La columna planning_minutes recoge el tiempo que prevéis en casa, por lo que puedes incluir ambas cosas. El ejemplo asigna 60 minutos a Azul y Cascadia. La duración real se anota en el registro de partidas después de jugar; es un dato distinto de la estimación prevista.
¿Puede evitar juegos de mesa a los que hemos jugado recientemente?
Sí, mediante las partidas registradas y una fecha de corte exacta. En el ejemplo probado, registrar Cascadia el 2026-11-08 y excluir los juegos registrados el 2026-11-01 o después lo elimina de la siguiente selección. Las sesiones no registradas siguen siendo desconocidas, y los rangos de lectura deben abarcar el historial pertinente.
¿Qué ocurre si ningún juego que tenemos encaja con el grupo?
El asistente debería explicar qué límites registrados descartan los candidatos y preguntar qué quieres cambiar. No debería inventar un número de jugadores, ampliar el tiempo disponible sin avisar ni sustituirlos por un juego que no tienes.
¿Pueden ChatGPT o Claude ayudar a configurarlo?
La conexión de gestión de cuentas de Quickchat AI puede preparar las instrucciones del agente y las acciones HTTP a partir del kit. Tú sigues teniendo que autorizar Google, introducir tu colección y verificar la hoja de cálculo real. Preparar la configuración no ejecuta pruebas ni publica el agente.