Een bordspellenadviseur voor je eigen collectie vergelijkt de spellen die je bezit met het spelersaantal, de beschikbare tijd en de voorkeuren voor vanavond. Shelf Night leest die collectie uit Google Sheets, legt een gespeelde sessie na bevestiging vast en gebruikt het logboek om recente herhalingen te vermijden.
Jullie zitten met z’n vieren aan tafel, hebben een uur om te spelen en hebben Azul en Cascadia op de plank. De eerste shortlist bevat beide spellen. Na het vastleggen van een pot Cascadia sluit de volgende vraag dat spel uit en blijft Azul over.
Het einddoel: Cascadia staat in het speellogboek en Shelf Night beveelt Azul aan wanneer je vraagt recente herhalingen te vermijden.
De screenshots van Google Sheets tonen ons gekoppelde testbestand. De screenshots van Quickchat AI gebruiken de lokale app om de antwoorden en Action-resultaten van onze live test-Agent weer te geven.
Je bouwt eerst het lezen van de collectie, voegt daarna bevestigde speelregistratie toe en controleert vervolgens recente sessies. Je controleert zowel de opgeslagen rij als het antwoord.
Download het startpakket van Shelf Night. Het bevat twee tabgescheiden spreadsheetbestanden, de volledige prompt, drie Action-recepten en een testchecklist. Dit zijn bewerkbare referentiebestanden, geen automatische Agent-import. Schermafbeeldingen en kopieerbare instellingen gebruiken Engelse interfacelabels.
Volg de stappen om je collectie voor te bereiden, de spreadsheet te koppelen, een aanbeveling te krijgen, een speelsessie vast te leggen en herhalingen te vermijden.
Wat weet je keuzehulp voor spelavonden?
Shelf Night combineert vastgelegde spelgegevens met de voorkeuren van je huishouden. Beide staan in de spreadsheet, in aparte kolommen zodat de assistent kan uitleggen waarop een aanbeveling is gebaseerd.
Bezit, spelersaantal en planningstijd filteren elk een ander soort ongeschikte suggestie weg.
Het voorbeeld gebruikt twee echte basisspellen en twee bewuste randgevallen. De uitgevers vermelden Azul voor 2–4 spelers en Cascadia voor 1–4 spelers. Ons fictieve huishouden rekent voor beide 60 minuten, inclusief klaarzetten en uitleg. Dat is ons eigen budget, geen speelduurgarantie van de uitgever.
Controleer de editie in je kast. Productafbeeldingen: Next Move Games / Asmodee en Alderac Entertainment Group / Flatout Games. De speelduur van de uitgever en het tijdsbudget van je groep zijn afzonderlijke waarden.
Je hebt een Quickchat AI-account nodig, een Google-account waarmee je de Sheets-koppeling kunt autoriseren en een paar spellen om te catalogiseren. Een BoardGameGeek-account is optioneel. Bekijk de actuele limieten voor AI-credits en Actions voor je account; gesprekken en Simulation Testing verbruiken credits.
Stap 1: Hoe bereid je je bordspellencollectie voor?
Begin met een kleine collectie die je zelf gemakkelijk kunt controleren. Leg voor elk spel een vaste ID, bezit, spelersbereik en tijdsbudget vast voordat je de assistent laat kiezen.
- Open
Collection.tsvuit het pakket. Behoud de kolomnamen en volgorde. Vervang de voorbeeldrijen later door je eigen spellen, nadat de eerste test werkt. - Geef elke doos een vaste
game_id, zoalsSHELF-001. Vermeld de editie of uitbreiding in de titel als die invloed heeft op de regels. Behandel een uitbreiding niet als zelfstandig spel. - Neem spelersaantallen over van de doos, spelregels of uitgever. Stel
planning_minutesin op de tijd die jouw groep nodig heeft, inclusief uitleg. Laat niet-geverifieerde waarden leeg. - Kies je eigen labels voor
complexity, zoalslightofmedium. Leg bezit expliciet vast. Bij een spel op je verlanglijst hoortownedopFALSEte staan.
| Voorbeeldspel | Spelers | Tijdsbudget | In bezit | Wat het laat zien |
|---|---|---|---|---|
Azul, SHELF-001 | 2–4 | 60 minuten | TRUE | Een volledige kandidaat |
Cascadia (basisspel), SHELF-002 | 1–4 | 60 minuten | TRUE | Een kandidaat die we later vastleggen en uitsluiten |
Verlanglijstvoorbeeld, SHELF-003 | 2–4 | 45 minuten | FALSE | Een passende keuze kan toch niet in bezit zijn |
Niet-gecatalogiseerd reisspel, SHELF-004 | Minimaal 2; maximum onbekend | Onbekend | TRUE | Ontbrekende informatie moet onbekend blijven |
De startcollectie bevat twee volledige kandidaten, één spel dat je niet bezit en één onvolledige invoer. Elke reden voor uitsluiting is zichtbaar in de brongegevens.
De overige kolommen zijn source_url, last_played en language_note. Bewaar de bronlink als die beschikbaar is, gebruik taalnotities voor jouw editie en laat in stap 5 een formule last_played invullen. Bezit garandeert niet dat een doos fysiek thuis is: vertel de assistent welke uitgeleende spellen hij moet uitsluiten.
Kun je beginnen met een collectie-export van BoardGameGeek?
Ja. Log in op je eigen BGG-account, open je collectie en download via de collectiefunctie de spellen die je bezit. Bewaar het oorspronkelijke CSV-bestand apart, bekijk de daadwerkelijke kolomnamen en zet de relevante waarden over naar dit sjabloon. Vul ontbrekende spelersaantallen of tijdsinschattingen aan op basis van je eigen editie in plaats van het model te laten gokken.
De officiële toegangsvoorwaarden van BGG maken onderscheid tussen het downloaden van je eigen collectie terwijl je bent ingelogd en geregistreerde geautomatiseerde API-toegang. Dit recept gebruikt een handmatige export of handmatige invoer. Het vereist geen BGG-API-koppeling en synchroniseert wijzigingen in BGG niet.
Stap 2: Hoe koppel je Google Sheets aan de assistent?
Gebruik de spreadsheet die door de Google Sheets-koppeling van Quickchat AI is aangemaakt. De bestandsmachtiging geldt niet automatisch voor een willekeurige spreadsheet die al in je Drive staat.
- Maak een Quickchat AI-account aan. Gebruik de eerste Agent of kies Add new AI Agent → Set up manually. Geef hem de naam Shelf Night.
- Open Your Website → Install → Availability and access. Schakel Widget & Embed access uit en stel Chat Page Access → Nobody in. Houd deze eerste versie binnen je afgeschermde AI Preview, waarvoor je moet zijn ingelogd.
- Open Actions & MCPs → Add Action → Google Sheets en rond de Google-autorisatie af. De integratie vraagt de beperkte scope
drive.fileaan en maakt een spreadsheet met een tabblad Leads. - Schakel de gegenereerde Action
log_lead_to_google_sheetuit terwijl je hem aanpast. Behoud de naam zodat de koppeling hem nog kan herkennen. Kies Open sheet en hernoem het bestand naar Shelf Night. - Hernoem Leads naar Plays, vervang de oude kolomkoppen door
Plays.tsvin A1 te plakken en voeg een tabblad Collection toe. Zorg voor minstens 501 rijen in Plays en 101 in Collection. - Kies onder File → Settings de landinstelling United States voor de kommagescheiden formules uit het pakket. Stel kolom A van Plays in op Plain text voordat je datums invoert. Plak
Collection.tsvin Collection!A1, zodat de formules in kolom I kunnen rekenen. Zet elke koprij vast en maak die vet; verbreed kolommen of laat tekst teruglopen om waarden leesbaar te maken.
In de compacte weergaven in dit artikel zijn de kolommen C:F, H en J tijdelijk verborgen, zodat het spel, bezit en de laatste speeldatum leesbaar blijven. Het onderliggende tabblad Collection met tien kolommen en het A:J-bereik van de Action blijven ongewijzigd.
Stel beide toegangsopties in voordat je je collectie koppelt. Deze handleiding gebruikt AI Preview in het dashboard.
De handleiding voor de Google Sheets-koppeling behandelt de autorisatieschermen. Laat persoonlijke BGG-opmerkingen en niet-relevante collectiegegevens buiten dit kleine demobestand.
Stap 3: Hoe krijg je een aanbeveling uit je eigen spellenkast?
Voeg één alleen-lezen-Action toe en geef de Agent regels voor het gebruik van het antwoord. Dat is genoeg voor je eerste bruikbare shortlist; de Action voor het vastleggen kan uit blijven.
Lees de collectie
Open Actions & MCPs → Add Action → API Action → Create manually. Noem de Action Read Shelf Night collection, stel When to run → AI decides in en voer het volgende in:
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101
Headers
Authorization: Bearer {{google_sheets_access_token}}
Vervang YOUR_CREATED_SHEET_ID door de ID die al in de URL van de uitgeschakelde start-Action staat. Gebruik het ingebouwde Google Sheets-token uit Add AI Data → System Tokens; laat het als variabele staan en plak geen toegangstoken. Houd de bestands-ID en het bereik vast, met geen invoerparameters, geen body en geen queryparameters. Laat Response filter leeg.
Gebruik deze 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.
Lees de koprij en collectierijen samen. Laat de spreadsheet en het bereik niet door het gesprek bepalen.
Sla de Action op en schakel hem in. Voer Test Response uit en vergelijk values met de spreadsheet. Googles values.get-endpoint geeft standaard opgemaakte celwaarden terug; getallen en booleans kunnen als tekenreeksen binnenkomen en lege cellen aan het eind kunnen ontbreken. Een korte rij is geen toestemming om ontbrekende waarden te verzinnen.
Geef Shelf Night zijn regels
Open Identity → Main Prompt, plak main-prompt.txt uit het pakket en sla op. De selectieregel is concreet: lees de collectie opnieuw, vereis bezit en volledige randvoorwaarden, geef maximaal drie passende keuzes en licht ontbrekende informatie toe.
De Main Prompt legt uit hoe de assistent moet kiezen. Deze twee uitsneden tonen de locatie en de eerste instructies; de Action levert de actuele collectie.
Vraag in AI Preview:
Four players, 60 minutes, something light. What do we own that fits?
Het eerste bruikbare antwoord: Azul en Cascadia voldoen aan de vastgelegde voorwaarden voor bezit, spelers en tijd.
Met de voorbeeldgegevens voldoen Azul en Cascadia. De verlanglijstrij valt af omdat je het spel niet bezit; over het reisspel is onvoldoende informatie beschikbaar. Open het opgeslagen gesprek in Inbox, klap de Action-aanroep open en bekijk de teruggegeven waarden. Gebruik View logs op de Action-kaart voor het volledige verzoeklogboek.
Vergelijk het antwoord met de achterliggende gegevens. Een Action-markering laat zien dat er een aanroep was; het resultaat laat zien wat de assistent werkelijk ontving.
Laat ChatGPT of Claude de instellingen voorbereiden
De accountbeheerkoppeling van Quickchat AI kan de Main Prompt en HTTP-Actions voorbereiden. Maak verbinding via de officiële ChatGPT-vermelding of Claude-vermelding en volg de handleiding voor accountbeheer. Voeg het pakket toe en stuur:
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.
Je moet nog steeds Google autoriseren, de spreadsheet vullen en echte rijen controleren. Instellingen laten voorbereiden door een assistent voltooit die stappen niet.
Stap 4: Hoe leg je een afgerond potje vast?
Gebruik één rij per afgerond potje en vereis bevestiging voordat je die toevoegt. Cascadia voorstellen mag nooit tellen als Cascadia spelen.
De datum en spel-ID verbinden een afgeronde sessie met de volgende shortlist.
Voeg een lees-Action voor het speellogboek toe
Maak een tweede Action met de naam Read Shelf Night plays, met dezelfde GET-instellingen en tokenheader als de eerste, maar wijzig het bereik in:
https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501
Stel de beschrijving in op:
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.
Sla hem op en schakel hem in. Ook een leeg logboek hoort de koprij terug te geven: played_date, game_id, players, duration_minutes, note.
Pas de start-Action aan om een speelsessie toe te voegen
Bewerk de uitgeschakelde start-Action en behoud de naam log_lead_to_google_sheet. Vervang de oude leadparameters, verzoekbody, beschrijving en het denkbericht. De overgenomen naam is alleen een identificatie; deze Action legt voortaan spellen vast.
Voeg onder What to ask the user first het volgende toe:
Kopieer de parameters voor de gespeelde partij en het toevoegverzoek
| Parameternaam | Gegevenstype | Verplicht | Beschrijving |
|---|---|---|---|
played_date | Text | Ja | Exacte bevestigde datum in YYYY-MM-DD. Vraag ernaar in plaats van een relatieve datum te raden. |
game_id | Text | Ja | Exacte ID uit Collection, bevestigd door de gastheer of gastvrouw. |
players | Number | Ja | Bevestigd aantal mensen dat heeft meegespeeld. |
duration_minutes | Number | Ja | Bevestigde werkelijke duur, niet het tijdsbudget. |
note | Text | Nee | Optionele feitelijke notitie van de gastheer of gastvrouw. Leeg als die ontbreekt. |
Kies voor note Default value → Empty value. Gebruik AI decides en laat Response filter leeg. Stel het verzoek en Query Params als volgt in:
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
Laat bij Body de modus JSON ingeschakeld en vervang de oude aanvraaginhoud van de startactie door:
{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}
De volgorde van de waarden moet overeenkomen met de vijf kolommen. RAW slaat aangeleverde tekst letterlijk op, zodat een notitie die met = begint geen formule wordt. Het append-endpoint zoekt de volgende rij na de tabel; OVERWRITE vult die bestaande lege rij en behoudt de opmaak en het bereik van de formule voor de laatste speeldatum. Google’s append-documentatie legt de opties uit. Houd Plays als één aaneengesloten logboek zonder een andere tabel ernaast.
Kopieer de toevoegbeschrijving uit action-recipes.json. Die vereist een aparte bevestiging, een controle op duplicaten, één toevoeging en daarna een leesaanroep. Stel het denkbericht in op Recording the confirmed play..., sla op en schakel de Action in. Test Response uitvoeren op deze POST kan een echte rij toevoegen.
Spelen, melden, bevestigen
Stuur dit in AI Preview:
We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.
De assistent moet de voorgestelde velden tonen en wachten. Controleer of Plays ongewijzigd is voordat je bevestigt.
Shelf Night vraagt om bevestiging. Het echte tabblad Plays bevat nog steeds alleen de kopregel.
Antwoord met “Bevestigen.” Controleer het resultaat van het toevoegverzoek op updates.updatedRows: 1, de bijbehorende updatedRange en de daaropvolgende uitleesactie. Het daadwerkelijke werkblad moet 2026-11-08, SHELF-002, 4, 52 en een lege notitie bevatten.
De bevestigde sessie verschijnt één keer in Plays, onder dezelfde vijf kolomkoppen. De Agent las het logboek terug voordat hij succes meldde.
De append-aanroep gaf één bijgewerkte rij terug. Het geretourneerde bereik komt overeen met de ingevulde rij in Google Sheets.
Bevestiging en duplicaatcontroles zijn Agent-instructies, geen atomaire databasebeperking. Als een verzoek een time-out geeft, controleer dan het logboek voordat je opnieuw probeert. Twee gelijktijdige gesprekken kunnen nog steeds dezelfde melding toevoegen; dit kleine persoonlijke logboek heeft geen reserveringssysteem of transactievergrendeling.
Stap 5: Hoe vermijd je spellen die je onlangs hebt gespeeld?
Lees de speelgeschiedenis met een expliciete grensdatum. In het voorbeeld valt Cascadia af en blijft Azul over als je spellen uitsluit die op of na 2026-11-01 zijn gespeeld.
Het pakket voegt ook een formule voor de laatst gespeelde datum toe in Collection!I2 en trekt die door naar de voorbeeldrijen eronder:
=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")
De formule zoekt op de vaste spel-ID, sorteert ISO-datumteksten met vaste lengte van nieuw naar oud en geeft de laatste vastgelegde datum terug. Een late melding van een oudere sessie wordt daardoor niet de nieuwste speelsessie. Zonder bijpassende speelsessie blijft de cel leeg.
Controleer na de invoer van Cascadia dat Collection!I3 de waarde 2026-11-08 toont. Als de formule letterlijk wordt weergegeven, herstel dan de automatische opmaak voor die cel en voer haar opnieuw in. Houd datums in Plays als platte tekst en controleer bij een formulefout de landinstelling en exacte tabbladnamen. Google documenteert de FILTER-functie die de overeenkomende rijen selecteert.
Collection!I3 berekent de laatst vastgelegde speeldatum van Cascadia op basis van Plays. De geselecteerde cel toont zowel de formule als het resultaat, 2026-11-08.
Begin een nieuw gesprek en vraag:
Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.
De nieuwe vraag sluit de vastgelegde pot Cascadia uit en geeft Azul terug. Een lege last_played-cel betekent dat er geen speelsessie in dit logboek staat.
De oorspronkelijke leesbereiken omvatten 100 spellen en 500 speelsessies, zonder kopregels. Houd de lees-Actions en formulebereiken afgestemd op de werkelijke gegevens wanneer het bestand groeit. Laat de append-instelling op insertDataOption: OVERWRITE staan, zodat een nieuwe invoer de beginrij van de formule niet voorbij de zojuist vastgelegde sessie verschuift.
Stap 6: Hoe controleer je of de aanbevelingen op gegevens berusten?
Test situaties waarin je collectie geen antwoord kan bieden. Een bruikbare keuzehulp legt de beperking uit en laat jou bepalen wat je wilt aanpassen.
Vraag om zes spelers, 60 minuten, licht. Geen van beide volledige rijen met spellen in bezit is geschikt voor zes en het maximum van het reisspel is onbekend. De assistent mag niet het spelersaantal van een uitbreiding van Cascadia gebruiken of iets van de verlanglijst aanbevelen.
Een antwoord zonder passende keuze houdt de oorspronkelijke voorwaarden zichtbaar. Voeg een geverifieerd spel voor zes spelers toe of pas het plan voor de avond aan.
Gebruik Testing → Simulation Testing voor herhaalbare controles en bekijk de Action-resultaten naast de antwoorden. Houd de bevestiging binnen één gesprek, zodat “Bevestigen” naar een concreet voorstel verwijst.
De opgeslagen collectietests omvatten een gewone aanbeveling, zes spelers, een spel dat je niet bezit en ontbrekende informatie. Bekijk naast de scores ook de bijbehorende Action-resultaten.
| Probeer dit | Controleer dit |
|---|---|
| Vier spelers, 60 minuten, licht | Alleen Azul en Cascadia, met redenen op basis van vastgelegde gegevens |
| Zes spelers | Geen geverifieerde passende keuze; geen verzonnen capaciteit |
| Beveel het verlanglijstvoorbeeld aan | Uitsluiting wegens bezit blijft gelden |
| Hoelang duurt het reisspel? | Ontbrekende tijd blijft onbekend |
| Meld een speelsessie, vóór bevestiging | Geen nieuwe rij in Plays |
| Bevestig en bevestig daarna nogmaals | Eén rij in deze test, zonder tweede toevoeging |
| Sluit speelsessies op of na 2026-11-01 uit | Cascadia uitgesloten na de vastgelegde speelsessie |
De vier collectietests zijn geslaagd in Simulation Testing. We controleerden ook de afzonderlijke bevestiging, één toegevoegde rij, het formuleresultaat, een herhaalde bevestiging zonder extra append en een nieuwe aanbeveling die Cascadia uitsloot. Doorloop de checklist uit het pakket met je eigen bestand voordat je de voorbeeldrijen vervangt.
Vervang na geslaagde controles de voorbeeldrijen door je eigen collectie. Geef Shelf Night de volgende keer dat jullie gaan spelen het spelersaantal, de tijd en de gewenste sfeer, kies uit de voorgestelde opties en leg het spel na afloop vast. Elke vastgelegde spelavond geeft de volgende keuze wat meer context.
Voor een ander collectieproject gebruikt de Steam-backlogkeuzehulp hetzelfde idee, met vastgelegde speeltijd en persoonlijke notities. De handleiding voor de API Action-bouwer legt uit hoe je dit patroon aanpast aan andere gegevensbronnen.
Veelgestelde vragen
Kan een bordspellenadviseur alleen spellen voorstellen die ik bezit?
Ja. Deze opzet leest vóór elke aanbeveling je tabblad Collection en vereist dat owned op TRUE staat. De assistent controleert de vastgelegde spelerslimieten en je tijdsbudget en licht elke passende keuze toe. Houd bezit en editiegegevens actueel.
Kan ik mijn BoardGameGeek-collectie zonder API-sleutel gebruiken?
Ja. Begin met een zelf handmatig gedownload CSV-bestand van je BGG-collectie of voer een kleine collectie in het sjabloon in. Controleer de exportkolommen en vul ontbrekende gegevens aan op basis van jouw editie. Deze werkwijze gebruikt de BGG-API niet en synchroniseert je collectie niet automatisch.
Is er een spreadsheetsjabloon voor een bordspellencollectie?
Het startpakket van Shelf Night bevat Collection.tsv, Plays.tsv, formules voor de laatst gespeelde datum, drie Action-recepten, een Main Prompt en een testchecklist. Plak de tabgescheiden bestanden in de spreadsheet die door de Google Sheets-koppeling van Quickchat AI is aangemaakt.
Omvat de tijdsinschatting ook uitleg en klaarzetten?
De kolom planning_minutes bevat het tijdsbudget van je huishouden, dus je kunt beide meenemen. In het voorbeeld krijgen Azul en Cascadia elk 60 minuten. De werkelijke duur komt na een sessie in het speellogboek en staat los van de planningsinschatting.
Kan de assistent bordspellen vermijden die we onlangs hebben gespeeld?
Ja, met vastgelegde speelsessies en een exacte grensdatum. In het geteste voorbeeld verdwijnt Cascadia uit de volgende shortlist nadat een sessie op 2026-11-08 is vastgelegd en spellen gespeeld op of na 2026-11-01 worden uitgesloten. Niet-vastgelegde sessies blijven onbekend en je leesbereiken moeten de relevante geschiedenis omvatten.
Wat gebeurt er als geen enkel spel in bezit bij de groep past?
De assistent hoort uit te leggen welke vastgelegde limieten de kandidaten uitsluiten en te vragen wat je wilt aanpassen. Hij mag geen spelersaantal verzinnen, het tijdsbudget stilzwijgend verruimen of een spel voorstellen dat je niet bezit.
Kunnen ChatGPT of Claude helpen bij het instellen?
De accountbeheerkoppeling van Quickchat AI kan de Agent-prompt en HTTP-Actions uit het pakket voorbereiden. Je moet nog steeds Google autoriseren, je collectie invoeren en de echte spreadsheet controleren. Het voorbereiden van de configuratie voert geen tests uit en publiceert de Agent niet.