Apa yang Anda tulis saat menamatkan Pride and Prejudice? Dalam jurnal membaca ini, jawabannya adalah “I kept noticing who misunderstood whom.” (Aku terus memperhatikan siapa yang keliru memahami siapa). Kalimat itu milik edisi sampul lunak Penguin, ISBN 9780141439518, selesai dibaca pada 8 November. Kalimat itu tetap ada saat Anda membuka percakapan baru.
Anda akan membuat Shelf Notes, pelacak bacaan pribadi di Google Sheets. Open Library menyediakan detail edisinya, Anda menambahkan tanggal dan pemikiran yang ingin disimpan, lalu Agent Quickchat AI menaruh semuanya pada baris yang sama setelah Anda mengonfirmasi.
Unduh starter kit Shelf Notes. Buka Shelf Notes.xlsx untuk melihat contoh yang sudah jadi. Gunakan dua file TSV untuk membuat jurnal Anda sendiri di Google Sheets. Keduanya dimulai satu entri lebih awal, saat pembaca masih membaca. Kit ini juga memuat pengaturan Action yang persis sama dan Main Prompt.
1. Edisi mana yang ada di rak Anda?
Coba pencariannya sebelum Anda menghubungkan apa pun. Buka edisi untuk ISBN 9780141439518. Itu adalah edisi sampul lunak berbahasa Inggris setebal 435 halaman yang diterbitkan oleh Penguin Books pada 2003. Novel Jane Austen pertama kali terbit pada 1813. Kedua tanggal itu sama-sama milik Pride and Prejudice, tetapi hanya satu yang menjelaskan buku yang ada di meja.
- Buat akun atau masuk ke Quickchat AI. Gunakan Agent kosong Anda, atau pilih Add new AI Agent → Set up manually. Beri nama Shelf Notes. Anda akan memerlukan akun Google untuk jurnal ini dan kredit AI yang tersedia untuk menguji percakapan.
- Sebelum menambahkan catatan pribadi, buka Your Website → Install → Availability and access. Nonaktifkan Widget & Embed access, atur Chat Page Access ke Nobody, dan biarkan channel lain tetap tidak terhubung. Gunakan AI Preview di dashboard Anda saat sudah masuk.
- Di bagian Identity → Main Prompt, tempelkan
main-prompt.txtdari kit. Prompt ini memberi tahu Agent untuk menampilkan entri yang diusulkan dan menunggu konfirmasi terpisah. - Di Actions & MCPs → Add Action → API Action → Create manually, buat dua Action GET di bawah ini. Untuk masing-masing Action, gunakan When to run → AI decides, tambahkan satu parameter Text wajib bernama
isbndi bawah What to ask the user first, dan biarkan body kosong. Hapus spasi dan tanda hubung dari angkanya, pertahankan nol di depan danXfinal pada ISBN-10.
| Nama Action | Endpoint API | Yang digunakan dari hasilnya |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | Di Query Params, masukkan isbn={{isbn}}, fields=key,title,author_name,first_publish_year, dan limit=1. Data karya ini memberikan nama penulis dan tahun asli terbitnya novel tersebut. |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | Periksa bahwa nomor yang diberikan muncul di isbn_13 atau isbn_10. Baca penerbit, tanggal edisi, dan bahasa jika ada. Tambahkan key /books/ yang dikembalikan ke https://openlibrary.org untuk membuat tautan sumber. |
Ketik ISBN ke percakapan. Action memasukkannya ke URL dengan host yang sudah tetap di editor.
Pencarian pertama kami juga meminta daftar edisi karya tersebut. Untuk ISBN ini, hasilnya mengembalikan 4.042 ID edisi. Setelah kolom itu dihapus, respons singkatnya hanya berisi penulis dan tahun terbit asli. Permintaan kedua tetap mengembalikan satu edisi sampul lunak yang kami cari.
Di bawah Headers, beri setiap permintaan sebuah User-Agent bernilai ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), ganti kontak contoh dengan milik Anda. Tempel API Action Description yang sesuai dari action-recipes.md, simpan, lalu aktifkan setiap Action. Coba “Look up ISBN 978-0-14-143951-8.”. Anda seharusnya melihat edisinya tanpa membuat entri jurnal. Pencarian pribadi ini tidak memerlukan akun Open Library. Gunakan saat seseorang bertanya tentang buku, dan ikuti panduan penggunaan API milik Open Library.
2. Apa yang perlu masuk ke jurnal membaca?
Pisahkan fakta katalog dan pengamatan Anda sendiri ke kolom yang berbeda. Anda mungkin meminjamkan edisi persis ini kepada seseorang dan berbeda pendapat tentang setiap karakter. ISBN-nya tetap sama. Catatan Anda termasuk dalam pengalaman membaca Anda, yang di sini diidentifikasi sebagai PAP-01.
- Buka Actions & MCPs → Add Action → Google Sheets → Connect. Otorisasikan akun Google yang akan memiliki jurnal ini, lalu pilih Open sheet. Koneksi ini membuat Google Spreadsheet di Drive dalam cakupan izin
drive.file. Panduan koneksi Google Sheets menampilkan layar otorisasi. Untuk jurnal pribadi, buka Bagikan di Google Sheets dan biarkan Akses umum tetap Dibatasi. - Nonaktifkan Action starter yang sedang aktif,
log_lead_to_google_sheet. Pertahankan namanya dan salin API Endpoint-nya dengan file ID yang sudah terisi. Biarkan Action starter tetap nonaktif. Anda akan membuat Action terpisah untuk jurnal ini.
Buka file yang dibuat untuk Agent ini. Action starter sudah berisi spreadsheet ID yang Anda perlukan.
- Ganti nama tab Leads menjadi Events dan ganti isinya dengan
Events.tsv, mulai dari A1. Format kolom B (ISBN) dan F (date) sebagai Plain text sebelum menempelkan data. Tambahkan tab kedua bernama Status. Di sheet contoh yang baru, gunakan File → Settings → Locale → United States agar rumus di bawah ini menerima koma.
Mulailah dari baris 2. PAP-01 masih dibaca, dengan “Started with the Netherfield visit.” di G2. Setelah Anda mengonfirmasi, entri yang selesai akan muncul di baris 3.
Delapan kolom Events, berurutan, adalah reading_id, isbn, title, edition_url, status, reading_date, note, dan conversation. Sel terakhir berisi tautan kembali ke percakapan. Event pertama dari starter berstatus reading pada 2 November. Catatannya adalah “Started with the Netherfield visit.”
Pertahankan satu reading ID saat sebuah buku berpindah dari reading ke finished. Pilih yang baru saat Anda kembali ke buku itu untuk membacanya ulang.
3. Bagaimana cara menyimpan catatan bacaan berdasarkan ISBN?
Pencarian menjawab “Buku yang mana?”. Penyimpanan menjawab pertanyaan lain, “Apakah ini yang ingin saya ingat?”. Siapkan satu Action untuk menambahkan baris yang sudah dikonfirmasi dan satu lagi untuk memeriksa apa yang benar-benar ada di spreadsheet.
- Buat sebuah API Action bernama
append_reading_event. Salin URL Sheets dari starter, pertahankan semuanya sampai file ID yang sebenarnya. Ganti sisanya dengan/values/Events!A:H:append. Atur ke POST dan tambahkan entri Query ParamsvalueInputOption=RAW. Mode input mentah mempertahankan ISBN dan memperlakukan catatan yang diawali=sebagai teks. - Di Headers, atur
AuthorizationmenjadiBearer {{google_sheets_access_token}}danContent-Typemenjadiapplication/json. Quickchat AI akan mengisi token saat permintaan dijalankan. - Tambahkan enam parameter Text wajib bernama
reading_id,isbn,title,edition_url,status, danreading_date. Tambahkan satu parameter Text opsional bernamanotedengan default kosong. Pilihreading,finished,paused, atauabandoneduntuk status. Gunakan tanggal pembaca dalam formatYYYY-MM-DD. - Di API Endpoint → Body, tempel JSON di bawah ini. Dua set tanda kurung berarti satu baris dengan delapan sel.
conversation_urlsudah tersedia secara bawaan. Tempel deskripsi append dari kit ke API Action Description. - Buat
read_reading_journalsebagai GET ke spreadsheet yang sama, dengan akhiran/values/Events!A2:H1000. Beri header bearer yang sama, deskripsi riwayat dari kit, tanpa parameter, dan body kosong. Simpan lalu aktifkan kedua Action.
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
Array ini sejajar dengan kolom A sampai H. Jika catatan diletakkan di posisi ketujuh, kata-kata pembaca akan masuk ke kolom G.
Setelah baris awal siap, kirim pesan berikut di AI Preview.
Look up ISBN 978-0-14-143951-8. I finished PAP-01 on 2026-11-08. My note: I kept noticing who misunderstood whom.
Periksa edisi, ID, tanggal, dan tanda bacanya yang diusulkan. Pada tahap ini Events seharusnya masih hanya berisi entri pembuka. Lalu katakan “Yes, that is my edition. Save PAP-01 with that status, date and note.” event kedua akan muncul di baris 3.
Usulan ini memberi Anda satu kesempatan terakhir untuk melihat ISBN dan susunan kata Anda. Anda bisa memperbaiki salah satunya sebelum jurnal berubah.
Dalam uji langsung kami, usulan entri jurnal tidak mengubah baris awal. Setelah konfirmasi, Shelf Notes memeriksa jurnal, memeriksa ulang ISBN, menambahkan satu baris, lalu membaca kembali baris baru itu. Di Inbox, buka append_reading_event dan bandingkan updates.updatedRange dari Google dengan sel di sheet Anda. Jika permintaan kehabisan waktu, cari barisnya sebelum mencoba lagi. Referensi penambahan baris Google Sheets
Google melaporkan satu baris dan delapan sel diperbarui di Events!A3:H3. Pilih G3 untuk membandingkan teksnya dengan catatan yang Anda setujui.
4. Apa yang bisa Anda tanyakan dalam percakapan baru?
Buka percakapan baru di AI Preview lalu tanyakan “What was the last note I saved for PAP-01?” Dalam uji kami, Agent membaca Events lagi dan mengembalikan “I kept noticing who misunderstood whom.” Baris 2 masih menyimpan catatan Netherfield sebelumnya. Google dapat mengabaikan sel kosong di bagian akhir baris yang dikembalikan, jadi tautan percakapan yang kosong pada baris awal Anda adalah hal yang wajar.
Untuk “Which books am I still reading?”, dua event untuk satu reading ID akan memberi jawaban yang menyesatkan jika Anda menghitung setiap baris. Gunakan tab Status untuk memilih event terakhir yang ditambahkan untuk setiap reading ID.
- Tempelkan
Status.tsvke Status!A1. Rumus di A2 mencantumkan setiap reading ID satu kali. B2 memakai pencarian exact-match yang dimulai dari bagian bawah Events. Isi B2 ke bawah mengikuti ID baru saat rak buku Anda bertambah. D2 menghitung ID yang status terbarunya adalahfinished. - Buat
read_reading_status, satu lagi GET dengan header bearer yang sama, menggunakan akhiran/values/Status!A1:B1000. Tempel deskripsi status dari kit, biarkan body dan parameter kosong, lalu simpan dan aktifkan. - Tanyakan buku mana yang sudah selesai dibaca. Untuk sampel ini, Status memiliki satu bacaan yang selesai,
PAP-01. Untuk pembacaan kedua novel itu, beri IDPAP-02. Dengan begitu Anda bisa membedakan apa yang Anda perhatikan pada pembacaan pertama dan kedua.
Salin tiga rumus Google Sheets berikut
Status!A2 mencantumkan ID.
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2 mencari peristiwa terbaru untuk ID di kolom A.
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2 menghitung bacaan yang selesai.
=COUNTIF(B2:B1000,"finished")
Susunan ini mencakup 999 event. Sebelum entri baru masuk di bawah baris 1000, perluas rentang baca dan rentang rumus secara bersamaan. Ingat catatan yang panjang dan koleksi yang besar saat menentukan berapa banyak riwayat yang dikembalikan dalam satu percakapan. Referensi XLOOKUP Google Sheets
5. Apakah ini berfungsi dengan buku di meja Anda?
Ambil buku lain dan coba ISBN yang tercetak di sana. Minta edisinya, lalu berhenti. Pemeriksaan awal yang bagus adalah memastikan Anda bisa melihat sebuah buku tanpa menambahkannya. Berikutnya, beri ID bacaan dan satu kalimat yang hanya mungkin Anda tulis sendiri. Konfirmasikan, tutup percakapan, lalu minta kalimat itu kembali.
Untuk pemeriksaan yang bisa diulang, gunakan Testing → Simulation, lalu periksa Actions & MCPs → View logs dan sel tujuan. Coba ISBN yang tidak dikenali, tolak entri yang diusulkan, lalu simpan catatan uji yang diawali dengan =1+1. Dua yang pertama seharusnya tidak mengubah riwayat. Yang terakhir seharusnya menampilkan karakter literal itu di sel catatan.
Kami juga membuat sheet lokal menyimpan satu baris lalu kehabisan waktu sebelum memberi balasan. Shelf Notes membaca kembali baris itu, melaporkan time out, dan tidak melakukan penambahan kedua. Anda bisa memeriksa detail yang sama di log Action jika suatu saat penyimpanan membuat Anda ragu apakah perlu menekan kirim lagi.
Dalam uji edisi yang tidak ditemukan, katalog mengembalikan 404. Agen meminta pengenal lain dan jurnal tetap berisi dua baris.
Jika Anda lebih suka mengonfigurasi Agent dari asisten lain, kit ini menyertakan permintaan penyiapan untuk konektor akun Quickchat AI. Lampirkan action-recipes.md dan main-prompt.txt, lalu berikan setup-request.txt. Tinjau kelima Action, selesaikan otorisasi Google sendiri, lalu jalankan pengujian pembacaan yang sama. Konektor ChatGPT · Konektor Claude · Panduan penyiapan akun
Pertanyaan yang sering diajukan
Bagaimana cara menambahkan buku ke Google Sheets dengan ISBN?
Gunakan ISBN yang tercetak pada buku Anda untuk mencari edisinya di Open Library. Periksa judul, penerbit, dan tahunnya, tambahkan status bacaan serta catatan Anda, lalu konfirmasikan barisnya. Starter kit ini sudah menyertakan header sheet, rumus, dan kelima resep Action dari Quickchat AI.
Bisakah saya memakai pelacak bacaan yang sudah saya punya di Google Sheets?
Salin entri yang Anda inginkan ke tab Events di spreadsheet yang dibuat oleh koneksi Quickchat AI. Cocokkan kedelapan kolomnya dan simpan ISBN sebagai teks. Menempelkan ID file pribadi lain ke dalam Action tidak memberinya izin untuk membuka file itu.
Bagaimana jika Open Library tidak dapat menemukan ISBN saya?
Periksa nomor pada barcode atau halaman hak cipta, termasuk angka nol di depan atau X di akhir. Jika edisinya tetap tidak bisa diverifikasi, biarkan jurnal apa adanya. ISBN mengidentifikasi sebuah edisi dan tidak memberi akses ke teks lengkap buku.
Bagaimana cara menghitung buku yang selesai dibaca dan mencatat baca ulang?
Beri setiap bacaan ID-nya sendiri. Pertahankan ID itu saat Anda berhenti sejenak atau menamatkan buku, lalu beri baca ulang ID baru. Hitung entri yang selesai pada tab Status. Dengan begitu, dua bacaan selesai untuk edisi yang sama dihitung dua kali, sedangkan dua pembaruan untuk satu bacaan dihitung satu kali.
Bisakah saya menemukan catatan bacaan setelah menutup chat?
Ya. Tanyakan buku itu atau ID bacaannya dalam percakapan pribadi yang baru. Action riwayat akan membaca ulang tab Events, tempat entri bertanggal dan redaksi asli Anda disimpan. Tab Status menyediakan status terbaru yang tercatat untuk setiap bacaan.