Створіть помічника для вибору настільних ігор із власної колекції

Piotr Grudzień
Опубліковано Час читання: 11 хв
Колекція Shelf Night у Google Sheets і записана партія в Cascadia поруч із відповідною рекомендацією Quickchat AI

Помічник для вибору настільних ігор із власної колекції зіставляє ваші ігри з кількістю гравців, доступним часом і побажаннями на сьогодні. Shelf Night читає колекцію з Google Sheets, записує завершену партію після підтвердження й використовує журнал, щоб уникати недавніх повторів.

Вас четверо за столом, на гру є година, а на полиці стоять Azul і Cascadia. Перша добірка містить обидві гри. Після запису партії в Cascadia наступний запит виключає її та залишає Azul.

Записана дата партії в Cascadia у Google Sheets поруч із новою рекомендацією Azul від Shelf Night Результат: Cascadia записана в журналі партій, а Shelf Night рекомендує Azul на прохання уникнути недавніх повторів.

Знімки Google Sheets показують наш підключений тестовий файл. На знімках Quickchat AI локальний застосунок відображає відповіді та результати Actions, записані нашим робочим тестовим агентом.

Спочатку ви налаштуєте читання колекції, потім додасте запис партій із підтвердженням і перевірку недавніх ігор. Ви перевірите і збережений рядок, і відповідь.

Завантажте стартовий набір Shelf Night. Він містить два файли таблиць із розділенням табуляцією, повний промпт, три інструкції налаштування дій і контрольний список тестів. Це довідкові файли для редагування, а не автоматичний імпорт агента. На знімках екрана й у налаштуваннях для копіювання використано англійські назви елементів інтерфейсу.

Дотримуйтеся кроків, щоб підготувати колекцію, підключити таблицю, отримати рекомендацію, записати партію та уникати повторів.

Що знатиме ваш помічник для ігрових вечорів?

Shelf Night поєднує записані факти про ігри з уподобаннями вашої компанії. Таблиця містить і те, й інше в окремих стовпцях, щоб помічник міг пояснити підстави рекомендації.

Три перевірки під час добору: наявність у колекції, відповідна кількість гравців і достатній час Наявність у колекції, кількість гравців і плановий час відсіюють різні типи невдалих пропозицій.

У прикладі використано дві справжні базові гри й два навмисні граничні випадки. Видавці вказують для Azul 2–4 гравців, а для Cascadia 1–4 гравців. Наша вигадана компанія відводить 60 хвилин на кожну з них, включно з підготовкою та поясненням правил. Це наш бюджет часу, а не гарантія тривалості від видавця.

Зображення ігор Azul та Cascadia із заявленими кількістю гравців і тривалістю партії поруч із 60-хвилинним часовим бюджетом компанії Перевірте видання на своїй полиці. Зображення ігор: Next Move Games / Asmodee та Alderac Entertainment Group / Flatout Games. Заявлена видавцем тривалість і часовий бюджет вашої компанії є окремими значеннями.

Вам потрібні обліковий запис Quickchat AI, обліковий запис Google, який може авторизувати підключення до Таблиць, і кілька ігор для каталогу. Обліковий запис BoardGameGeek необов’язковий. Перевірте поточні ліміти ШІ-кредитів і дій для свого облікового запису; розмови й Simulation Testing витрачають кредити.

Крок 1: Як підготувати колекцію настільних ігор?

Почніть із невеликої колекції, яку легко перевірити на око. Перш ніж просити помічника зробити вибір, запишіть для кожної гри незмінний ідентифікатор, наявність у колекції, діапазон кількості гравців і часовий бюджет.

  1. Відкрийте Collection.tsv із набору. Збережіть назви й порядок заголовків. Замініть приклади рядків власними пізніше, коли запрацює перший тест.
  2. Призначте кожній коробці незмінний game_id, наприклад SHELF-001. Додайте до назви видання або доповнення, якщо воно впливає на правила. Не вважайте доповнення самостійною грою.
  3. Перепишіть кількість гравців із коробки, правил або сайту видавця. У planning_minutes вкажіть час, потрібний вашій компанії, включно з поясненням правил. Неперевірені значення залишайте порожніми.
  4. Виберіть власні позначки complexity, наприклад light або medium. Явно зазначайте наявність у колекції. Для гри зі списку бажаного в полі owned має стояти FALSE.
