En brädspelsväljare för din egen samling jämför spelen du äger med kvällens spelarantal, tillgängliga tid och önskemål. Shelf Night läser samlingen från Google Sheets, registrerar ett avslutat parti efter bekräftelse och använder loggen för att undvika nyligen spelade spel.
Ni är fyra runt bordet, har en timme att spela och har Azul och Cascadia i hyllan. Den första förslagslistan innehåller båda. När ett Cascadia-parti har registrerats utesluter nästa fråga det spelet, och Azul blir kvar.
Målet: Cascadia finns i spelloggen och Shelf Night rekommenderar Azul när du ber att undvika nyligen spelade spel.
Skärmbilderna från Google Sheets visar vår anslutna testfil. Skärmbilderna från Quickchat AI använder den lokala appen för att visa svaren och Action-resultaten som vår aktiva testagent registrerade.
Du bygger först läsningen av samlingen, lägger sedan till bekräftad loggning av partier och kontrollerar nyligen spelade spel. Du verifierar både den sparade raden och svaret.
Ladda ned startpaketet för Shelf Night. Det innehåller två tabbseparerade kalkylbladsfiler, den fullständiga prompten, tre konfigurationsrecept för åtgärder och en testchecklista. Det här är redigerbara referensfiler, inte en automatisk agentimport. Skärmbilder och inställningar som kan kopieras använder engelska gränssnittsetiketter.
Följ stegen för att förbereda hyllan, ansluta kalkylarket, få en rekommendation, logga ett parti och undvika upprepningar.
Vad kommer din spelväljare att veta?
Shelf Night kombinerar registrerade spelfakta med ditt hushålls önskemål. Kalkylarket innehåller båda i separata kolumner så att assistenten kan förklara vad en rekommendation bygger på.
Ägande, spelarantal och planerad tid utesluter var sin typ av olämpliga förslag.
Exemplet använder två riktiga grundspel och två avsiktliga gränsfall. Utgivarna anger Azul för 2–4 spelare och Cascadia för 1–4 spelare. Vårt fiktiva hushåll avsätter 60 minuter för vart och ett, inklusive uppställning och regelgenomgång. Den tidsbudgeten är vår egen, inte en garanti från utgivaren.
Kontrollera utgåvan i din hylla. Produktbilder: Next Move Games / Asmodee och Alderac Entertainment Group / Flatout Games. Utgivarnas speltider och gruppens planerade tidsbudget är separata värden.
Du behöver ett konto hos Quickchat AI, ett Google-konto som kan godkänna Sheets-kopplingen och några spel att katalogisera. Ett konto hos BoardGameGeek är valfritt. Kontrollera aktuella gränser för AI-krediter och åtgärder för ditt konto; samtal och Simulation Testing förbrukar krediter.
Steg 1: Hur förbereder du din brädspelssamling?
Börja med en liten samling som du enkelt kan kontrollera själv. Registrera ett stabilt ID, ägande, spelarintervall och en tidsbudget för varje spel innan du ber assistenten välja.
- Öppna paketets
Collection.tsv. Behåll rubrikernas namn och ordning. Ersätt exempelraderna med dina egna senare, när det första testet fungerar. - Ge varje låda ett stabilt
game_id, till exempelSHELF-001. Ta med utgåvan eller expansionen i titeln när den påverkar reglerna. Behandla inte en expansion som ett fristående spel. - Kopiera spelarantal från lådan, regelboken eller utgivaren. Sätt
planning_minutestill den tid din grupp behöver, inklusive regelgenomgång. Lämna obekräftade värden tomma. - Välj egna etiketter för
complexity, till exempellightellermedium. Ange ägande uttryckligen. En post från önskelistan ska haownedsatt tillFALSE.
| Exempelspel | Spelare | Planerad tidsbudget | Ägs | Vad exemplet visar |
|---|---|---|---|---|
Azul, SHELF-001 | 2–4 | 60 minuter | TRUE | En kandidat med fullständiga uppgifter |
Cascadia (grundspel), SHELF-002 | 1–4 | 60 minuter | TRUE | En kandidat som vi senare loggar och utesluter |
Önskelisteexempel, SHELF-003 | 2–4 | 45 minuter | FALSE | Ett spel kan passa bra utan att vara ägt |
Okatalogiserat resespel, SHELF-004 | Minst 2; högsta antal okänt | Okänd | TRUE | Saknade uppgifter måste förbli okända |
Startsamlingen har två kandidater med kompletta uppgifter, ett spel som inte ägs och en ofullständig post. Varje uteslutning går att se i källdata.
De återstående kolumnerna är source_url, last_played och language_note. Behåll källänken när den finns, använd språknoteringar för din utgåva och låt en formel fylla i last_played i steg 5. Ägande garanterar inte att lådan finns hemma: be assistenten utesluta sådant du har lånat ut.
Kan du börja med en samlingsexport från BoardGameGeek?
Ja. Logga in på ditt eget BGG-konto, öppna din samling och använd samlingsnedladdningen för ägda spel. Spara den ursprungliga CSV-filen separat, granska dess faktiska rubriker och för sedan över relevanta värden till den här mallen. Komplettera saknade spelarantal eller tidsuppskattningar utifrån din egen utgåva i stället för att be modellen gissa.
BGG:s officiella åtkomstvillkor skiljer mellan att ladda ned sin egen samling som inloggad och registrerad automatisk API-åtkomst. Den här lösningen använder manuell export eller inmatning. Den kräver ingen BGG-API-koppling och synkroniserar inte ändringar från BGG.
Steg 2: Hur ansluter du Google Sheets till assistenten?
Använd kalkylarket som skapas av kopplingen till Google Sheets i Quickchat AI. Dess filbehörighet omfattar inte automatiskt ett godtyckligt kalkylark som redan finns i din Drive.
- Skapa ett konto hos Quickchat AI. Använd den första agenten eller välj Add new AI Agent → Set up manually. Ge den namnet Shelf Night.
- Öppna Your Website → Install → Availability and access. Stäng av Widget & Embed access och välj Chat Page Access → Nobody. Behåll den första versionen i din inloggade AI Preview.
- Öppna Actions & MCPs → Add Action → Google Sheets och slutför Googles behörighetsgodkännande. Integrationen begär det begränsade behörighetsomfånget
drive.fileoch skapar ett kalkylark med fliken Leads. - Stäng av den genererade åtgärden
log_lead_to_google_sheetmedan du anpassar den. Behåll namnet så att kopplingen fortfarande kan känna igen den. Välj Open sheet och byt namn på filen till Shelf Night. - Byt namn på Leads till Plays, ersätt de gamla rubrikerna genom att klistra in
Plays.tsvi A1 och lägg sedan till fliken Collection. Behåll minst 501 rader i Plays och 101 i samlingsfliken. - Under File → Settings väljer du språkregionen United States för paketets kommaseparerade formler. Formatera kolumn A i Plays som Plain text innan du skriver in datum. Klistra in
Collection.tsvi Collection!A1 och låt formlerna i kolumn I beräknas. Frys och fetmarkera varje rubrikrad; bredda kolumnerna eller radbryt texten så att värdena går att läsa.
I artikelns kompakta vyer är kolumnerna C:F, H och J tillfälligt dolda så att spel, ägande och senaste speldatum förblir läsbara. Den underliggande Collection-fliken med tio kolumner och Actionens A:J-intervall är oförändrade.
Ställ in båda åtkomstkontrollerna innan du ansluter samlingen. Handledningen använder kontrollpanelens AI Preview.
Guiden för kopplingen till Google Sheets går igenom behörighetsskärmarna. Ta inte med privata BGG-kommentarer eller ovidkommande samlingsdata i den här lilla demofilen.
Steg 3: Hur får du en rekommendation från din egen hylla?
Lägg till en skrivskyddad åtgärd och ge agenten regler för hur svaret ska användas. Det räcker för en första användbar förslagslista; loggningsåtgärden kan förbli avstängd.
Läs samlingen
Öppna Actions & MCPs → Add Action → API Action → Create manually. Ge åtgärden namnet Read Shelf Night collection, välj When to run → AI decides och ange:
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101
Headers
Authorization: Bearer {{google_sheets_access_token}}
Ersätt YOUR_CREATED_SHEET_ID med det ID som redan finns i URL:en för den avstängda startåtgärden. Använd den inbyggda token för Google Sheets från Add AI Data → System Tokens; behåll den som variabel, inte som en inklistrad åtkomsttoken. Håll fil-ID och intervall fasta, med inga indataparametrar, ingen begärandekropp och inga frågeparametrar. Lämna Response filter tomt.
Använd följande 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.
Läs rubriken och samlingsraderna tillsammans. Låt inte samtalet styra kalkylark eller intervall.
Spara och aktivera åtgärden. Kör Test Response och jämför values med kalkylarket. Googles values.get-slutpunkt returnerar formaterade cellvärden som standard; tal och booleska värden kan komma som strängar, och tomma celler i slutet kan utelämnas. En kort rad ger inte tillåtelse att hitta på saknade värden.
Ge Shelf Night dess regler
Öppna Identity → Main Prompt, klistra in main-prompt.txt från paketet och spara. Urvalsregeln är tydlig: läs hyllan på nytt, kräv ägande och fullständiga begränsningsuppgifter, returnera högst tre träffar och förklara vilka uppgifter som saknas.
Main Prompt förklarar hur valet ska göras. De två bildutsnitten visar var den finns och de inledande instruktionerna; åtgärden tillhandahåller den aktuella samlingen.
Fråga i AI Preview:
Four players, 60 minutes, something light. What do we own that fits?
Det första användbara svaret: Azul och Cascadia uppfyller de registrerade kraven på ägande, antal spelare och tid.
Med exempeldatan uppfyller Azul och Cascadia kraven. Önskelisteposten faller bort på ägandet; resespelet saknar tillräckliga uppgifter. Öppna det sparade samtalet i Inbox, fäll ut åtgärdsanropet och granska de returnerade värdena. Använd View logs på åtgärdskortet för den fullständiga begärandeloggen.
Jämför svaret med datan bakom det. En åtgärdsmarkör visar att ett anrop gjordes; resultatet visar vad assistenten faktiskt tog emot.
Låt ChatGPT eller Claude förbereda inställningarna
Kontohanteringskopplingen i Quickchat AI kan förbereda Main Prompt och HTTP-åtgärderna. Anslut via den officiella ChatGPT-listningen eller Claude-listningen och följ kontohanteringsguiden. Bifoga paketet och skicka:
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 behöver fortfarande godkänna åtkomsten hos Google, fylla i kalkylarket och kontrollera verkliga rader. Att förbereda inställningarna via en assistent slutför inte de stegen.
Steg 4: Hur loggar du ett färdigspelat parti?
Använd en rad per färdigspelat parti och kräv bekräftelse innan den läggs till. Att föreslå Cascadia ska aldrig räknas som att ha spelat Cascadia.
Datumet och spelets ID kopplar ett avslutat parti till nästa förslagslista.
Lägg till en läsåtgärd för spelloggen
Skapa en andra åtgärd med namnet Read Shelf Night plays med samma GET-inställningar och token-header som den första, men ändra intervallet till:
https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501
Ange följande beskrivning:
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.
Spara och aktivera den. En tom logg ska ändå returnera rubriken: played_date, game_id, players, duration_minutes, note.
Anpassa startåtgärden för att lägga till ett parti
Redigera den avstängda startåtgärden och behåll namnet log_lead_to_google_sheet. Ersätt dess gamla lead-parametrar, begärandekropp, beskrivning och meddelande under bearbetning. Det ärvda namnet är bara en identifierare; åtgärden ska nu logga spel.
Lägg till följande under What to ask the user first:
Kopiera parametrarna för spelomgången och begäran om att lägga till en rad
| Parameternamn | Typ | Obligatorisk | Beskrivning |
|---|---|---|---|
played_date | Text | Ja | Exakt bekräftat datum i formatet YYYY-MM-DD. Fråga i stället för att gissa vilket datum ett relativt datumuttryck avser. |
game_id | Text | Ja | Exakt ID som returnerats från samlingsfliken och bekräftats av värden. |
players | Number | Ja | Bekräftat antal personer som spelade. |
duration_minutes | Number | Ja | Bekräftad faktisk speltid, inte den planerade tidsbudgeten. |
note | Text | Nej | Valfri saklig anteckning från värden. Tom när den utelämnas. |
För note väljer du Default value → Empty value. Använd AI decides och lämna Response filter tomt. Ange begäran och Query Params så här:
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 låter du läget JSON vara aktiverat och ersätter startåtgärdens gamla begärandekropp med:
{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}
Värdenas ordning måste motsvara de fem kolumnerna. RAW lagrar texten ordagrant, så en anteckning som börjar med = blir ingen formel. Append-endpointen hittar nästa rad efter tabellen; OVERWRITE fyller den befintliga tomma raden och bevarar dess formatering och intervallet för formeln för senaste parti. Googles append-referens förklarar alternativen. Behåll Plays som en sammanhängande logg utan en annan tabell bredvid.
Kopiera beskrivningen för tilläggsåtgärden från action-recipes.json. Den kräver en separat bekräftelse, en dubblettkontroll, ett enda tillägg och en efterföljande läsning. Sätt meddelandet under bearbetning till Recording the confirmed play..., spara och aktivera åtgärden. Test Response för denna POST kan lägga till en riktig rad.
Spela, rapportera, bekräfta
Skicka det här i AI Preview:
We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.
Assistenten ska visa de föreslagna fälten och vänta. Kontrollera att Plays är oförändrad innan du bekräftar.
Shelf Night ber om bekräftelse. Den riktiga Plays-fliken innehåller fortfarande bara rubrikraden.
Svara ”Bekräfta.” Granska resultatet av tillägget och leta efter updates.updatedRows: 1, dess updatedRange och den efterföljande läsningen. Det faktiska kalkylarket ska innehålla 2026-11-08, SHELF-002, 4, 52 och en tom anteckning.
Det bekräftade partiet visas en gång i Plays, under samma fem rubriker. Agenten läste tillbaka loggen innan den rapporterade att lagringen lyckades.
Append-anropet returnerade en uppdaterad rad. Det returnerade intervallet motsvarar den ifyllda raden i Google Sheets.
Bekräftelse och dubblettkontroller är agentinstruktioner, inte en atomär databasbegränsning. Om en begäran får timeout ska du granska loggen innan du försöker igen. Två samtidiga samtal kan fortfarande lägga till samma rapport; den här lilla personliga loggen har inget reservationssystem eller transaktionslås.
Steg 5: Hur undviker du spel ni nyligen spelat?
Läs spelhistoriken med ett uttryckligt gränsdatum. Om spel som spelats den 2026-11-01 eller senare utesluts i exemplet försvinner Cascadia medan Azul blir kvar.
Paketet lägger också till en formel för senaste speltillfälle i Collection!I2 och fyller ned den över exempelraderna:
=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")
Den matchar det stabila spel-ID:t, sorterar ISO-datumsträngar med fast längd med det senaste först och returnerar det senaste loggade datumet. En sen rapport om ett äldre parti blir därför inte det senaste speltillfället. Utan ett matchande parti förblir cellen tom.
Efter posten för Cascadia kontrollerar du att Collection!I3 visar 2026-11-08. Om formeln visas som text återställer du cellens formatering till Automatisk och skriver in den på nytt. Behåll datum i Plays som vanlig text och kontrollera språkregionen och de exakta fliknamnen om formeln ger fel. Google dokumenterar funktionen FILTER som används för att välja matchande rader.
Collection!I3 beräknar Cascadias senast registrerade parti utifrån Plays. Den markerade cellen visar både formeln och resultatet, 2026-11-08.
Starta ett nytt samtal och fråga:
Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.
Den nya frågan utesluter det registrerade Cascadia-partiet och returnerar Azul. En tom last_played-cell betyder att inget parti finns registrerat i den här loggen.
De ursprungliga läsintervallen omfattar 100 spel och 500 partier, utan rubriker. När filen växer behöver läs-Actions och formelintervallen följa de faktiska posterna. Behåll append-inställningen insertDataOption: OVERWRITE så att en ny post inte flyttar formelns startrad förbi det parti du just registrerade.
Steg 6: Hur kontrollerar du att rekommendationerna har stöd i datan?
Testa fallen där hyllan inte kan ge något svar. En användbar spelväljare ska förklara begränsningen och låta dig bestämma vad som ska ändras.
Be om sex spelare, 60 minuter, lätt. Ingen av de fullständiga ägda posterna passar sex personer, och resespelets högsta spelarantal är okänt. Assistenten ska inte låna spelarantalet från expansionen till Cascadia eller rekommendera något från önskelistan.
Ett svar utan träff behåller de ursprungliga kraven synliga. Lägg till ett verifierat spel för sex spelare eller ändra kvällens plan.
Använd Testing → Simulation Testing för upprepningsbara kontroller och granska åtgärdsresultaten tillsammans med svaren. Behåll bekräftelseutbytet i samma samtal så att ”Bekräfta” avser ett specifikt förslag att godkänna.
De sparade samlingstesterna täcker en vanlig rekommendation, sex spelare, ett spel som inte ägs och saknade uppgifter. Granska motsvarande Action-resultat tillsammans med poängen.
| Prova detta | Kontrollera detta |
|---|---|
| Fyra spelare, 60 minuter, lätt | Endast Azul och Cascadia, med motiveringar från registrerade uppgifter |
| Sex spelare | Ingen verifierad träff; inget påhittat spelarantal |
| Rekommendera önskelisteexemplet | Uteslutning utifrån ägande gäller fortfarande |
| Hur lång tid tar resespelet? | Saknad speltid förblir okänd |
| Rapportera ett parti, före bekräftelse | Ingen ny rad i Plays |
| Bekräfta och bekräfta sedan igen | En rad i det här testet, inget andra tillägg |
| Uteslut partier från och med 2026-11-01 | Cascadia utesluts efter det loggade partiet |
De fyra samlingstesterna klarades i Simulation Testing. Vi verifierade också den separata bekräftelsen, en tillagd rad, formelresultatet, en upprepad bekräftelse utan ytterligare tillägg och en ny rekommendation som uteslöt Cascadia. Gå igenom paketets checklista med din egen fil innan du ersätter exempelraderna.
När kontrollerna är godkända ersätter du exempelraderna med din egen samling. Nästa gång gruppen samlas ger du Shelf Night spelarantal, tid och önskad spelkänsla, väljer bland förslagen och loggar spelet när ni är klara. Varje loggad kväll ger nästa val lite mer sammanhang.
För ett annat samlingsbaserat projekt använder spelväljaren för ospelade Steam-spel samma idé med registrerad speltid och personliga anteckningar. Guiden till API-åtgärdsbyggaren förklarar hur du anpassar mönstret till andra datakällor.
Vanliga frågor
Kan en brädspelsväljare föreslå enbart spel jag äger?
Ja. Den här lösningen läser fliken Collection innan den rekommenderar något och kräver att owned är TRUE. Den kontrollerar angivna spelargränser och din tidsbudget och förklarar sedan varje träff. Håll uppgifter om ägande och utgåvor uppdaterade.
Kan jag använda min samling på BoardGameGeek utan en API-nyckel?
Ja. Börja med en CSV-fil med din BGG-samling som du själv laddat ned, eller skriv in en liten samling i mallen. Granska exportens kolumner och komplettera saknade uppgifter utifrån din utgåva. Det här arbetsflödet anropar inte BGG:s API och synkroniserar inte din samling automatiskt.
Finns det en kalkylbladsmall för en brädspelssamling?
Startpaketet för Shelf Night innehåller Collection.tsv, Plays.tsv, formler för senaste speltillfälle, tre konfigurationsrecept för åtgärder, en Main Prompt och en testchecklista. Klistra in flikfilerna i kalkylarket som skapas av kopplingen mellan Quickchat AI och Google Sheets.
Ingår regelgenomgång och uppställning i tidsuppskattningen?
Kolumnen planning_minutes är hushållets tidsbudget, så du kan räkna in båda. I exemplet får Azul och Cascadia 60 minuter var. Den faktiska speltiden förs in i spelloggen efter ett parti och är separat från planeringsuppskattningen.
Kan den undvika brädspel vi nyligen spelat?
Ja, med registrerade partier och ett exakt gränsdatum. I det testade exemplet försvinner Cascadia från nästa förslagslista när ett parti registreras den 2026-11-08 och spel som spelats den 2026-11-01 eller senare utesluts. Oregistrerade partier förblir okända, och läsintervallen måste täcka den relevanta historiken.
Vad händer om inget brädspel vi äger passar gruppen?
Assistenten ska förklara vilka angivna gränser som utesluter kandidaterna och fråga vad du vill ändra. Den ska inte hitta på ett spelarantal, utöka tidsbudgeten utan att säga till eller byta till ett spel du inte äger.
Kan ChatGPT eller Claude hjälpa till med konfigurationen?
Kontohanteringskopplingen i Quickchat AI kan förbereda agentens prompt och HTTP-åtgärder utifrån paketet. Du behöver fortfarande godkänna åtkomsten hos Google, fylla i samlingen och kontrollera det verkliga kalkylarket. Att förbereda konfigurationen kör inga tester och publicerar inte agenten.