En brettspillanbefaler for din egen samling vurderer spillene du eier, opp mot kveldens antall spillere, tilgjengelig tid og preferanser. Shelf Night leser samlingen fra Google Sheets, registrerer et fullført parti etter bekreftelse og bruker loggen til å unngå nylige gjentakelser.
Dere er fire rundt bordet, har en time til å spille og har Azul og Cascadia i hyllen. Den første kortlisten inneholder begge. Etter at et parti Cascadia er registrert, utelater neste forespørsel det spillet, og Azul står igjen.
Målet: Cascadia er registrert i spilloggen, og Shelf Night anbefaler Azul når du ber om å unngå nylige gjentakelser.
Skjermbildene fra Google Sheets viser den tilkoblede testfilen vår. Skjermbildene fra Quickchat AI bruker den lokale appen til å vise svarene og Action-resultatene som den aktive testagenten vår registrerte.
Du bygger først lesingen av samlingen, og legger deretter til bekreftet spillregistrering og kontroll av nylige partier. Du kontrollerer både den lagrede raden og svaret.
Last ned startpakken for Shelf Night. Den inneholder to tabulatordelte regnearkfiler, hele instruksen, tre handlingsoppskrifter og en testsjekkliste. Dette er redigerbare referansefiler, ikke en automatisk agentimport. Skjermbilder og innstillinger som kan kopieres, bruker engelske grensesnittnavn.
Følg trinnene for å klargjøre spillhyllen, koble til regnearket, få en anbefaling, loggføre et parti og unngå gjentakelser.
Hva skal spillvelgeren vite?
Shelf Night kombinerer registrerte spillfakta med husstandens preferanser. Regnearket inneholder begge deler i separate kolonner, slik at assistenten kan forklare grunnlaget for en anbefaling.
Eierskap, spillerantall og tidsramme luker hver for seg ut ulike typer uegnede forslag.
Eksempelet bruker to ekte grunnspill og to bevisste grensetilfeller. Utgiverne oppgir Azul for 2–4 spillere og Cascadia for 1–4 spillere. Den fiktive husstanden vår setter av 60 minutter til hvert av dem, inkludert oppsett og regelforklaring. Denne tidsrammen er vår egen, ikke en garanti for varigheten fra utgiveren.
Sjekk utgaven i din egen hylle. Produktbilder: Next Move Games / Asmodee og Alderac Entertainment Group / Flatout Games. Utgivernes spilletider og gruppens tidsramme er separate verdier.
Du trenger en konto hos Quickchat AI, en Google-konto som kan autorisere Sheets-tilkoblingen, og noen spill å registrere. En konto hos BoardGameGeek er valgfri. Sjekk gjeldende kvoter for AI-kreditter og handlinger for kontoen din; samtaler og Simulation Testing bruker kreditter.
Trinn 1: Hvordan klargjør du brettspillsamlingen?
Start med noen få spill du enkelt kan kontrollere selv. Registrer en fast ID, eierskap, spillerintervall og en tidsramme for hvert spill før du ber assistenten velge.
- Åpne
Collection.tsvfra pakken. Behold kolonnenavnene og rekkefølgen. Bytt ut eksempelradene med dine egne senere, etter at den første testen fungerer. - Gi hver eske en fast
game_id, for eksempelSHELF-001. Ta med utgave eller utvidelse i tittelen når det påvirker reglene. Ikke behandle en utvidelse som et selvstendig spill. - Kopier spillerantall fra esken, regelheftet eller utgiveren. Sett
planning_minutestil tiden din gruppe trenger, inkludert regelforklaring. La verdier du ikke har kontrollert, stå tomme. - Velg egne etiketter for
complexity, somlightellermedium. Registrer eierskap uttrykkelig. En oppføring fra ønskelisten skal haownedsatt tilFALSE.
| Eksempelspill | Spillere | Tidsramme | Eies | Hva det viser |
|---|---|---|---|---|
Azul, SHELF-001 | 2–4 | 60 minutter | TRUE | En kandidat med fullstendige opplysninger |
Cascadia (grunnspill), SHELF-002 | 1–4 | 60 minutter | TRUE | En kandidat vi skal loggføre og utelukke senere |
Eksempel fra ønskelisten, SHELF-003 | 2–4 | 45 minutter | FALSE | Et spill som passer godt, kan likevel være et dere ikke eier |
Uregistrert reisespill, SHELF-004 | Minst 2; maksimum ukjent | Ukjent | TRUE | Manglende opplysninger må forbli ukjente |
Startsamlingen har to kandidater med fullstendige data, ett spill som ikke eies, og én ufullstendig oppføring. Hver utelatelse kan forklares med kildedataene.
De øvrige kolonnene er source_url, last_played og language_note. Behold kildelenken når den er tilgjengelig, bruk språkmerknader for din utgave, og la en formel fylle ut last_played i trinn 5. At dere eier en eske, betyr ikke at den fysisk er hjemme: be assistenten utelukke alt dere har lånt bort.
Kan du starte med en eksport av samlingen fra BoardGameGeek?
Ja. Logg inn på din egen BGG-konto, åpne samlingen, og bruk nedlastingsfunksjonen for spill du eier. Oppbevar den opprinnelige CSV-filen separat, se over de faktiske kolonnenavnene, og overfør så de relevante verdiene til denne malen. Fyll inn manglende spillerantall eller tidsanslag fra din egen utgave i stedet for å be modellen gjette.
BGGs offisielle tilgangsvilkår skiller mellom å laste ned din egen samling mens du er innlogget, og registrert, automatisert API-tilgang. Denne oppskriften bruker manuell eksport eller inntasting. Den krever ingen BGG-API-tilkobling og holder ikke endringer i BGG synkronisert.
Trinn 2: Hvordan kobler du Google Sheets til assistenten?
Bruk regnearket som opprettes av Google Sheets-tilkoblingen i Quickchat AI. Filtilgangen omfatter ikke automatisk et hvilket som helst regneark som allerede ligger i Drive.
- Opprett en konto hos Quickchat AI. Bruk den første agenten, eller velg Add new AI Agent → Set up manually. Gi den navnet Shelf Night.
- Åpne Your Website → Install → Availability and access. Slå av Widget & Embed access, og sett Chat Page Access → Nobody. Hold denne første versjonen inne i din innloggede AI Preview.
- Åpne Actions & MCPs → Add Action → Google Sheets, og fullfør Googles autorisering. Integrasjonen ber om det begrensede tilgangsomfanget
drive.fileog oppretter et regneark med fanen Leads. - Slå av den genererte handlingen
log_lead_to_google_sheetmens du tilpasser den. Behold navnet, slik at tilkoblingen fortsatt kan gjenkjenne den. Velg Open sheet, og gi filen navnet Shelf Night. - Endre navnet på Leads til Plays, erstatt de gamle kolonneoverskriftene ved å lime inn
Plays.tsvi A1, og legg så til fanen Collection. Behold minst 501 rader i Plays og 101 i Collection. - Under File → Settings velger du lokaliteten United States for de kommaseparerte formlene i pakken. Formater kolonne A i Plays som Plain text før du legger inn datoer. Lim inn
Collection.tsvi Collection!A1, og la formlene i kolonne I beregnes. Frys hver overskriftsrad og bruk fet skrift; utvid kolonnene eller bruk tekstbryting så verdiene blir leselige.
I de kompakte visningene i denne artikkelen er kolonnene C:F, H og J midlertidig skjult, slik at spill, eierskap og siste spilledato er leselige. Den underliggende Collection-fanen med ti kolonner og Actionens A:J-område er uendret.
Still inn begge tilgangskontrollene før du kobler til samlingen. Veiledningen bruker AI Preview i kontrollpanelet.
Veiledningen for tilkobling til Google Sheets dekker autoriseringsskjermene. Hold personlige BGG-kommentarer og uvedkommende samlingsdata utenfor denne lille demofilen.
Trinn 3: Hvordan får du en anbefaling fra din egen hylle?
Legg til én skrivebeskyttet handling, og gi agenten regler for hvordan svaret skal brukes. Dette er nok til å få den første nyttige kortlisten; loggføringshandlingen kan fortsatt være avslått.
Les samlingen
Åpne Actions & MCPs → Add Action → API Action → Create manually. Gi handlingen navnet Read Shelf Night collection, sett When to run → AI decides, og legg inn:
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101
Headers
Authorization: Bearer {{google_sheets_access_token}}
Erstatt YOUR_CREATED_SHEET_ID med ID-en som allerede finnes i nettadressen til den deaktiverte starthandlingen. Bruk det innebygde tokenet for Google Sheets fra Add AI Data → System Tokens; behold det som en variabel, ikke som et innlimt tilgangstoken. Hold fil-ID og område faste, med ingen inndataparametere, ingen forespørselskropp og ingen spørringsparametere. La Response filter stå tomt.
Bruk denne teksten i 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.
Les overskriftsraden og samlingsradene sammen. Hold regnearket og området utenfor samtalens kontroll.
Lagre og aktiver handlingen. Kjør Test Response, og sammenlign values med regnearket. Googles values.get-endepunkt returnerer formaterte celleverdier som standard; tall og boolske verdier kan komme som tekststrenger, og tomme celler på slutten kan være utelatt. En kort rad gir ikke lov til å finne på verdiene som mangler.
Gi Shelf Night reglene
Åpne Identity → Main Prompt, lim inn main-prompt.txt fra pakken, og lagre. Utvalgsregelen er konkret: les hyllen på nytt, krev eierskap og fullstendige begrensninger, returner høyst tre treff, og forklar eventuelle manglende opplysninger.
Main Prompt forklarer hvordan valget skal tas. Disse to utsnittene viser plasseringen og de innledende instruksjonene; handlingen leverer den gjeldende samlingen.
Spør i AI Preview:
Four players, 60 minutes, something light. What do we own that fits?
Det første nyttige svaret: Azul og Cascadia oppfyller de registrerte kravene til eierskap, antall spillere og tid.
Med eksempeldataene kvalifiserer Azul og Cascadia. Ønskelisteraden faller bort på eierskap; det finnes ikke nok opplysninger om reisespillet. Åpne den lagrede samtalen i Inbox, utvid handlingskallet, og se over de returnerte verdiene. Bruk View logs på handlingskortet for hele forespørselsloggen.
Sammenlign svaret med dataene bak det. En handlingsmarkør forteller at et kall fant sted; resultatet forteller hva assistenten faktisk mottok.
La ChatGPT eller Claude klargjøre innstillingene
Tilkoblingen for kontoadministrasjon i Quickchat AI kan klargjøre Main Prompt og HTTP-handlingene. Koble til via den offisielle ChatGPT-oppføringen eller Claude-oppføringen, og følg veiledningen for kontoadministrasjon. Legg ved pakken og send:
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.
Du må fortsatt autorisere Google, fylle ut regnearket og kontrollere faktiske rader. Å klargjøre innstillinger gjennom en assistent fullfører ikke disse trinnene.
Trinn 4: Hvordan loggfører du et ferdigspilt parti?
Bruk én rad per ferdigspilt parti, og krev bekreftelse før raden legges til. Å foreslå Cascadia skal aldri telle som å ha spilt Cascadia.
Datoen og spill-ID-en knytter et ferdigspilt parti til neste kortliste.
Legg til en lesehandling for spilloggen
Opprett en ny handling med navnet Read Shelf Night plays, med samme GET-innstillinger og token-header som den første, men endre området til:
https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501
Sett beskrivelsen til:
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.
Lagre og aktiver den. En tom logg skal fortsatt returnere overskriftsraden: played_date, game_id, players, duration_minutes, note.
Tilpass starthandlingen til å legge til et parti
Rediger den deaktiverte starthandlingen, og behold navnet log_lead_to_google_sheet. Erstatt de gamle kundeemneparameterne, forespørselskroppen, beskrivelsen og tenkemeldingen. Det arvede navnet er bare en identifikator; denne handlingen skal nå loggføre spill.
Under What to ask the user first legger du til:
Kopier spilløktparametrene og forespørselen om å legge til en rad
| Parameternavn | Datatype | Obligatorisk | Beskrivelse |
|---|---|---|---|
played_date | Text | Ja | Nøyaktig bekreftet dato i formatet YYYY-MM-DD. Spør i stedet for å gjette hvilken dato en relativ datoangivelse viser til. |
game_id | Text | Ja | Nøyaktig ID returnert fra Collection og bekreftet av verten. |
players | Number | Ja | Bekreftet antall personer som spilte. |
duration_minutes | Number | Ja | Bekreftet faktisk varighet, ikke tidsrammen. |
note | Text | Nei | Valgfri faktabasert merknad fra verten. Tom når den utelates. |
For note velger du Default value → Empty value. Bruk AI decides, og la Response filter stå tomt. Sett forespørselen og Query Params til:
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
Under Body lar du JSON-modus være aktivert og erstatter det gamle forespørselsinnholdet i starthandlingen med:
{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}
Verdiene må ha samme rekkefølge som de fem kolonnene. RAW lagrer teksten bokstavelig, slik at en merknad som begynner med = ikke blir en formel. Append-endepunktet finner neste rad etter tabellen; OVERWRITE fyller den eksisterende tomme raden og bevarer formateringen og området til formelen for siste parti. Googles append-dokumentasjon forklarer alternativene. Hold Plays som én sammenhengende logg uten en annen tabell ved siden av.
Kopier beskrivelsen for tilføying fra action-recipes.json. Den krever en egen bekreftelse, en duplikatsjekk, én tilføying og en lesing etterpå. Sett tenkemeldingen til Recording the confirmed play..., lagre og aktiver handlingen. Test Response på denne POST-forespørselen kan legge til en faktisk rad.
Spill, rapporter, bekreft
Send dette i AI Preview:
We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.
Assistenten skal vise de foreslåtte feltene og vente. Kontroller at Plays er uendret før du bekrefter.
Shelf Night ber om bekreftelse. Den faktiske Plays-fanen inneholder fortsatt bare overskriftsraden.
Svar «Bekreft.» Kontroller at resultatet av radtilleggingen inneholder updates.updatedRows: 1 og tilhørende updatedRange, og se gjennom den påfølgende lesingen. Selve regnearket skal inneholde 2026-11-08, SHELF-002, 4, 52 og et tomt notatfelt.
Det bekreftede partiet vises én gang i Plays, under de samme fem overskriftene. Agenten leste loggen tilbake før den rapporterte at lagringen var fullført.
Append-kallet returnerte én oppdatert rad. Det returnerte området samsvarer med den utfylte raden som vises i Google Sheets.
Bekreftelse og duplikatsjekker er instruksjoner til agenten, ikke en atomisk databasebegrensning. Hvis en forespørsel får tidsavbrudd, må du kontrollere loggen før du prøver igjen. To samtidige samtaler kan fortsatt legge til samme rapport; denne lille personlige loggen har ikke noe reservasjonssystem eller noen transaksjonslås.
Trinn 5: Hvordan unngår du spill dere har spilt nylig?
Les spillhistorikken med en uttrykkelig grensedato. I eksempelet vil det å utelukke spill som er spilt på eller etter 2026-11-01, fjerne Cascadia og la Azul bli igjen.
Pakken legger også til en formel for sist spilte parti i Collection!I2 og fyller den nedover i eksempelradene:
=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")
Den finner treff på den faste spill-ID-en, sorterer ISO-datostrenger med fast lengde med nyeste først, og returnerer siste loggførte dato. En sen rapport om et eldre parti blir derfor ikke det nyeste partiet. Uten et tilsvarende parti forblir cellen tom.
Etter oppføringen for Cascadia kontrollerer du at Collection!I3 viser 2026-11-08. Hvis formelen vises som tekst, gjenoppretter du automatisk formatering for cellen og legger den inn på nytt. Behold datoene i Plays som ren tekst, og sjekk lokaliteten og de nøyaktige fanenavnene hvis formelen gir feil. Google dokumenterer FILTER-funksjonen som brukes til å velge tilsvarende rader.
Collection!I3 beregner Cascadias sist registrerte parti fra Plays. Den valgte cellen viser både formelen og resultatet, 2026-11-08.
Start en ny samtale og spør:
Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.
Den nye forespørselen utelater det registrerte Cascadia-partiet og returnerer Azul. En tom last_played-celle betyr at det ikke finnes noe registrert parti i denne loggen.
De opprinnelige leseområdene dekker 100 spill og 500 partier, uten overskrifter. Etter hvert som filen vokser, må lese-Actions og formelområder følge de faktiske oppføringene. Behold append-innstillingen insertDataOption: OVERWRITE, slik at en ny oppføring ikke flytter formelens startrad forbi partiet du nettopp registrerte.
Trinn 6: Hvordan kontrollerer du at anbefalingene har grunnlag i dataene?
Test tilfellene der hyllen ikke kan gi et svar. En nyttig spillvelger skal forklare begrensningen og la deg avgjøre hva som skal endres.
Be om seks spillere, 60 minutter, lett. Ingen av de to fullstendige radene med spill dere eier, passer for seks, og reisespillets maksimum er ukjent. Assistenten skal ikke bruke spillerantallet fra utvidelsen til Cascadia eller anbefale noe fra ønskelisten.
Et svar uten treff holder de opprinnelige kravene synlige. Legg til et verifisert spill for seks spillere, eller endre kveldens plan.
Bruk Testing → Simulation Testing for gjentakbare kontroller, og se over handlingsresultatene sammen med svarene. Hold bekreftelsesutvekslingen i én samtale, slik at «Bekreft» viser til et konkret forslag som skal godkjennes.
De lagrede samlingstestene dekker en vanlig anbefaling, seks spillere, et spill som ikke eies, og manglende informasjon. Se på de tilhørende Action-resultatene i tillegg til poengsummene.
| Prøv dette | Kontroller dette |
|---|---|
| Fire spillere, 60 minutter, lett | Bare Azul og Cascadia, med begrunnelser fra registrerte opplysninger |
| Seks spillere | Ingen verifiserte treff; ingen oppdiktet kapasitet |
| Anbefal eksempelet fra ønskelisten | Utelukkelse på grunn av eierskap gjelder fortsatt |
| Hvor lang tid tar reisespillet? | Manglende tidsangivelse forblir ukjent |
| Rapporter et parti, før bekreftelse | Ingen ny rad i Plays |
| Bekreft, og bekreft så på nytt | Én rad i denne testen, uten en ny tilføying |
| Utelukk partier på eller etter 2026-11-01 | Cascadia utelukkes etter det loggførte partiet |
De fire samlingstestene besto i Simulation Testing. Vi kontrollerte også den separate bekreftelsen, én tilføyd rad, formelresultatet, en gjentatt bekreftelse uten en ny tilføying og en ny anbefaling som utelot Cascadia. Gå gjennom sjekklisten i pakken med din egen fil før du erstatter eksempelradene.
Når kontrollene er bestått, erstatter du eksempelradene med din egen samling. Neste gang gruppen setter seg ned, gir du Shelf Night antall spillere, tid og ønsket stemning, velger blant alternativene som returneres, og loggfører spillet når dere er ferdige. Hver loggførte kveld gir neste valg litt mer kontekst.
Vil du prøve et annet samlingsbasert prosjekt, bruker spillvelgeren for Steam-biblioteket samme idé med registrert spilletid og personlige merknader. Veiledningen for API-handlinger forklarer hvordan du tilpasser dette mønsteret til andre datakilder.
Ofte stilte spørsmål
Kan en brettspillanbefaler foreslå bare spill jeg eier?
Ja. Dette oppsettet leser fanen Collection før det anbefaler noe, og krever at owned er TRUE. Det sjekker registrerte spillergrenser og tidsrammen din, og forklarer så hvert treff. Hold opplysninger om eierskap og utgave oppdatert.
Kan jeg bruke samlingen min fra BoardGameGeek uten en API-nøkkel?
Ja. Start med en CSV-fil med din egen BGG-samling som du har lastet ned manuelt, eller skriv inn noen spill i malen. Se over kolonnene i eksporten, og fyll inn manglende fakta fra din utgave. Denne arbeidsflyten kaller ikke BGG-API-et og synkroniserer ikke samlingen automatisk.
Finnes det en regnearkmal for brettspillsamlingen?
Startpakken for Shelf Night inneholder Collection.tsv, Plays.tsv, formler for sist spilte parti, tre handlingsoppskrifter, en Main Prompt og en testsjekkliste. Lim inn de tabulatordelte filene i regnearket som opprettes av Google Sheets-tilkoblingen i Quickchat AI.
Inkluderer tidsanslaget regelforklaring og oppsett?
Kolonnen planning_minutes er husstandens eget tidsanslag, så du kan ta med begge deler. I eksempelet settes det av 60 minutter til Azul og Cascadia. Faktisk varighet føres i spilloggen etter et parti og holdes adskilt fra planleggingsanslaget.
Kan den unngå brettspill vi har spilt nylig?
Ja, ved hjelp av registrerte partier og en nøyaktig grensedato. I det testede eksempelet fjernes Cascadia fra neste kortliste når et parti registreres på 2026-11-08 og spill spilt på eller etter 2026-11-01 utelates. Uregistrerte partier forblir ukjente, og leseområdene må dekke den relevante historikken.
Hva skjer når ingen brettspill vi eier, passer gruppen?
Assistenten skal forklare hvilke registrerte begrensninger som utelukker kandidatene, og spørre hva du vil endre. Den skal ikke finne på et spillerantall, utvide tidsrammen uten å si fra eller bytte til et spill dere ikke eier.
Kan ChatGPT eller Claude hjelpe med oppsettet?
Tilkoblingen for kontoadministrasjon i Quickchat AI kan klargjøre agentinstruksen og HTTP-handlingene fra pakken. Du må fortsatt autorisere Google, legge inn samlingen og kontrollere det faktiske regnearket. Klargjøring av konfigurasjonen kjører ingen tester og publiserer ikke agenten.