Приклад гриГравціЧасовий бюджетЄ у власностіЩо показує
Azul, SHELF-0012–460 хвилинTRUEКандидат із повними даними
Cascadia (базова гра), SHELF-0021–460 хвилинTRUEКандидат, партію в який ми згодом запишемо й виключимо з добірки
Приклад зі списку бажаного, SHELF-0032–445 хвилинFALSEНавіть вдалої за параметрами гри може не бути у власності
Неописана дорожня гра, SHELF-004Мінімум 2; максимум невідомийНевідомийTRUEВідсутня інформація має залишатися невідомою

Вкладка Collection у Google Sheets із чотирма прикладами ігор і збільшеними стовпцями кількості гравців, часу та володіння Стартова колекція містить двох кандидатів із повними даними, одну гру, якою ви не володієте, і один неповний запис. Причину кожного виключення видно у вихідних даних.

Решта стовпців: source_url, last_played та language_note. Зберігайте посилання на джерело, якщо воно є, вказуйте мовні примітки для свого видання, а заповнення last_played доручіть формулі в кроці 5. Право власності не гарантує, що коробка фізично вдома: попросіть помічника виключити все, що ви позичили іншим.

Чи можна почати з експорту колекції BoardGameGeek?

Так. Увійдіть у власний обліковий запис BGG, відкрийте колекцію та скористайтеся завантаженням колекції для ігор у власності. Збережіть початковий CSV окремо, перевірте його фактичні заголовки, а потім перенесіть потрібні значення в цей шаблон. Доповніть відсутню кількість гравців або оцінку часу за своїм виданням, а не просіть модель їх угадати.

Офіційні умови доступу BGG розрізняють завантаження власної колекції після входу в обліковий запис і зареєстрований автоматизований доступ через API. У цьому посібнику використано ручний експорт або ручне введення. Підключення до API BGG не потрібне, а зміни в BGG не синхронізуються.

Крок 2: Як підключити Google Sheets до помічника?

Використовуйте таблицю, створену підключенням Google Sheets у Quickchat AI. Його дозвіл на доступ до файлу не поширюється автоматично на довільну таблицю, яка вже є на вашому Диску.

  1. Створіть обліковий запис Quickchat AI. Використайте початкового агента або виберіть Add new AI Agent → Set up manually. Назвіть його Shelf Night.
  2. Відкрийте Your Website → Install → Availability and access. Вимкніть Widget & Embed access і встановіть Chat Page Access → Nobody. Залиште цю першу версію лише в AI Preview, доступному після входу в обліковий запис.
  3. Відкрийте Actions & MCPs → Add Action → Google Sheets і пройдіть авторизацію Google. Інтеграція запитує обмежену область доступу drive.file і створює таблицю з вкладкою Leads.
  4. Вимкніть згенеровану дію log_lead_to_google_sheet на час адаптації. Збережіть її назву, щоб підключення й надалі могло її розпізнавати. Виберіть Open sheet і перейменуйте файл на Shelf Night.
  5. Перейменуйте Leads на Plays, замініть старі заголовки, вставивши Plays.tsv у A1, а потім додайте вкладку Collection. Залиште щонайменше 501 рядок у Plays і 101 у Collection.
  6. У File → Settings виберіть регіон United States для формул із набору, у яких аргументи розділено комами. Перед введенням дат задайте для стовпця A вкладки Plays формат Plain text. Вставте Collection.tsv у Collection!A1, давши формулам у стовпці I виконати обчислення. Закріпіть кожен рядок заголовків і виділіть його жирним; розширте стовпці або ввімкніть перенесення тексту, щоб значення було зручно читати.

