Doporučovač deskových her pro vlastní sbírku porovnává hry, které vlastníte, s dnešním počtem hráčů, dostupným časem a preferencemi. Shelf Night tuto sbírku načítá z Google Sheets, po potvrzení zapisuje dokončené partie a pomocí deníku se vyhýbá nedávno hraným hrám.
U stolu jste čtyři, máte hodinu na hraní a na polici Azul i Cascadii. První užší výběr obsahuje obě hry. Po zaznamenání partie Cascadie ji další dotaz vyloučí a ponechá Azul.
Cíl: Cascadia je zapsaná v herním deníku a Shelf Night doporučí Azul, když požádáte o vynechání nedávno hraných her.
Snímky Google Sheets ukazují náš připojený testovací soubor. Snímky Quickchat AI zobrazují v lokální aplikaci odpovědi a výsledky akcí zaznamenané naším živým testovacím agentem.
Nejprve nastavíte čtení sbírky, poté přidáte zapisování potvrzených partií a kontrolu nedávno hraných her. Ověříte uložený řádek i odpověď.
Stáhněte si startovací balíček Shelf Night. Obsahuje dva soubory s tabulkovými daty oddělenými tabulátory, úplné zadání, tři návody na nastavení akcí a kontrolní seznam testů. Jde o upravitelné referenční soubory, nikoli o automatický import agenta. Snímky obrazovky a nastavení ke zkopírování používají anglické názvy prvků rozhraní.
Postupujte podle kroků: připravte sbírku, připojte tabulku, získejte doporučení, zaznamenejte partii a vyhněte se opakování.
Co bude váš pomocník pro výběr hry vědět?
Shelf Night kombinuje zaznamenané údaje o hrách s preferencemi vaší domácnosti. Tabulka uchovává obojí v oddělených sloupcích, aby asistent mohl vysvětlit, z čeho doporučení vychází.
Vlastnictví, počet hráčů a plánovaný čas pomáhají vyřadit různé typy nevhodných doporučení.
Příklad používá dvě skutečné základní hry a dva záměrné hraniční případy. Vydavatelé uvádějí Azul pro 2–4 hráče a Cascadia pro 1–4 hráče. Naše smyšlená domácnost počítá pro obě s 60 minutami, včetně přípravy a vysvětlení pravidel. Je to náš rozpočet, nikoli záruka délky od vydavatele.
Ověřte vydání, které máte doma. Produktové obrázky: Next Move Games / Asmodee a Alderac Entertainment Group / Flatout Games. Herní doba podle vydavatele a časový rozpočet vaší skupiny jsou samostatné hodnoty.
Potřebujete účet Quickchat AI, účet Google, který může autorizovat propojení s Tabulkami, a několik her k zaevidování. Účet BoardGameGeek je volitelný. Ověřte aktuální limity AI kreditů a akcí pro svůj účet; konverzace a Simulation Testing spotřebovávají kredity.
Krok 1: Jak připravit sbírku deskových her?
Začněte malou sbírkou, kterou snadno zkontrolujete pohledem. Než asistenta požádáte o výběr, u každé hry zaznamenejte stálé ID, vlastnictví, rozsah počtu hráčů a časový rozpočet.
- Otevřete soubor
Collection.tsvz balíčku. Zachovejte názvy a pořadí záhlaví. Vzorové řádky nahraďte vlastními až po úspěšném prvním testu. - Každé krabici přidělte stálé
game_id, napříkladSHELF-001. Pokud vydání nebo rozšíření ovlivňuje pravidla, zahrňte ho do názvu. Nepovažujte rozšíření za samostatnou hru. - Počty hráčů opište z krabice, pravidel nebo od vydavatele. Do
planning_minuteszadejte čas, který potřebuje vaše skupina, včetně vysvětlení pravidel. Neověřené hodnoty ponechte prázdné. - Zvolte si vlastní označení
complexity, napříkladlightnebomedium. Vlastnictví zaznamenejte výslovně. U položky ze seznamu přání má býtownednastaveno naFALSE.
| Vzorová hra | Hráči | Časový rozpočet | Vlastnictví | Co ukazuje |
|---|---|---|---|---|
Azul, SHELF-001 | 2–4 | 60 minut | TRUE | Kandidát s úplnými údaji |
Cascadia (základní hra), SHELF-002 | 1–4 | 60 minut | TRUE | Kandidát, jehož partii později zaznamenáme a vyřadíme ho |
Ukázka ze seznamu přání, SHELF-003 | 2–4 | 45 minut | FALSE | I vhodná hra nemusí být ve vašem vlastnictví |
Nezaevidovaná cestovní hra, SHELF-004 | Minimum 2; maximum neznámé | Neznámý | TRUE | Chybějící informace musí zůstat neznámé |
Výchozí sbírka obsahuje dva úplné kandidáty, jeden řádek s nevlastněnou hrou a jeden neúplný záznam. Důvod každého vyloučení je vidět ve zdrojových datech.
Zbývající sloupce jsou source_url, last_played a language_note. Uchovejte odkaz na zdroj, pokud je k dispozici, do jazykových poznámek uveďte údaje o svém vydání a sloupec last_played nechte v kroku 5 vyplnit vzorcem. Vlastnictví nezaručuje, že je krabice fyzicky doma: řekněte asistentovi, aby vyřadil vše, co jste půjčili.
Lze začít exportem sbírky z BoardGameGeek?
Ano. Přihlaste se ke svému účtu na BGG, otevřete svou sbírku a stáhněte z ní seznam vlastněných her. Původní CSV si uložte zvlášť, zkontrolujte skutečné názvy sloupců a pak přeneste příslušné hodnoty do této šablony. Chybějící počty hráčů nebo časové odhady doplňte podle svého vydání hry, místo abyste je nechali model hádat.
Oficiální podmínky přístupu BGG rozlišují mezi stažením vlastní sbírky po přihlášení a registrovaným automatizovaným přístupem přes API. Tento postup používá ruční export nebo ruční zadání. Nevyžaduje propojení s API BGG ani nesynchronizuje změny z BGG.
Krok 2: Jak propojit Google Sheets s asistentem?
Použijte tabulku vytvořenou propojením Quickchat AI s Google Sheets. Oprávnění k tomuto souboru se automaticky nevztahuje na libovolnou tabulku, kterou už máte na Disku.
- Vytvořte si účet v Quickchat AI. Použijte výchozího agenta nebo zvolte Add new AI Agent → Set up manually. Pojmenujte ho Shelf Night.
- Otevřete Your Website → Install → Availability and access. Vypněte Widget & Embed access a nastavte Chat Page Access → Nobody. Tuto první verzi používejte pouze v AI Preview, kde jste přihlášeni.
- Otevřete Actions & MCPs → Add Action → Google Sheets a dokončete autorizaci u Googlu. Integrace požádá o omezený rozsah oprávnění
drive.filea vytvoří tabulku s listem Leads. - Vygenerovanou akci
log_lead_to_google_sheetpo dobu úprav vypněte. Zachovejte její název, aby ji připojení nadále rozpoznávalo. Zvolte Open sheet a přejmenujte soubor na Shelf Night. - Přejmenujte Leads na Plays, nahraďte původní záhlaví vložením obsahu
Plays.tsvdo buňky A1 a pak přidejte list Collection. V listu Plays ponechte alespoň 501 řádků a v listu Collection alespoň 101. - V nabídce File → Settings vyberte národní prostředí United States, aby fungovaly vzorce ze sady s čárkami jako oddělovači. Před zadáváním dat nastavte sloupec A listu Plays na formát Plain text. Vložte obsah
Collection.tsvdo buňky Collection!A1 a nechte vzorce ve sloupci I provést výpočty. Každý řádek záhlaví ukotvěte a zvýrazněte tučně. Upravte šířku sloupců nebo zapněte zalamování textu, aby byly hodnoty čitelné.
Kompaktní pohledy v článku dočasně skrývají sloupce C:F, H a J, aby hra, vlastnictví a datum poslední partie zůstaly čitelné. Podkladová karta Collection s deseti sloupci i rozsah A:J v akci zůstávají beze změny.
Obě nastavení přístupu upravte před připojením sbírky. Návod používá AI Preview na ovládacím panelu.
Průvodce propojením s Google Sheets popisuje autorizační obrazovky. Osobní komentáře z BGG a nesouvisející údaje o sbírce do tohoto malého ukázkového souboru nevkládejte.
Krok 3: Jak získat doporučení z vlastní sbírky?
Přidejte jednu akci pouze pro čtení a dejte agentovi pravidla pro použití její odpovědi. To stačí k prvnímu užitečnému užšímu výběru; akce pro zápis může zůstat vypnutá.
Načtěte sbírku
Otevřete Actions & MCPs → Add Action → API Action → Create manually. Akci pojmenujte Read Shelf Night collection, nastavte When to run → AI decides a zadejte:
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101
Headers
Authorization: Bearer {{google_sheets_access_token}}
Nahraďte YOUR_CREATED_SHEET_ID ID, které už je v URL vypnuté výchozí akce. Použijte vestavěný token Google Sheets z nabídky Add AI Data → System Tokens; ponechte ho jako proměnnou, nevkládejte přístupový token přímo. ID souboru i rozsah ponechte pevné, bez vstupních parametrů, těla a parametrů dotazu. Pole Response filter nechte prázdné.
Použijte tento 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.
Načítejte záhlaví společně s řádky sbírky. Konverzace nesmí určovat tabulku ani rozsah.
Akci uložte a zapněte. Spusťte Test Response a porovnejte values s tabulkou. Google ve svém koncovém bodu values.get standardně vrací formátované hodnoty buněk; čísla a logické hodnoty mohou přijít jako řetězce a koncové prázdné buňky mohou být vynechány. Kratší řádek neopravňuje k domýšlení chybějících hodnot.
Dejte asistentovi Shelf Night pravidla
Otevřete Identity → Main Prompt, vložte main-prompt.txt z balíčku a uložte. Pravidlo výběru je konkrétní: znovu načíst sbírku, vyžadovat vlastnictví a úplné údaje o omezeních, vrátit nejvýše tři vyhovující hry a vysvětlit případné chybějící informace.
Main Prompt vysvětluje, jak vybírat. Tyto dva výřezy ukazují jeho umístění a úvodní pokyny. Aktuální sbírku dodává akce.
V AI Preview se zeptejte:
Four players, 60 minutes, something light. What do we own that fits?
První užitečná odpověď: Azul a Cascadia splňují zaznamenané podmínky vlastnictví, počtu hráčů a času.
Se vzorovými daty vyhovují Azul a Cascadia. Řádek seznamu přání nesplňuje vlastnictví a cestovní hra nemá dostatek údajů. Otevřete uloženou konverzaci v Inbox, rozbalte volání akce a prohlédněte vrácené hodnoty. Úplný záznam požadavku najdete přes View logs na kartě akce.
Porovnejte odpověď s podkladovými daty. Značka akce říká, že proběhlo volání; jeho výsledek ukazuje, co asistent skutečně obdržel.
Nechte nastavení připravit ChatGPT nebo Claude
Propojení pro správu účtu Quickchat AI dokáže připravit Main Prompt a HTTP akce. Připojte se přes oficiální položku pro ChatGPT nebo položku pro Claude podle průvodce správou účtu. Přiložte balíček a odešlete:
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.
Autorizaci Googlu, vyplnění tabulky a ověření skutečných řádků stále provádíte vy. Příprava nastavení pomocí asistenta tyto kroky nedokončí.
Krok 4: Jak zaznamenat odehranou partii deskové hry?
Pro každou dokončenou partii použijte jeden řádek a před jeho přidáním vyžadujte potvrzení. Doporučení hry Cascadia se nikdy nesmí počítat jako odehraná partie Cascadia.
Datum a ID hry propojují dokončenou partii s dalším užším výběrem.
Přidejte akci pro čtení herního deníku
Vytvořte druhou akci s názvem Read Shelf Night plays, se stejným nastavením GET a hlavičkou tokenu jako u první. Rozsah změňte na:
https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501
Jako popis nastavte:
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.
Uložte ji a zapněte. I prázdný deník by měl vracet záhlaví: played_date, game_id, players, duration_minutes, note.
Upravte výchozí akci pro přidání partie
Upravte vypnutou výchozí akci a zachovejte název log_lead_to_google_sheet. Nahraďte původní parametry kontaktu, tělo požadavku, popis a zprávu zobrazovanou při zpracování. Převzatý název slouží jen jako identifikátor; tato akce nyní bude zaznamenávat hry.
V části What to ask the user first přidejte:
Zkopírujte parametry partie a požadavek na připojení řádku
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
played_date | Text | Ano | Přesné potvrzené datum ve formátu YYYY-MM-DD. Pokud je datum uvedeno relativně, vyžádejte si přesné datum místo odhadování. |
game_id | Text | Ano | Přesné ID vrácené z listu Collection a potvrzené hostitelem. |
players | Number | Ano | Potvrzený počet lidí, kteří hráli. |
duration_minutes | Number | Ano | Potvrzená skutečná délka, nikoli časový rozpočet. |
note | Text | Ne | Volitelná věcná poznámka od hostitele. Při vynechání prázdná. |
Pro note zvolte Default value → Empty value. Použijte AI decides a pole Response filter nechte prázdné. Požadavek a Query Params nastavte takto:
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
V části Body ponechte zapnutý režim JSON a nahraďte původní tělo požadavku výchozí akce tímto:
{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}
Pořadí hodnot musí odpovídat pěti sloupcům. RAW ukládá dodaný text doslova, takže poznámka začínající = se nestane vzorcem. Endpoint append najde další řádek za tabulkou; OVERWRITE vyplní tento existující prázdný řádek a zachová jeho formátování i rozsah vzorce pro poslední partii. Možnosti vysvětluje dokumentace append od Googlu. Kartu Plays udržujte jako jeden souvislý deník bez další tabulky vedle něj.
Zkopírujte popis přidávání z action-recipes.json. Vyžaduje samostatné potvrzení, kontrolu duplicity, jedno přidání a následné načtení. Zprávu při zpracování nastavte na Recording the confirmed play..., akci uložte a zapněte. Test Response u tohoto požadavku POST může přidat skutečný řádek.
Zahrajte, nahlaste, potvrďte
V AI Preview odešlete:
We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.
Asistent by měl zobrazit navrhovaná pole a počkat. Před potvrzením zkontrolujte, že list Plays zůstal beze změny.
Shelf Night žádá o potvrzení. Skutečná karta Plays stále obsahuje pouze záhlaví.
Odpovězte „Potvrzuji.“ Ve výsledku připojení řádku zkontrolujte updates.updatedRows: 1, příslušný updatedRange a následné načtení. Ve skutečné tabulce by měly být hodnoty 2026-11-08, SHELF-002, 4, 52 a prázdná poznámka.
Potvrzená partie se v Plays objeví jednou, pod stejnými pěti záhlavími. Agent před oznámením úspěchu deník znovu načetl.
Operace append vrátila jeden aktualizovaný řádek. Vrácený rozsah odpovídá vyplněnému řádku v Google Sheets.
Potvrzení a kontroly duplicit jsou pokyny pro agenta, nikoli atomické databázové omezení. Pokud vyprší časový limit požadavku, před opakováním zkontrolujte deník. Dvě souběžné konverzace stále mohou přidat stejné hlášení; tento malý osobní deník nezavádí rezervační systém ani transakční zámek.
Krok 5: Jak vynechat nedávno hrané hry?
Načtěte historii partií s výslovně zadaným mezním datem. V příkladu vyloučení her hraných dne 2026-11-01 nebo později odstraní Cascadia a ponechá Azul.
Balíček také přidává vzorec pro poslední partii do Collection!I2 a vyplňuje ho dolů do vzorových řádků:
=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")
Vyhledá shodu podle stálého ID hry, seřadí řetězce dat ISO s pevnou délkou od nejnovějšího a vrátí poslední zaznamenané datum. Pozdní nahlášení starší partie se tak nestane nejnovější partií. Pokud žádná partie neodpovídá, buňka zůstane prázdná.
Po záznamu partie Cascadia ověřte, že Collection!I3 zobrazuje 2026-11-08. Pokud se vzorec zobrazuje doslova, obnovte u buňky automatický formát a zadejte ho znovu. Data na kartě Plays ponechte jako prostý text a při chybě vzorce zkontrolujte národní prostředí a přesné názvy karet. Google popisuje použitou funkci FILTER pro výběr odpovídajících řádků.
Collection!I3 vypočítá poslední zaznamenanou partii Cascadie z karty Plays. Vybraná buňka zobrazuje vzorec i jeho výsledek, 2026-11-08.
Začněte novou konverzaci a zeptejte se:
Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.
Nový dotaz vyloučí zaznamenanou partii Cascadie a vrátí Azul. Prázdná buňka last_played znamená, že v tomto deníku není zaznamenaná partie.
Výchozí rozsahy načítání pokrývají 100 her a 500 partií, bez záhlaví. S růstem souboru udržujte rozsahy čtecích akcí i vzorců v souladu se skutečnými záznamy. Ponechte nastavení přidávání insertDataOption: OVERWRITE, aby nový záznam neposunul počáteční řádek vzorce za právě zaznamenanou partii.
Krok 6: Jak ověřit, že doporučení vycházejí z dat?
Otestujte případy, kdy sbírka nedokáže nabídnout odpověď. Užitečný pomocník by měl vysvětlit omezení a nechat vás rozhodnout, co změnit.
Zadejte požadavek na hru pro šest hráčů, do 60 minut, nenáročnou. Ani jeden z úplně vyplněných řádků vlastněných her nevyhovuje šesti hráčům a maximální počet hráčů u cestovní hry není znám. Asistent by neměl použít počet hráčů z rozšíření hry Cascadia ani doporučit něco ze seznamu přání.
Odpověď bez vhodné hry zachovává původní podmínky. Přidejte ověřenou hru pro šest hráčů nebo změňte plán večera.
Pro opakovatelné kontroly použijte Testing → Simulation Testing a vedle odpovědí prohlížejte i výsledky akcí. Potvrzovací výměnu veďte v jedné konverzaci, aby „Potvrzuji“ schvalovalo konkrétní návrh.
Uložené kontroly sbírky pokrývají běžné doporučení, šest hráčů, nevlastněnou hru a chybějící údaje. Kromě skóre zkontrolujte i výsledky příslušných akcí.
| Vyzkoušejte | Zkontrolujte |
|---|---|
| Čtyři hráči, 60 minut, nenáročná hra | Pouze Azul a Cascadia, s odůvodněním podle zaznamenaných údajů |
| Šest hráčů | Žádná ověřená shoda; žádná vymyšlená kapacita |
| Doporuč ukázku ze seznamu přání | Vyloučení kvůli vlastnictví zůstává v platnosti |
| Jak dlouho trvá cestovní hra? | Chybějící čas zůstává neznámý |
| Nahlášení partie před potvrzením | Žádný nový řádek v Plays |
| Potvrzení a následné opětovné potvrzení | V tomto testu jeden řádek bez druhého přidání |
| Vyloučení partií ze dne 2026-11-01 nebo pozdějších | Cascadia je po zaznamenané partii vyřazena |
Všechny čtyři kontroly sbírky prošly v Simulation Testing. Ověřili jsme také samostatné potvrzení, jeden přidaný řádek, výsledek jeho vzorce, opakované potvrzení bez dalšího přidání a nové doporučení, které vyloučilo Cascadii. Před nahrazením ukázkových řádků projděte kontrolní seznam z balíčku ve vlastním souboru.
Jakmile kontroly projdou, nahraďte vzorové řádky svou sbírkou. Až si příště vaše skupina sedne ke hraní, sdělte asistentovi Shelf Night počet hráčů, čas a náladu, vyberte z nabídnutých možností a po dohrání partii zaznamenejte. Každý zaznamenaný večer dodá příštímu výběru o trochu více souvislostí.
Dalším projektem založeným na sbírce je pomocník pro výběr neodehraných her na Steamu, který stejný princip používá se zaznamenanou herní dobou a osobními poznámkami. Průvodce tvorbou API akcí vysvětluje, jak tento postup přizpůsobit dalším zdrojům dat.
Často kladené otázky
Může doporučovač deskových her navrhovat jen hry, které vlastním?
Ano. Toto nastavení před doporučením načte kartu Collection a vyžaduje hodnotu TRUE v poli owned. Ověří zaznamenané limity počtu hráčů a váš časový rozpočet a poté vysvětlí každou shodu. Údaje o vlastnictví a vydání udržujte aktuální.
Mohu použít svou sbírku z BoardGameGeek bez klíče API?
Ano. Začněte vlastním ručně staženým souborem CSV se sbírkou z BGG nebo do šablony zapište malou sbírku. Prohlédněte sloupce exportu a chybějící údaje doplňte podle svého vydání. Tento postup nevolá API BGG ani automaticky nesynchronizuje vaši sbírku.
Existuje tabulková šablona pro sbírku deskových her?
Startovací balíček Shelf Night obsahuje soubory Collection.tsv a Plays.tsv, vzorce pro poslední partii, tři návody na nastavení akcí, Main Prompt a kontrolní seznam testů. Soubory pro jednotlivé karty vložte do tabulky vytvořené propojením Quickchat AI s Google Sheets.
Zahrnuje časový odhad vysvětlení pravidel a přípravu?
Sloupec planning_minutes představuje časový rozpočet vaší domácnosti, takže do něj můžete zahrnout obojí. Příklad přiděluje hrám Azul a Cascadia 60 minut. Skutečná délka se po partii zapisuje do herního deníku a je oddělená od plánovaného odhadu.
Dokáže vynechat deskové hry, které jsme hráli nedávno?
Ano, podle zaznamenaných partií a přesného mezního data. V otestovaném příkladu zaznamenání Cascadie k datu 2026-11-08 a vyloučení her zaznamenaných 2026-11-01 nebo později odstraní Cascadii z příštího užšího výběru. Nezaznamenané partie zůstávají neznámé a rozsahy načítání musí pokrývat příslušnou historii.
Co se stane, když skupině nevyhovuje žádná z vlastněných deskových her?
Asistent by měl vysvětlit, které zaznamenané limity kandidáty vylučují, a zeptat se, co chcete změnit. Neměl by si vymýšlet počet hráčů, bez upozornění prodlužovat časový rozpočet ani nabízet hru, kterou nevlastníte.
Mohou s nastavením pomoci ChatGPT nebo Claude?
Propojení pro správu účtu Quickchat AI dokáže z balíčku připravit zadání agenta a HTTP akce. Autorizaci Googlu, zadání sbírky a ověření skutečné tabulky stále provádíte vy. Příprava konfigurace nespouští testy ani nezveřejňuje agenta.