Un asistent de recomandări pentru propria colecție de jocuri de societate verifică jocurile pe care le deții în raport cu numărul de jucători din această seară, timpul disponibil și preferințele tale. Shelf Night citește colecția din Google Sheets, înregistrează o partidă încheiată după confirmare și folosește jurnalul pentru a evita repetările recente.
Sunteți patru la masă, aveți o oră de joacă, iar pe raft se află Azul și Cascadia. Prima listă scurtă le include pe amândouă. După înregistrarea unei partide de Cascadia, următoarea întrebare o exclude și rămâne Azul.
Rezultatul urmărit: Cascadia este înregistrată în jurnal, iar Shelf Night recomandă Azul când îi ceri să evite repetările recente.
Capturile Google Sheets arată fișierul nostru de test conectat. Capturile Quickchat AI folosesc aplicația locală pentru a afișa răspunsurile și rezultatele Actions înregistrate de agentul nostru de test activ.
Vei construi mai întâi citirea colecției, apoi vei adăuga înregistrarea partidelor după confirmare și verificarea partidelor recente. Vei verifica atât rândul salvat, cât și răspunsul.
Descarcă pachetul de pornire Shelf Night. Conține două fișiere pentru foi de calcul cu valori separate prin tabulatori, instrucțiunile complete, trei configurații de acțiuni și o listă de verificări pentru testare. Sunt fișiere de referință editabile, nu un import automat al agentului. Capturile de ecran și setările care pot fi copiate folosesc etichetele interfeței în engleză.
Urmează pașii pentru a pregăti colecția, conecta foaia de calcul, obține o recomandare, înregistra o partidă și evita repetările.
Ce va ști asistentul tău pentru seara de jocuri?
Shelf Night combină informațiile înregistrate despre jocuri cu preferințele celor din gospodăria ta. Foaia le păstrează pe ambele, în coloane separate, astfel încât asistentul să poată explica pe ce se bazează o recomandare.
Deținerea jocului, numărul de jucători și timpul planificat elimină fiecare un alt tip de sugestie nepotrivită.
Exemplul folosește două jocuri de bază reale și două cazuri-limită intenționate. Editorii indică Azul pentru 2–4 jucători și Cascadia pentru 1–4 jucători. Gospodăria noastră fictivă alocă 60 de minute pentru oricare dintre ele, inclusiv pregătirea și explicarea regulilor. Aceasta este estimarea noastră, nu o garanție de durată din partea editorului.
Verifică ediția de pe raftul tău. Imagini de produs: Next Move Games / Asmodee și Alderac Entertainment Group / Flatout Games. Duratele publicate de editori și timpul planificat de grupul tău sunt valori separate.
Ai nevoie de un cont Quickchat AI, un cont Google care poate autoriza conexiunea Sheets și câteva jocuri de catalogat. Un cont BoardGameGeek este opțional. Verifică limitele actuale de credite AI și acțiuni ale contului tău; conversațiile și Simulation Testing consumă credite.
Pasul 1: Cum îți pregătești colecția de jocuri de societate?
Începe cu o colecție mică, pe care o poți verifica vizual. Înregistrează un ID stabil, dacă deții jocul, intervalul de jucători și timpul alocat fiecărui joc înainte să ceri asistentului să aleagă.
- Deschide
Collection.tsvdin pachet. Păstrează numele și ordinea antetelor. Înlocuiește rândurile de exemplu cu ale tale mai târziu, după ce primul test funcționează. - Atribuie fiecărei cutii un
game_idstabil, precumSHELF-001. Include ediția sau extensia în titlu când influențează regulile. Nu trata o extensie ca pe un joc de sine stătător. - Copiază numărul de jucători de pe cutie, din regulament sau de la editor. Setează
planning_minutesla timpul necesar grupului tău, inclusiv explicarea regulilor. Lasă necompletate valorile neverificate. - Alege propriile etichete
complexity, precumlightsaumedium. Înregistrează explicit dacă deții jocul. O intrare de pe lista de dorințe ar trebui să aibăownedsetat laFALSE.
| Joc de exemplu | Jucători | Timp planificat | Deținut | Ce ilustrează |
|---|---|---|---|---|
Azul, SHELF-001 | 2–4 | 60 de minute | TRUE | Un candidat cu date complete |
Cascadia (joc de bază), SHELF-002 | 1–4 | 60 de minute | TRUE | Un candidat pe care îl vom înregistra și exclude ulterior |
Exemplu de pe lista de dorințe, SHELF-003 | 2–4 | 45 de minute | FALSE | Un joc potrivit poate să nu fie deținut |
Joc de călătorie necatalogat, SHELF-004 | Minimum 2; maximum necunoscut | Necunoscut | TRUE | Informațiile lipsă trebuie să rămână necunoscute |
Colecția inițială are doi candidați cu date complete, un joc pe care nu îl deții și o înregistrare incompletă. Motivul fiecărei excluderi este vizibil în datele-sursă.
Coloanele rămase sunt source_url, last_played și language_note. Păstrează linkul sursei când este disponibil, folosește notele despre limbă pentru ediția ta și lasă o formulă să completeze last_played la pasul 5. Faptul că deții un joc nu garantează că ai cutia acasă: spune-i asistentului să excludă tot ce ai împrumutat altora.
Poți începe cu un export al colecției BoardGameGeek?
Da. Autentifică-te în propriul cont BGG, deschide colecția și folosește opțiunea de descărcare pentru jocurile deținute. Păstrează separat fișierul CSV brut, verifică antetele sale reale, apoi transferă valorile relevante în acest șablon. Completează numerele de jucători sau estimările de timp lipsă pe baza propriei ediții, în loc să ceri modelului să le ghicească.
Condițiile oficiale de acces BGG fac distincția între descărcarea propriei colecții în timpul autentificării și accesul API automatizat, cu înregistrare. Această configurație folosește un export manual sau introducerea manuală. Nu necesită o conexiune API BGG și nu sincronizează modificările din BGG.
Pasul 2: Cum conectezi Google Sheets la asistent?
Folosește foaia de calcul creată prin conexiunea Google Sheets din Quickchat AI. Permisiunea sa de acces la fișier nu se extinde automat la orice foaie de calcul existentă deja în Drive.
- Creează un cont Quickchat AI. Folosește agentul inițial sau alege Add new AI Agent → Set up manually. Numește-l Shelf Night.
- Deschide Your Website → Install → Availability and access. Dezactivează Widget & Embed access și setează Chat Page Access → Nobody. Păstrează această primă versiune în mediul AI Preview, accesibil după autentificare.
- Deschide Actions & MCPs → Add Action → Google Sheets și finalizează autorizarea Google. Integrarea solicită permisiunea limitată
drive.fileși creează o foaie de calcul cu o filă Leads. - Dezactivează acțiunea generată
log_lead_to_google_sheetcât timp o adaptezi. Păstrează-i numele, astfel încât conexiunea să o poată recunoaște în continuare. Alege Open sheet și redenumește fișierul Shelf Night. - Redenumește Leads în Plays, înlocuiește antetele vechi lipind
Plays.tsvîn A1, apoi adaugă o filă Collection. Păstrează cel puțin 501 rânduri în Plays și 101 în Collection. - În File → Settings, alege setarea regională United States pentru formulele din pachet, care folosesc virgule ca separatori. Formatează coloana A din Plays ca Plain text înainte de a introduce date calendaristice. Lipește
Collection.tsvîn Collection!A1, permițând calcularea formulelor din coloana I. Blochează fiecare rând de antet și aplică-i caractere aldine; lărgește coloanele sau activează încadrarea textului pentru ca valorile să fie lizibile.
Vizualizările compacte din acest articol ascund temporar coloanele C:F, H și J, astfel încât jocul, deținerea și data ultimei partide să rămână lizibile. Fila Collection de bază, cu zece coloane, și intervalul A:J al acțiunii rămân neschimbate.
Configurează ambele controale de acces înainte de a conecta colecția. Tutorialul folosește AI Preview din panoul de administrare.
Ghidul de conectare Google Sheets prezintă ecranele de autorizare. Nu include comentarii personale BGG sau date nerelevante despre colecție în acest mic fișier demonstrativ.
Pasul 3: Cum obții o recomandare din propria colecție?
Adaugă o acțiune doar pentru citire și oferă agentului reguli pentru folosirea răspunsului. Este suficient pentru prima listă scurtă utilă; acțiunea de înregistrare poate rămâne dezactivată.
Citește colecția
Deschide Actions & MCPs → Add Action → API Action → Create manually. Numește acțiunea Read Shelf Night collection, setează When to run → AI decides și introdu:
GET https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Collection!A1:J101
Headers
Authorization: Bearer {{google_sheets_access_token}}
Înlocuiește YOUR_CREATED_SHEET_ID cu ID-ul existent deja în URL-ul acțiunii inițiale dezactivate. Folosește tokenul integrat Google Sheets din Add AI Data → System Tokens; păstrează-l ca variabilă, nu lipi un token de acces. Păstrează fixe ID-ul fișierului și intervalul, fără parametri de intrare, fără corp de cerere și fără parametri de interogare. Lasă Response filter necompletat.
Folosește această descriere în 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.
Citește împreună antetul și rândurile colecției. Nu permite conversației să controleze foaia de calcul și intervalul.
Salvează și activează acțiunea. Rulează Test Response și compară values cu foaia. Endpointul values.get de la Google returnează implicit valorile formatate ale celulelor; numerele și valorile booleene pot sosi ca șiruri de caractere, iar celulele goale de la final pot fi omise. Un rând scurt nu este o permisiune de a inventa valorile lipsă.
Oferă-i asistentului Shelf Night regulile sale
Deschide Identity → Main Prompt, lipește main-prompt.txt din pachet și salvează. Regula de selecție este precisă: citește din nou colecția, impune deținerea jocului și constrângeri complete, returnează cel mult trei potriviri și explică orice informație lipsă.
Main Prompt explică modul de alegere. Aceste două decupaje arată locația și instrucțiunile introductive; acțiunea furnizează colecția actuală.
În AI Preview, întreabă:
Four players, 60 minutes, something light. What do we own that fits?
Primul răspuns util: Azul și Cascadia respectă condițiile înregistrate privind deținerea, numărul de jucători și timpul.
Cu datele de exemplu, Azul și Cascadia se califică. Rândul listei de dorințe nu îndeplinește condiția de deținere; jocul de călătorie nu are suficiente informații. Deschide conversația salvată în Inbox, extinde apelul acțiunii și verifică valorile returnate. Folosește View logs de pe cardul acțiunii pentru înregistrarea completă a cererii.
Compară răspunsul cu datele pe care se bazează. Un marcaj de acțiune îți spune că a avut loc un apel; rezultatul său îți spune ce a primit efectiv asistentul.
Lasă ChatGPT sau Claude să pregătească setările
Conexiunea de administrare a contului Quickchat AI poate pregăti Main Prompt și acțiunile HTTP. Conectează-te prin pagina oficială ChatGPT sau pagina oficială Claude, urmând ghidul de administrare a contului. Atașează pachetul și trimite:
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.
Tot tu trebuie să autorizezi Google, să completezi foaia și să verifici rândurile reale. Pregătirea setărilor printr-un asistent nu finalizează acești pași.
Pasul 4: Cum înregistrezi o partidă încheiată?
Păstrează câte un rând pentru fiecare partidă încheiată și solicită confirmarea înainte de adăugare. O sugestie de Cascadia nu ar trebui niciodată să conteze ca o partidă de Cascadia.
Data și ID-ul jocului leagă o partidă încheiată de următoarea listă scurtă.
Adaugă o acțiune de citire pentru jurnalul partidelor
Creează o a doua acțiune numită Read Shelf Night plays, cu aceleași setări GET și același antet cu token ca prima, schimbând intervalul în:
https://sheets.googleapis.com/v4/spreadsheets/YOUR_CREATED_SHEET_ID/values/Plays!A1:E501
Setează descrierea astfel:
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.
Salveaz-o și activeaz-o. Chiar și un jurnal gol ar trebui să returneze antetul: played_date, game_id, players, duration_minutes, note.
Adaptează acțiunea inițială pentru a adăuga o partidă
Editează acțiunea inițială dezactivată, păstrând numele log_lead_to_google_sheet. Înlocuiește vechii parametri pentru clienți potențiali, corpul cererii, descrierea și mesajul afișat în timpul procesării. Numele moștenit este doar un identificator; această acțiune va înregistra acum partide.
În What to ask the user first, adaugă:
Copiază parametrii partidei și cererea de adăugare
| Parametru | Tip | Obligatoriu | Descriere |
|---|---|---|---|
played_date | Text | Da | Data exactă confirmată, în format YYYY-MM-DD. Întreabă în loc să ghicești o dată relativă. |
game_id | Text | Da | ID-ul exact returnat de Collection și confirmat de gazdă. |
players | Number | Da | Numărul confirmat de persoane care au jucat. |
duration_minutes | Number | Da | Durata efectivă confirmată, nu timpul planificat. |
note | Text | Nu | Notă factuală opțională furnizată de gazdă. Goală când este omisă. |
Pentru note, alege Default value → Empty value. Folosește AI decides și lasă Response filter necompletat. Setează cererea și Query Params astfel:
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
În Body, păstrează modul JSON activat și înlocuiește vechiul corp al cererii din acțiunea inițială cu:
{"values":[["{{played_date}}","{{game_id}}","{{players}}","{{duration_minutes}}","{{note}}"]]}
Ordinea valorilor trebuie să corespundă celor cinci coloane. RAW stochează textul exact cum este furnizat, astfel încât o notă care începe cu = să nu devină formulă. Endpointul append găsește următorul rând după tabel; OVERWRITE completează acel rând gol existent, păstrând formatarea și intervalul formulei pentru ultima partidă. Documentația append de la Google explică opțiunile. Păstrează Plays ca un singur jurnal continuu, fără alt tabel alături.
Copiază descrierea pentru adăugare din action-recipes.json. Aceasta cere o confirmare separată, o verificare a duplicatelor, o singură adăugare și o citire ulterioară. Setează mesajul din timpul procesării la Recording the confirmed play..., salvează și activează acțiunea. Test Response pentru acest POST poate adăuga un rând real.
Joacă, raportează, confirmă
Trimite acest mesaj în AI Preview:
We played Cascadia on 2026-11-08 with four people for 52 minutes. No note. Please log it.
Asistentul ar trebui să afișeze câmpurile propuse și să aștepte. Verificați că Plays a rămas neschimbat înainte de a confirma.
Shelf Night cere confirmare. Fila Plays reală conține încă doar antetul.
Răspunde „Confirm.” Verifică dacă rezultatul adăugării conține updates.updatedRows: 1 și câmpul updatedRange, apoi verifică citirea ulterioară. Foaia de calcul propriu-zisă ar trebui să conțină 2026-11-08, SHELF-002, 4, 52 și o notă goală.
Partida confirmată apare o singură dată în Plays, sub aceleași cinci antete. Agentul a recitit jurnalul înainte de a anunța succesul.
Operația append a returnat un rând actualizat. Intervalul returnat corespunde rândului completat afișat în Google Sheets.
Confirmarea și verificarea duplicatelor sunt instrucțiuni pentru agent, nu o constrângere atomică a bazei de date. Dacă o cerere expiră, verifică jurnalul înainte de a reîncerca. Două conversații simultane pot totuși adăuga aceeași raportare; acest mic jurnal personal nu implementează un sistem de rezervare sau un mecanism de blocare a tranzacțiilor.
Pasul 5: Cum eviți jocurile jucate recent?
Citește istoricul partidelor folosind o dată-limită explicită. În exemplu, excluderea jocurilor jucate începând cu 2026-11-01 elimină Cascadia și păstrează Azul.
Pachetul adaugă și o formulă pentru ultima partidă în Collection!I2 și o copiază în jos pe rândurile de exemplu:
=IFERROR(INDEX(SORT(FILTER(Plays!$A$2:$A$501,Plays!$B$2:$B$501=A2),1,FALSE),1),"")
Aceasta caută ID-ul stabil al jocului, sortează șirurile de date ISO cu lungime fixă în ordine descrescătoare și returnează cea mai recentă dată de joc înregistrată. Astfel, raportarea târzie a unei partide mai vechi nu o transformă în cea mai recentă partidă. Dacă nu există o partidă corespunzătoare, celula rămâne goală.
După înregistrarea partidei de Cascadia, verifică dacă Collection!I3 afișează 2026-11-08. Dacă formula apare ca text, restabilește formatarea automată pentru acea celulă și introdu-o din nou. Păstrează datele din Plays ca text simplu și verifică setarea regională și numele exacte ale filelor dacă formula dă eroare. Google documentează funcția FILTER folosită pentru selectarea rândurilor corespunzătoare.
Collection!I3 calculează ultima partidă de Cascadia înregistrată în Plays. Celula selectată arată atât formula, cât și rezultatul ei, 2026-11-08.
Începe o conversație nouă și întreabă:
Four players, 60 minutes, light. Exclude games recorded on or after 2026-11-01.
Noua întrebare exclude partida de Cascadia înregistrată și returnează Azul. O celulă last_played goală înseamnă că nu există o partidă înregistrată în acest jurnal.
Intervalele inițiale de citire acoperă 100 de jocuri și 500 de partide, fără antete. Pe măsură ce fișierul crește, aliniază intervalele acțiunilor de citire și ale formulelor cu înregistrările reale. Păstrează opțiunea de adăugare insertDataOption: OVERWRITE, astfel încât un nou rând să nu mute începutul intervalului formulei dincolo de partida tocmai înregistrată.
Pasul 6: Cum verifici dacă recomandările se bazează pe date?
Testează cazurile în care colecția nu poate oferi un răspuns. Un asistent util ar trebui să explice limita și să te lase să decizi ce schimbi.
Cere un joc pentru șase jucători, 60 de minute, ușor. Niciunul dintre cele două rânduri complete cu jocuri deținute nu permite șase jucători, iar maximul jocului de călătorie este necunoscut. Asistentul nu ar trebui să preia numărul de jucători al extensiei pentru Cascadia sau să recomande ceva de pe lista de dorințe.
Un răspuns fără potriviri păstrează vizibile constrângerile inițiale. Adaugă un joc verificat pentru șase jucători sau schimbă planul serii.
Folosește Testing → Simulation Testing pentru verificări repetabile și analizează rezultatele acțiunilor alături de răspunsuri. Păstrează schimbul de confirmare într-o singură conversație, astfel încât „Confirm” să aprobe o propunere precisă.
Testele salvate ale colecției acoperă o recomandare obișnuită, șase jucători, un joc nedeținut și informații lipsă. Verifică rezultatele Actions corespunzătoare împreună cu scorurile.
| Încearcă asta | Verifică asta |
|---|---|
| Patru jucători, 60 de minute, ușor | Doar Azul și Cascadia, cu motive bazate pe datele înregistrate |
| Șase jucători | Nicio potrivire verificată; nicio capacitate inventată |
| Recomandă exemplul de pe lista de dorințe | Excluderea pe baza deținerii rămâne în vigoare |
| Cât durează jocul de călătorie? | Timpul lipsă rămâne necunoscut |
| Raportează o partidă, înainte de confirmare | Niciun rând nou în Plays |
| Confirmă, apoi confirmă din nou | Un singur rând în acest test, fără o a doua adăugare |
| Exclude partidele începând cu 2026-11-01 | Cascadia exclus după înregistrarea partidei |
Cele patru verificări ale colecției au trecut în Simulation Testing. Am verificat și confirmarea separată, un singur rând adăugat, rezultatul formulei, o confirmare repetată fără altă adăugare și o nouă recomandare care a exclus Cascadia. Repetă lista de verificare din kit pe propriul fișier înainte de a înlocui rândurile de exemplu.
După ce aceste verificări reușesc, înlocuiește rândurile de exemplu cu propria colecție. Data viitoare când grupul se așază la masă, spune-i asistentului Shelf Night numărul de jucători, timpul și atmosfera dorită, alege dintre opțiunile returnate și înregistrează partida după ce terminați. Fiecare seară înregistrată oferă puțin mai mult context următoarei alegeri.
Pentru un alt proiect bazat pe o colecție, asistentul de alegere din lista Steam folosește aceeași idee cu timpul de joc înregistrat și note personale. Ghidul de creare a acțiunilor API explică modul de adaptare a acestui model la alte surse de date.
Întrebări frecvente
Poate un asistent să recomande doar jocuri de societate pe care le dețin?
Da. Această configurație citește fila Collection înainte de a recomanda și impune ca owned să fie TRUE. Verifică limitele înregistrate pentru jucători și timpul planificat, apoi explică fiecare potrivire. Menține actualizate informațiile despre jocurile deținute și ediții.
Pot folosi colecția mea BoardGameGeek fără o cheie API?
Da. Începe cu fișierul CSV al propriei colecții BGG, descărcat manual, sau introdu câteva jocuri în șablon. Verifică coloanele exportate și completează informațiile lipsă pe baza ediției tale. Acest flux nu apelează API-ul BGG și nu sincronizează automat colecția.
Există un șablon de foaie de calcul pentru colecția de jocuri de societate?
Pachetul de pornire Shelf Night include Collection.tsv, Plays.tsv, formule pentru ultima partidă, trei configurații de acțiuni, un Main Prompt și o listă de verificări pentru testare. Lipește conținutul fișierelor pentru cele două file în foaia de calcul creată prin conexiunea Google Sheets din Quickchat AI.
Estimarea timpului include explicarea regulilor și pregătirea jocului?
Coloana planning_minutes reprezintă timpul estimat de cei din gospodăria ta, așa că le poți include pe ambele. Exemplul alocă 60 de minute pentru Azul și Cascadia. Durata efectivă se trece în jurnal după partidă; este separată de estimarea pentru planificare.
Poate evita jocurile de societate pe care le-am jucat recent?
Da, folosind partidele înregistrate și o dată-limită exactă. În exemplul testat, înregistrarea Cascadia pe 2026-11-08 și excluderea jocurilor jucate pe 2026-11-01 sau ulterior o elimină din următoarea listă scurtă. Partidele neînregistrate rămân necunoscute, iar intervalele de citire trebuie să acopere istoricul relevant.
Ce se întâmplă când niciun joc deținut nu se potrivește grupului?
Asistentul ar trebui să explice ce limite înregistrate exclud candidații și să te întrebe ce vrei să schimbi. Nu ar trebui să inventeze un număr de jucători, să mărească pe ascuns timpul disponibil sau să propună în schimb un joc pe care nu îl deții.
Pot ChatGPT sau Claude să ajute la configurare?
Conexiunea de administrare a contului Quickchat AI poate pregăti instrucțiunile agentului și acțiunile HTTP din pachet. Tot tu trebuie să autorizezi Google, să introduci colecția și să verifici foaia de calcul reală. Pregătirea configurației nu rulează teste și nu publică agentul.