У компактних поданнях у цій статті тимчасово приховано стовпці C:F, H і J, щоб назва гри, володіння й дата останньої партії залишалися читабельними. Вихідна вкладка Collection із десятьма стовпцями та діапазон A:J дії не змінюються.

Налаштування доступу до сайту Shelf Night з вимкненим доступом через віджет і вбудовування та значенням Nobody для Chat Page Access Налаштуйте обидва засоби контролю доступу, перш ніж підключати колекцію. У посібнику використано AI Preview на панелі керування.

У посібнику з підключення Google Sheets описано екрани авторизації. Не додавайте особисті коментарі з BGG та сторонні дані колекції до цього невеликого демонстраційного файлу.

Крок 3: Як отримати рекомендацію з власної колекції?

Додайте одну дію лише для читання й задайте агенту правила використання її відповіді. Цього достатньо для першої корисної добірки; дію записування можна залишити вимкненою.

Прочитайте колекцію

Відкрийте Actions & MCPs → Add Action → дія API → Create manually. Назвіть дію Read Shelf Night collection, установіть When to run → AI decides і введіть:

GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101

Headers
Authorization: Bearer {{google_sheets_access_token}}

Замініть YOUR_CREATED_SHEET_ID на ідентифікатор, який уже є в URL вимкненої початкової дії. Використайте вбудований токен Google Sheets із Add AI Data → System Tokens; залиште його змінною, а не вставленим токеном доступу. Зафіксуйте ідентифікатор файлу й діапазон, без вхідних параметрів, тіла та параметрів запиту. Залиште Response filter порожнім.

Використайте такий 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.

Дія читання колекції в Quickchat AI з фіксованим діапазоном Google Sheets Читайте заголовок і рядки колекції разом. Не дозволяйте розмові змінювати таблицю та діапазон.

Збережіть і ввімкніть дію. Запустіть Test Response і порівняйте values з таблицею. Кінцева точка values.get Google за замовчуванням повертає форматовані значення клітинок; числа й логічні значення можуть надходити як рядки, а порожні клітинки наприкінці можуть пропускатися. Короткий рядок не дає дозволу вигадувати відсутні значення.

Задайте правила для Shelf Night

Відкрийте Identity → Main Prompt, вставте main-prompt.txt із набору й збережіть. Правило добору конкретне: знову прочитати колекцію, вимагати наявності у власності й повних даних про обмеження, повернути щонайбільше три варіанти та пояснити, якої інформації бракує.

Сторінка Identity агента Shelf Night та уривок його Main Prompt У Main Prompt пояснено, як робити вибір. Ці два фрагменти показують його розташування й початкові інструкції; актуальну колекцію надає дія.

У AI Preview запитайте:

Four players, 60 minutes, something light. What do we own that fits?

Початкова колекція Google Sheets поруч із добіркою двох ігор від Shelf Night Перша корисна відповідь: Azul і Cascadia відповідають записаним умовам володіння, кількості гравців і часу.

За даними прикладу Azul та Cascadia підходять. Рядок зі списку бажаного не проходить перевірку власності; про дорожню гру бракує відомостей. Відкрийте збережену розмову в Inbox, розгорніть виклик дії та перегляньте повернуті значення. Скористайтеся View logs на картці дії, щоб побачити повний запис запиту.

Розгорнутий виклик читання колекції в Inbox у Quickchat AI Порівняйте відповідь із даними, на яких вона ґрунтується. Позначка дії свідчить, що виклик відбувся; його результат показує, що саме отримав помічник.

Доручіть ChatGPT або Claude підготувати налаштування

Підключення для керування обліковим записом Quickchat AI може підготувати Main Prompt та HTTP-дії. Підключіться через офіційну сторінку в ChatGPT або сторінку в Claude, дотримуючись посібника з керування обліковим записом. Прикріпіть набір і надішліть:

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.

