Создайте помощника для выбора настольных игр из своей коллекции

Piotr Grudzień
Опубликовано Время чтения: 10 мин
Коллекция 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 с возможностью авторизовать подключение Sheets и несколько игр для каталога. Аккаунт 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: доступ через виджет и встраивание отключён, для Chat Page Access выбрано Nobody Настройте оба ограничения доступа до подключения коллекции. В руководстве используется AI Preview в панели управления.

В руководстве по подключению Google Sheets показаны экраны авторизации. Не добавляйте личные комментарии BGG и посторонние сведения о коллекции в этот небольшой демонстрационный файл.

Шаг 3: как получить рекомендацию из своей коллекции?

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

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

Откройте Actions & MCPs → Add Action → API Action → 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-01Cascadia исключена после записи партии

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

Когда проверки пройдены, замените примеры своей коллекцией. В следующий раз, когда компания соберётся за столом, сообщите Shelf Night число игроков, время и настроение, выберите из предложенных вариантов и запишите партию после завершения. Каждый записанный вечер добавляет немного контекста для следующего выбора.

Ещё один проект на основе коллекции, помощник по бэклогу Steam, использует ту же идею с записанным временем игры и личными заметками. Руководство по конструктору API-действий объясняет, как адаптировать этот подход к другим источникам данных.

Частые вопросы

Может ли помощник рекомендовать только те настольные игры, которые у меня есть?

Да. Перед рекомендацией эта конфигурация читает вкладку Collection и требует, чтобы значение owned было TRUE. Она проверяет записанные ограничения по числу игроков и ваш запас времени, затем объясняет каждый подходящий вариант. Поддерживайте сведения о владении и изданиях в актуальном состоянии.

Можно ли использовать свою коллекцию 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