Un assistant de recommandation pour votre propre collection de jeux de société compare les jeux que vous possédez au nombre de joueurs de ce soir, au temps disponible et à vos préférences. Shelf Night lit cette collection depuis Google Sheets, enregistre une partie terminée après confirmation et utilise le journal pour éviter les répétitions récentes.
Vous êtes quatre autour de la table, vous avez une heure pour jouer et Azul comme Cascadia sont sur l’étagère. La première sélection comprend les deux. Après l’enregistrement d’une partie de Cascadia, la requête suivante l’exclut et conserve Azul.
L’objectif : Cascadia est enregistré dans le journal des parties, et Shelf Night recommande Azul quand vous demandez d’éviter les répétitions récentes.
Les captures de Google Sheets montrent notre fichier de test connecté. Les captures de Quickchat AI utilisent l’application locale pour afficher les réponses et les résultats des actions enregistrés par notre agent de test en fonctionnement réel.
Vous configurerez d’abord la lecture de la collection, puis ajouterez l’enregistrement des parties confirmées et la vérification des jeux récents. Vous vérifierez la ligne enregistrée ainsi que la réponse.
Téléchargez le kit de démarrage Shelf Night. Il contient deux fichiers de feuille de calcul à valeurs séparées par des tabulations, les instructions complètes, trois modèles d’actions et une liste de vérifications. Ce sont des fichiers de référence modifiables, pas un import automatique d’agent. Les captures d’écran et les paramètres à copier utilisent les libellés anglais de l’interface.
Suivez les étapes pour préparer la ludothèque, connecter la feuille de calcul, obtenir une recommandation, consigner une partie et éviter les répétitions.
Que saura votre assistant de soirée jeux ?
Shelf Night associe les informations consignées sur les jeux aux préférences de votre foyer. La feuille contient les deux, dans des colonnes distinctes, afin que l’assistant puisse expliquer sur quoi repose une recommandation.
La possession, le nombre de joueurs et le temps prévu éliminent chacun un type de suggestion inadaptée.
L’exemple utilise deux véritables jeux de base et deux cas limites délibérés. Les éditeurs indiquent 2–4 joueurs pour Azul et 1–4 joueurs pour Cascadia. Notre foyer fictif prévoit 60 minutes pour chacun, mise en place et explication comprises. Ce temps est notre estimation, pas une durée garantie par l’éditeur.
Vérifiez l’édition présente dans votre ludothèque. Images des produits : Next Move Games / Asmodee et Alderac Entertainment Group / Flatout Games. Les durées annoncées par l’éditeur et le temps prévu par votre groupe sont des valeurs distinctes.
Il vous faut un compte Quickchat AI, un compte Google permettant d’autoriser la connexion Sheets et quelques jeux à cataloguer. Un compte BoardGameGeek est facultatif. Consultez les quotas actuels de crédits IA et d’actions de votre compte ; les conversations et Simulation Testing consomment des crédits.
Étape 1 : comment préparer votre collection de jeux de société ?
Commencez par une petite ludothèque que vous pouvez vérifier visuellement. Consignez un identifiant stable, la possession, la plage de joueurs et le temps prévu pour chaque jeu avant de demander à l’assistant de choisir.
- Ouvrez le fichier
Collection.tsvdu kit. Conservez les noms et l’ordre des en-têtes. Vous remplacerez les lignes d’exemple par les vôtres après avoir réussi le premier test. - Attribuez à chaque boîte un
game_idstable, commeSHELF-001. Incluez l’édition ou l’extension dans le titre lorsque cela modifie les règles. Ne considérez pas une extension comme un jeu autonome. - Recopiez les nombres de joueurs indiqués sur la boîte, dans les règles ou par l’éditeur. Définissez
planning_minutesselon le temps nécessaire à votre groupe, explication comprise. Laissez les valeurs non vérifiées vides. - Choisissez vos propres libellés
complexity, commelightoumedium. Indiquez explicitement la possession. Pour un jeu de votre liste de souhaits,owneddoit être défini surFALSE.
| Jeu d’exemple | Joueurs | Temps prévu | Possédé | Ce qu’il illustre |
|---|---|---|---|---|
Azul, SHELF-001 | 2–4 | 60 minutes | TRUE | Un candidat aux informations complètes |
Cascadia (jeu de base), SHELF-002 | 1–4 | 60 minutes | TRUE | Un candidat dont nous consignerons une partie avant de l’exclure |
Exemple de liste de souhaits, SHELF-003 | 2–4 | 45 minutes | FALSE | Un jeu adapté peut ne pas être possédé |
Jeu de voyage non catalogué, SHELF-004 | Minimum 2 ; maximum inconnu | Inconnu | TRUE | Les informations manquantes doivent rester inconnues |
La collection de départ comprend deux candidats complets, une ligne pour un jeu non possédé et une entrée incomplète. Chaque exclusion est visible dans les données sources.
Les colonnes restantes sont source_url, last_played et language_note. Conservez le lien source lorsqu’il existe, utilisez les notes de langue pour votre édition et laissez une formule remplir last_played à l’étape 5. Posséder une boîte ne garantit pas qu’elle soit physiquement chez vous : demandez à l’assistant d’exclure tout jeu prêté.
Peut-on partir d’un export de collection BoardGameGeek ?
Oui. Connectez-vous à votre propre compte BGG, ouvrez votre collection et utilisez la fonction de téléchargement de collection pour les jeux possédés. Conservez séparément le CSV brut, examinez ses en-têtes réels, puis transférez les valeurs pertinentes dans ce modèle. Complétez les nombres de joueurs ou les estimations de temps manquants à partir de votre édition plutôt que de demander au modèle de les deviner.
Les conditions d’accès officielles de BGG distinguent le téléchargement de votre propre collection en étant connecté de l’accès automatisé à l’API après inscription. Cette méthode utilise un export manuel ou une saisie manuelle. Elle ne nécessite aucune connexion à l’API BGG et ne synchronise pas les modifications apportées sur BGG.
Étape 2 : comment connecter Google Sheets à l’assistant ?
Utilisez la feuille de calcul créée par la connexion Google Sheets de Quickchat AI. Son autorisation d’accès au fichier ne s’étend pas automatiquement à une autre feuille de calcul déjà présente dans votre Drive.
- Créez un compte Quickchat AI. Utilisez l’agent initial ou choisissez Add new AI Agent → Set up manually. Nommez-le Shelf Night.
- Ouvrez Your Website → Install → Availability and access. Désactivez Widget & Embed access et réglez Chat Page Access → Nobody. Gardez cette première version dans votre espace AI Preview accessible après authentification.
- Ouvrez Actions & MCPs → Add Action → Google Sheets et terminez l’autorisation Google. L’intégration demande la portée limitée
drive.fileet crée une feuille de calcul avec un onglet Leads. - Désactivez l’action
log_lead_to_google_sheetgénérée pendant son adaptation. Conservez son nom pour que la connexion puisse toujours la reconnaître. Choisissez Open sheet et renommez le fichier Shelf Night. - Renommez Leads en Plays, remplacez ses anciens en-têtes en collant
Plays.tsvdans A1, puis ajoutez un onglet Collection. Conservez au moins 501 lignes dans Plays et 101 dans l’onglet de collection. - Dans File → Settings, choisissez les paramètres régionaux United States pour les formules du kit utilisant des virgules comme séparateurs. Appliquez le format Plain text à la colonne A de Plays avant de saisir les dates. Collez
Collection.tsvdans Collection!A1, en laissant les formules de la colonne I se calculer. Figez chaque ligne d’en-tête et mettez-la en gras ; élargissez les colonnes ou activez le renvoi à la ligne pour rendre les valeurs lisibles.
Les vues compactes de cet article masquent temporairement les colonnes C:F, H et J pour garder lisibles le jeu, la possession et la date de la dernière partie. L’onglet Collection sous-jacent à dix colonnes et la plage A:J de l’action restent inchangés.
Réglez les deux contrôles d’accès avant de connecter votre collection. Le tutoriel utilise AI Preview dans le tableau de bord.
Le guide de connexion à Google Sheets détaille les écrans d’autorisation. N’incluez pas vos commentaires BGG personnels ni les données de collection sans rapport avec ce petit fichier de démonstration.
Étape 3 : comment obtenir une recommandation issue de votre ludothèque ?
Ajoutez une action en lecture seule et donnez à l’agent des règles pour exploiter sa réponse. Cela suffit à obtenir une première sélection utile ; l’action d’enregistrement peut rester désactivée.
Lire la collection
Ouvrez Actions & MCPs → Add Action → Action API → Create manually. Nommez l’action Read Shelf Night collection, réglez When to run → AI decides et saisissez :
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101
Headers
Authorization: Bearer {{google_sheets_access_token}}
Remplacez YOUR_CREATED_SHEET_ID par l’identifiant déjà présent dans l’URL de l’action initiale désactivée. Utilisez le jeton Google Sheets intégré depuis Add AI Data → System Tokens ; laissez-le sous forme de variable plutôt que de coller un jeton d’accès. Gardez l’identifiant du fichier et la plage fixes, sans paramètres d’entrée, sans corps et sans paramètres de requête. Laissez Response filter vide.
Utilisez cette description dans 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.
Lisez ensemble l’en-tête et les lignes de collection. Gardez le choix de la feuille de calcul et de la plage hors du contrôle de la conversation.
Enregistrez et activez l’action. Lancez Test Response et comparez values avec la feuille. Le point de terminaison values.get de Google renvoie par défaut les valeurs formatées des cellules ; les nombres et les booléens peuvent arriver sous forme de chaînes, et les cellules vides en fin de ligne peuvent être omises. Une ligne courte n’autorise pas à inventer les valeurs manquantes.
Donner ses règles à Shelf Night
Ouvrez Identity → Main Prompt, collez le contenu de main-prompt.txt fourni dans le kit et enregistrez. La règle de sélection est précise : relire la ludothèque, exiger la possession et des contraintes complètes, renvoyer au maximum trois correspondances et expliquer toute information manquante.
Le Main Prompt explique comment choisir. Ces deux vues recadrées montrent son emplacement et ses premières instructions ; l’action fournit la collection actuelle.
Dans AI Preview, demandez :
Four players, 60 minutes, something light. What do we own that fits?
La première réponse utile : Azul et Cascadia respectent les contraintes enregistrées de possession, de joueurs et de temps.
Avec les données d’exemple, Azul et Cascadia conviennent. Le jeu de la liste de souhaits est exclu car il n’est pas possédé ; les informations sur le jeu de voyage sont insuffisantes. Ouvrez la conversation enregistrée dans Inbox, dépliez son appel d’action et examinez les valeurs renvoyées. Utilisez View logs sur la fiche de l’action pour consulter la trace complète de la requête.
Comparez la réponse aux données sur lesquelles elle repose. Un marqueur d’action indique qu’un appel a eu lieu ; son résultat montre ce que l’assistant a réellement reçu.
Faire préparer les paramètres par ChatGPT ou Claude
La connexion de gestion de compte de Quickchat AI peut préparer le Main Prompt et les actions HTTP. Connectez-vous via la fiche officielle ChatGPT ou la fiche officielle Claude, en suivant le guide de gestion de compte. Joignez le kit et envoyez :
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.
Vous devez toujours autoriser Google, remplir la feuille et vérifier les lignes réelles. Préparer les paramètres avec un assistant n’accomplit pas ces étapes.
Étape 4 : comment consigner une partie de jeu de société terminée ?
Conservez une ligne par partie terminée et exigez une confirmation avant tout ajout. Suggérer Cascadia ne doit jamais compter comme une partie de Cascadia.
La date et l’identifiant du jeu relient une session terminée à la sélection suivante.
Ajouter une action de lecture du journal des parties
Créez une deuxième action nommée Read Shelf Night plays, avec les mêmes paramètres GET et le même en-tête de jeton que la première, en remplaçant la plage par :
https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501
Définissez sa description ainsi :
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.
Enregistrez-la et activez-la. Un journal vide doit tout de même renvoyer l’en-tête : played_date, game_id, players, duration_minutes, note.
Adapter l’action initiale pour ajouter une partie
Modifiez l’action initiale désactivée en conservant le nom log_lead_to_google_sheet. Remplacez ses anciens paramètres de prospect, son corps de requête, sa description et son message de réflexion. Le nom hérité n’est qu’un identifiant ; cette action enregistrera désormais des parties.
Dans What to ask the user first, ajoutez :
Copiez les paramètres de la partie et la requête d’ajout
| Paramètre | Type de donnée | Obligatoire | Description du paramètre |
|---|---|---|---|
played_date | Text | Oui | Date exacte confirmée au format AAAA-MM-JJ. Demander plutôt que déduire une date relative. |
game_id | Text | Oui | Identifiant exact renvoyé par l’onglet de collection et confirmé par l’hôte. |
players | Number | Oui | Nombre confirmé de personnes ayant joué. |
duration_minutes | Number | Oui | Durée réelle confirmée, et non temps prévu. |
note | Text | Non | Note factuelle facultative fournie par l’hôte. Vide si omise. |
Pour note, choisissez Default value → Empty value. Utilisez AI decides et laissez Response filter vide. Configurez la requête et Query Params ainsi :
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
Dans Body, gardez le mode JSON activé et remplacez l’ancien corps de requête de l’action de départ par :
{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}
L’ordre des valeurs doit correspondre aux cinq colonnes. RAW stocke le texte fourni tel quel : une note commençant par = ne devient donc pas une formule. Le point de terminaison append trouve la ligne suivante après le tableau ; OVERWRITE remplit cette ligne vide existante en préservant sa mise en forme et la plage de la formule de dernière partie. La documentation de l’ajout de Google explique les options. Gardez Plays sous forme d’un journal continu, sans autre tableau à côté.
Copiez la description d’ajout depuis action-recipes.json. Elle exige une confirmation distincte, une vérification des doublons, un seul ajout et une lecture après celui-ci. Définissez le message de réflexion sur Recording the confirmed play..., enregistrez et activez l’action. Utiliser Test Response sur cette requête POST peut ajouter une véritable ligne.
Jouer, signaler, confirmer
Envoyez ceci dans AI Preview :
We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.
L’assistant doit afficher les champs proposés et attendre. Vérifiez que Plays n’a pas changé avant de confirmer.
Shelf Night demande confirmation. L’onglet Plays réel ne contient encore que la ligne d’en-têtes.
Répondez « Je confirme. » Vérifiez que le résultat de l’ajout contient updates.updatedRows: 1, examinez la valeur de updatedRange, puis la lecture qui suit. La feuille réelle doit contenir 2026-11-08, SHELF-002, 4, 52 et une note vide.
La partie confirmée apparaît une seule fois dans Plays, sous les mêmes cinq en-têtes. L’agent a relu le journal avant d’annoncer la réussite de l’enregistrement.
L’ajout a renvoyé une ligne mise à jour. La plage renvoyée correspond à la ligne remplie visible dans Google Sheets.
La confirmation et les vérifications de doublons sont des instructions de l’agent, pas une contrainte atomique de base de données. Si une requête expire, examinez le journal avant de réessayer. Deux conversations simultanées peuvent toujours ajouter le même compte rendu ; ce petit journal personnel ne met en œuvre ni système de réservation ni verrou de transaction.
Étape 5 : comment éviter les jeux auxquels vous avez joué récemment ?
Lisez l’historique des parties à l’aide d’une date limite explicite. Dans l’exemple, exclure les jeux joués à partir du 2026-11-01 retire Cascadia et conserve Azul.
Le kit ajoute aussi une formule de dernière partie dans Collection!I2 et la recopie sur les lignes d’exemple :
=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")
Elle recherche l’identifiant stable du jeu, trie les chaînes de dates ISO de longueur fixe de la plus récente à la plus ancienne et renvoie la dernière date consignée. Le signalement tardif d’une ancienne session ne devient donc pas la partie la plus récente. Sans partie correspondante, la cellule reste vide.
Après la saisie de Cascadia, vérifiez que Collection!I3 affiche 2026-11-08. Si la formule s’affiche comme du texte, rétablissez le format automatique de cette cellule et saisissez-la à nouveau. Conservez les dates de Plays en texte brut et vérifiez les paramètres régionaux ainsi que les noms exacts des onglets si la formule renvoie une erreur. Google documente la fonction FILTER utilisée pour sélectionner les lignes correspondantes.
Collection!I3 calcule la dernière partie enregistrée de Cascadia à partir de Plays. La cellule sélectionnée montre la formule et son résultat, 2026-11-08.
Démarrez une nouvelle conversation et demandez :
Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.
La nouvelle requête exclut la partie enregistrée de Cascadia et renvoie Azul. Une cellule last_played vide signifie qu’aucune partie n’est enregistrée dans ce journal.
Les plages de lecture initiales couvrent 100 jeux et 500 parties, hors en-têtes. À mesure que le fichier s’agrandit, gardez les plages des actions de lecture et des formules alignées sur les enregistrements réels. Conservez le paramètre d’ajout insertDataOption: OVERWRITE pour qu’une nouvelle entrée ne décale pas la première ligne de la formule au-delà de la partie que vous venez d’enregistrer.
Étape 6 : comment vérifier que les recommandations reposent sur les données ?
Testez les cas où la ludothèque ne peut pas fournir de réponse. Un assistant utile doit expliquer la limite et vous laisser décider de ce qu’il faut changer.
Demandez un jeu pour six joueurs, 60 minutes, léger. Aucune des deux lignes complètes de jeux possédés ne convient à six joueurs, et le maximum du jeu de voyage est inconnu. L’assistant ne doit ni reprendre le nombre de joueurs d’une extension de Cascadia, ni recommander un jeu de la liste de souhaits.
Une réponse sans correspondance garde les contraintes initiales visibles. Ajoutez un jeu vérifié pour six joueurs ou modifiez le programme de la soirée.
Utilisez Testing → Simulation Testing pour des vérifications reproductibles et examinez les résultats des actions en parallèle des réponses. Gardez l’échange de confirmation dans une seule conversation afin que « Je confirme » approuve une proposition précise.
Les vérifications enregistrées couvrent une recommandation normale, six joueurs, un jeu non possédé et des informations manquantes. Examinez les résultats des actions correspondantes en plus des scores.
| À essayer | À vérifier |
|---|---|
| Quatre joueurs, 60 minutes, léger | Uniquement Azul et Cascadia, avec des justifications issues des données consignées |
| Six joueurs | Aucune correspondance vérifiée ; aucune capacité inventée |
| Recommander l’exemple de liste de souhaits | L’exclusion pour non-possession reste appliquée |
| Combien de temps dure le jeu de voyage ? | Le temps manquant reste inconnu |
| Signaler une partie, avant de confirmer | Aucune nouvelle ligne dans Plays |
| Confirmer, puis confirmer à nouveau | Une seule ligne dans ce test, sans second ajout |
| Exclure les parties à partir du 2026-11-01 | Cascadia exclu après la partie consignée |
Les quatre vérifications de collection ont réussi dans Simulation Testing. Nous avons aussi vérifié la confirmation séparée, l’ajout d’une seule ligne, le résultat de sa formule, une confirmation répétée sans nouvel ajout et une nouvelle recommandation qui excluait Cascadia. Reprenez la liste de vérification du kit avec votre propre fichier avant de remplacer les lignes d’exemple.
Une fois ces vérifications réussies, remplacez les lignes d’exemple par votre ludothèque. À votre prochaine soirée jeux, donnez à Shelf Night le nombre de joueurs, le temps disponible et l’ambiance souhaitée, choisissez parmi les propositions et consignez la partie une fois terminée. Chaque soirée enregistrée apporte un peu plus de contexte au choix suivant.
Pour un autre projet fondé sur une collection, l’assistant de sélection de jeux Steam en attente reprend la même idée avec le temps de jeu consigné et des notes personnelles. Le guide de création d’actions API explique comment adapter cette approche à d’autres sources de données.
Questions fréquentes
Un assistant peut-il recommander uniquement les jeux de société que je possède ?
Oui. Cette configuration lit votre onglet Collection avant toute recommandation et exige que owned soit défini sur TRUE. Elle vérifie les limites de joueurs consignées et votre temps prévu, puis explique chaque correspondance. Gardez les informations de possession et d’édition à jour.
Puis-je utiliser ma collection BoardGameGeek sans clé API ?
Oui. Partez du fichier CSV de votre collection BGG téléchargé manuellement ou saisissez quelques jeux dans le modèle. Examinez les colonnes exportées et complétez les informations manquantes à partir de votre édition. Ce processus n’appelle pas l’API BGG et ne synchronise pas automatiquement votre collection.
Existe-t-il un modèle de feuille de calcul pour une collection de jeux de société ?
Le kit de démarrage Shelf Night comprend Collection.tsv, Plays.tsv, des formules de dernière partie, trois modèles d’actions, un Main Prompt et une liste de vérifications. Collez les fichiers d’onglets dans la feuille de calcul créée par la connexion Google Sheets de Quickchat AI.
Le temps estimé comprend-il l’explication des règles et la mise en place ?
La colonne planning_minutes correspond au temps prévu par votre foyer et peut donc inclure les deux. L’exemple attribue 60 minutes à Azul et à Cascadia. La durée réelle est saisie dans le journal des parties après la session ; elle est distincte de l’estimation prévue.
Peut-il éviter les jeux auxquels nous avons joué récemment ?
Oui, à partir des parties consignées et d’une date limite précise. Dans l’exemple testé, enregistrer Cascadia le 2026-11-08 et exclure les jeux enregistrés le 2026-11-01 ou après le retire de la sélection suivante. Les sessions non consignées restent inconnues, et vos plages de lecture doivent couvrir l’historique pertinent.
Que se passe-t-il si aucun jeu possédé ne convient au groupe ?
L’assistant doit expliquer quelles limites consignées excluent les candidats et vous demander ce que vous souhaitez modifier. Il ne doit ni inventer un nombre de joueurs compatible, ni prolonger discrètement le temps disponible, ni proposer à la place un jeu que vous ne possédez pas.
ChatGPT ou Claude peuvent-ils aider à cette configuration ?
La connexion de gestion de compte de Quickchat AI peut préparer les instructions de l’agent et les actions HTTP à partir du kit. Vous devez toujours autoriser Google, saisir votre collection et vérifier la feuille de calcul réelle. Préparer la configuration ne lance aucun test et ne publie pas l’agent.