Авторизувати Google, заповнити таблицю та перевірити справжні рядки все одно потрібно вам. Підготовка налаштувань через помічника не виконує цих кроків.

Крок 4: Як записати зіграну партію в настільну гру?

Відводьте один рядок на кожну завершену партію та вимагайте підтвердження перед додаванням. Рекомендація Cascadia ніколи не має зараховуватися як партія в Cascadia.

Шлях від повідомлення про партію через підтвердження до нового рядка журналу й подальшої рекомендації Дата й ідентифікатор гри пов’язують завершену партію з наступною добіркою.

Додайте дію читання журналу партій

Створіть другу дію з назвою Read Shelf Night plays із такими самими налаштуваннями GET і заголовком токена, як у першої, змінивши діапазон на:

https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501

Задайте такий опис:

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.

Збережіть і ввімкніть її. Навіть порожній журнал має повертати заголовки: played_date, game_id, players, duration_minutes, note.

Адаптуйте початкову дію для додавання партії

Відредагуйте вимкнену початкову дію, зберігши назву log_lead_to_google_sheet. Замініть її старі параметри ліда, тіло запиту, опис і повідомлення під час обробки. Успадкована назва є лише ідентифікатором; тепер ця дія записуватиме ігри.

У розділі What to ask the user first додайте:

Скопіюйте параметри партії та запит на додавання рядка
ПараметрТипОбов’язковийОпис
played_dateTextТакТочна підтверджена дата у форматі YYYY-MM-DD. Якщо дату вказано відносно поточного дня, уточніть її, а не вгадуйте.
game_idTextТакТочний ідентифікатор, повернутий із Collection і підтверджений господарем вечора.
playersNumberТакПідтверджена кількість людей, які грали.
duration_minutesNumberТакПідтверджена фактична тривалість, а не плановий бюджет.
noteTextНіНеобов’язкова фактична примітка від господаря вечора. Порожня, якщо її не вказано.

Для note виберіть Default value → Empty value. Використайте AI decides і залиште Response filter порожнім. Налаштуйте запит і Query Params так:

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

У розділі Body залиште режим JSON увімкненим і замініть старе тіло запиту початкової дії на:

{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}

Порядок значень має відповідати п’ятьом стовпцям. RAW зберігає текст буквально, тому примітка, що починається з =, не стає формулою. Метод append знаходить наступний рядок після таблиці; OVERWRITE заповнює цей наявний порожній рядок, зберігаючи його форматування й діапазон формули останньої партії. Параметри пояснює довідник Google щодо append. Залиште Plays єдиним неперервним журналом без іншої таблиці поруч.

Скопіюйте опис додавання з action-recipes.json. Він вимагає окремого підтвердження, перевірки дублікатів, одного додавання та подальшого читання. Задайте повідомлення під час обробки Recording the confirmed play..., збережіть і ввімкніть дію. Test Response для цього POST може додати справжній рядок.

Зіграйте, повідомте, підтвердьте

Надішліть це в AI Preview:

We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.

Помічник має показати запропоновані поля й зачекати. Перш ніж підтвердити, перевірте, що Plays не змінився.

Запит Shelf Night на підтвердження п'яти полів поруч із порожньою вкладкою Plays у Google Sheets Shelf Night просить підтвердження. Справжня вкладка Plays досі містить лише рядок заголовків.

Дайте відповідь «Підтверджую». Перевірте результат додавання: updates.updatedRows: 1, значення updatedRange та подальше читання. У самій таблиці мають бути 2026-11-08, SHELF-002, 4, 52 і порожня примітка.

Підтверджена партія в Cascadia у Shelf Night поруч із новим рядком Google Sheets Підтверджена партія з’являється в Plays один раз, під тими самими п’ятьма заголовками. Агент повторно прочитав журнал, перш ніж повідомити про успіх.

Журнал дії додавання рядка з підтвердженими полями для Cascadia, успішним статусом і одним оновленим рядком Операція додавання повернула один оновлений рядок. Повернений діапазон відповідає заповненому рядку в Google Sheets.

Підтвердження й перевірки дублікатів є інструкціями для агента, а не атомарним обмеженням бази даних. Якщо час очікування запиту минув, перевірте журнал перед повторною спробою. Дві одночасні розмови все одно можуть додати той самий запис про партію; цей невеликий особистий журнал не має системи резервування чи транзакційного блокування.

Крок 5: Як уникати ігор, у які ви нещодавно грали?

Прочитайте історію партій із явно заданою граничною датою. У прикладі виключення ігор, зіграних 2026-11-01 або пізніше, прибирає Cascadia і залишає Azul.

Набір також додає формулу останньої партії в Collection!I2 і заповнює нею рядки прикладу нижче:

=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")

Вона зіставляє незмінний ідентифікатор гри, сортує рядки дат ISO фіксованої довжини від найновіших і повертає останню записану дату. Тому запізніле повідомлення про давнішу партію не зробить її найновішою. Якщо відповідної партії немає, клітинка залишається порожньою.

Після запису Cascadia перевірте, що Collection!I3 показує 2026-11-08. Якщо формула відображається як текст, поверніть для цієї клітинки автоматичний формат і введіть її знову. Залишайте дати Plays у текстовому форматі, а в разі помилки формули перевірте регіональні налаштування й точні назви вкладок. Google описує функцію FILTER, яка використовується для вибору відповідних рядків.

Google Sheets із формулою в Collection I3 та обчисленою датою останньої партії в Cascadia Collection!I3 обчислює останню записану партію в Cascadia за даними Plays. Вибрана клітинка показує і формулу, і її результат: 2026-11-08.

Почніть нову розмову й запитайте:

Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.

Shelf Night вибирає Azul після виключення записаної партії в Cascadia Новий запит виключає записану партію в Cascadia й повертає Azul. Порожня клітинка last_played означає відсутність записаної партії в цьому журналі.

Початкові діапазони читання охоплюють 100 ігор і 500 партій, без заголовків. Із розширенням файлу узгоджуйте діапазони дій читання й формул із фактичними записами. Зберігайте параметр додавання insertDataOption: OVERWRITE, щоб новий запис не пересунув початок діапазону формули за щойно записану партію.

Крок 6: Як перевірити, що рекомендації спираються на дані?

Перевірте випадки, коли колекція не дає відповіді. Корисний помічник має пояснити обмеження й залишити вам рішення, що змінити.

Попросіть щось нескладне для шести гравців на 60 хвилин. Жоден із двох повних рядків ігор у власності не підходить для шістьох, а максимальна кількість гравців дорожньої гри невідома. Помічник не повинен запозичувати кількість гравців із доповнення до Cascadia чи радити щось зі списку бажаного.

Shelf Night пояснює, чому у зразку колекції немає перевіреної гри для шістьох Відповідь про відсутність варіантів зберігає початкові обмеження видимими. Додайте перевірену гру для шістьох або змініть план вечора.

Використовуйте Testing → Simulation Testing для повторюваних перевірок і переглядайте результати дій разом із відповідями. Проводьте обмін підтвердженнями в одній розмові, щоб «Підтверджую» стосувалося конкретної пропозиції.

Чотири завершені тести колекції в Quickchat AI та відповідь, що пояснює відсутність тривалості для дорожньої гри Збережені тести колекції охоплюють звичайну рекомендацію, шістьох гравців, гру, якою ви не володієте, і відсутні дані. Перевіряйте відповідні результати Actions разом з оцінками.

СпробуйтеПеревірте
Четверо гравців, 60 хвилин, щось нескладнеЛише Azul та Cascadia, із поясненнями на основі записаних даних
Шестеро гравцівНемає перевіреного варіанта; кількість підтримуваних гравців не вигадано
Порадь приклад зі списку бажаногоВиключення за відсутністю у власності залишається чинним
Скільки триває дорожня гра?За відсутності даних тривалість залишається невідомою
Повідомте про партію, але ще не підтверджуйтеНового рядка в Plays немає
Підтвердьте, а потім підтвердьте ще разОдин рядок у цьому тесті, без другого додавання
Виключіть ігри, зіграні 2026-11-01 або пізнішеCascadia виключено після запису партії

Чотири перевірки колекції пройшли в Simulation Testing. Ми також перевірили окреме підтвердження, один доданий рядок, результат формули, повторне підтвердження без нового додавання та свіжу рекомендацію, яка виключила Cascadia. Пройдіть контрольний список із набору на власному файлі, перш ніж замінювати приклади рядків.

Коли ці перевірки пройдено, замініть приклади рядків власною колекцією. Наступного разу, коли збереться ваша компанія, повідомте Shelf Night кількість гравців, час і настрій, виберіть із запропонованих варіантів і запишіть партію після завершення. Кожен записаний вечір додає трохи контексту для наступного вибору.

Ще один проєкт на основі колекції, помічник для вибору непройдених ігор Steam, використовує ту саму ідею із записаним ігровим часом та особистими нотатками. Посібник зі створення дій API пояснює, як адаптувати цей підхід до інших джерел даних.

Поширені запитання

Чи може помічник радити лише ті настільні ігри, які я маю?

Так. Перед рекомендацією ця конфігурація читає вкладку Collection і вимагає значення TRUE у полі owned. Вона перевіряє записані обмеження кількості гравців і ваш часовий бюджет, а потім пояснює кожен вибір. Підтримуйте актуальність даних про наявність у колекції та видання.

Чи можна використати свою колекцію з BoardGameGeek без API-ключа?

Так. Почніть із власного CSV-файлу колекції, завантаженого з BGG вручну, або внесіть кілька ігор у шаблон. Перевірте стовпці експорту й доповніть відсутні дані за своїм виданням. Цей процес не звертається до API BGG і не синхронізує колекцію автоматично.

Чи є шаблон таблиці для колекції настільних ігор?

Стартовий набір Shelf Night містить Collection.tsv, Plays.tsv, формули останньої партії, три інструкції налаштування дій, Main Prompt і контрольний список тестів. Вставте файли вкладок у таблицю, створену підключенням Google Sheets у Quickchat AI.

Чи враховує оцінка часу пояснення правил і підготовку?

Стовпець planning_minutes містить часовий бюджет вашої компанії, тож ви можете врахувати й те, й інше. У прикладі для Azul та Cascadia відведено по 60 хвилин. Фактичну тривалість записують у журнал після партії; це окреме значення, не планова оцінка.

Чи може помічник уникати настільних ігор, у які ми нещодавно грали?

Так, за записаними партіями й точною граничною датою. У перевіреному прикладі запис партії в Cascadia від 2026-11-08 і виключення ігор, зіграних 2026-11-01 або пізніше, прибирають її з наступної добірки. Незареєстровані партії залишаються невідомими, а діапазони читання мають охоплювати потрібну історію.

Що станеться, якщо жодна гра з колекції не підходить компанії?

Помічник має пояснити, які записані обмеження виключають кандидатів, і запитати, що ви хочете змінити. Він не повинен вигадувати кількість гравців, непомітно збільшувати часовий бюджет чи підставляти гру, якої ви не маєте.

Чи можуть ChatGPT або Claude допомогти з налаштуванням?

Підключення для керування обліковим записом Quickchat AI може підготувати промпт агента й HTTP-дії з набору. Авторизувати Google, внести свою колекцію та перевірити справжню таблицю все одно потрібно вам. Підготовка конфігурації не запускає тестів і не публікує агента.

Quickchat AI Quickchat AI Ask Quickchat AI a question