你讀完 Pride and Prejudice 時寫了什麼?在這份閱讀日誌裡,答案是 「I kept noticing who misunderstood whom.」(我總會留意到,是誰又誤會了誰)。它屬於 Penguin 的平裝版,ISBN 為 9780141439518,於 11 月 8 日讀完。當你開啟新的對話時,這句話還在。
你將建立 Shelf Notes,一份放在 Google 試算表中的私人閱讀紀錄。Open Library 提供版本細節,你提供日期和想保留的感想,接著由 Quickchat AI Agent 在你確認後把它們寫到同一列。
下載 Shelf Notes 入門套件。開啟 Shelf Notes.xlsx 即可查看完成範例。使用兩個 TSV 檔案,在 Google 試算表中建立你自己的閱讀日誌。它們會從更早的一筆條目開始,也就是讀者仍在閱讀中的時點。套件也包含完全相同的 Action 設定與 Main Prompt。
1. 你書架上的是哪一個版本?
開始連線前,先試試查詢。開啟 ISBN 9780141439518 對應的版本。這是一本 由 Penguin Books 於 2003 年出版、共 435 頁的英文平裝本。珍·奧斯汀的這部小說最早於 1813 年問世。這兩個日期都屬於 Pride and Prejudice,但只有一個描述的是你桌上的那本書。
- 註冊或登入 Quickchat AI。使用你的空白 Agent,或選擇 Add new AI Agent → Set up manually。將它命名為 Shelf Notes。你需要一個 Google 帳戶來建立閱讀日誌,也需要可用的 AI 點數來測試對話。
- 在加入個人筆記之前,先開啟 Your Website → Install → Availability and access。關閉 Widget & Embed access,把 Chat Page Access 設為 Nobody,並讓其他管道維持未連接狀態。在你已登入的控制台中使用 AI Preview。
- 在 Identity → Main Prompt 下方,貼上套件中的
main-prompt.txt。它會指示 Agent 先顯示提議加入的條目,並等待另一則獨立的確認訊息。 - 在 Actions & MCPs → Add Action → API Action → Create manually 中,建立下面兩個 GET Action。每個都使用 When to run → AI decides,在 What to ask the user first 底下新增一個必填的 Text 參數,名稱為
isbn,並將 body 留空。請移除號碼中的空格與連字號,保留前導零,以及 ISBN-10 結尾的X。
| Action 名稱 | API 端點 | 結果中要使用的資料 |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | 在 Query Params 中輸入 isbn={{isbn}}、fields=key,title,author_name,first_publish_year 和 limit=1。這筆作品資料會提供作者與小說的首次出版年份。 |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | 確認提供的號碼有出現在 isbn_13 或 isbn_10。如有提供,請讀取出版社、版本出版日期與語言。把回傳的 /books/ 鍵值接到 https://openlibrary.org 後面,作為來源連結。 |
把 ISBN 輸入對話中。Action 會將它帶入 URL,而主機名稱已固定在編輯器裡。
我們第一次查詢時,也要求回傳這部作品的版本清單。這一個 ISBN 就帶回了 4,042 個版本 ID。拿掉那個欄位後,回應就縮短成只剩作者和首次出版年份。第二次請求仍然只回傳了我們要的那一本平裝本。
在 Headers 下,為每個請求設定一個 User-Agent,值為 ShelfNotes/1.0 (YOUR_CONTACT_EMAIL),並將範例聯絡方式替換成你的。貼上來自 action-recipes.md 的對應 API Action Description,儲存後啟用每個 Action。試試 「Look up ISBN 978-0-14-143951-8.」。你應該會看到該版本資料,而不需要建立閱讀紀錄。這個個人查詢不需要 Open Library 帳號。當有人詢問某本書時可以使用它,並遵循Open Library 的 API 使用規範。
2. 閱讀日誌裡該放哪些內容?
請把書目事實與你自己的觀察分成不同欄位。你可能會把這個確切版本借給別人,而你們對每個角色的看法都不同,但 ISBN 還是一樣。你的筆記屬於你的這次閱讀,這裡以 PAP-01 識別。
- 開啟 Actions & MCPs → Add Action → Google Sheets → Connect。授權將擁有這份閱讀日誌的 Google 帳號,然後選擇 Open sheet。這個連線會依照它的
drive.file授權,在 Drive 中建立一份試算表。Google 試算表連線教學 會展示授權畫面。如果是個人閱讀日誌,請在 Google 試算表中開啟共用,將一般存取權維持在限制。 - 先關閉目前啟用中的起始 Action,也就是
log_lead_to_google_sheet。保留它的名稱,並複製已經填入檔案 ID 的 API Endpoint。讓這個起始 Action 維持關閉狀態。你會為這份閱讀日誌另外建立獨立的 Actions。
開啟為這個 Agent 建立的檔案。起始 Action 已經包含你需要的試算表 ID。
- 將 Leads 分頁重新命名為 Events,並從 A1 開始用
Events.tsv取代原有內容。貼上前,先把 B(ISBN)與 F(date)兩欄格式設為 Plain text。再新增第二個分頁,名稱為 Status。如果你是用新的範例試算表,請設定 File → Settings → Locale → United States,讓下面的公式能接受逗號。
從第 2 列開始。PAP-01 仍在閱讀中,G2 有 “Started with the Netherfield visit.”。你確認後,完成項目會出現在第 3 列。
Events 的八個欄位依序是 reading_id、isbn、title、edition_url、status、reading_date、note 和 conversation。最後一格放的是回到該對話的連結。起始資料的第一筆事件在 11 月 2 日標記為 reading。它的備註是「Started with the Netherfield visit.」
一本書從 reading 變成 finished 的過程中,請維持同一個 reading ID。若之後重讀這本書,再改用新的 ID。
3. 要怎麼用 ISBN 儲存閱讀筆記?
查詢回答的是「是哪一本書?」儲存回答的則是另一個問題:「這是不是我想記住的內容?」請設定一個 Action 來追加確認後的資料列,再設定另一個 Action 來檢查 Google 試算表裡實際有哪些內容。
- 建立一個名為
append_reading_event的 API Action。複製起始工具的 Sheets URL,保留直到實際檔案 ID 為止的所有內容,其餘部分改成/values/Events!A:H:append。設定 POST,並加入 Query Params 項目valueInputOption=RAW。原始輸入模式會保留 ISBN,並把以=開頭的筆記視為文字。 - 在 Headers 中,將
Authorization設為Bearer {{google_sheets_access_token}},並將Content-Type設為application/json。Quickchat AI 會在發出請求時填入 token。 - 新增六個必填的 Text 參數,名稱分別為
reading_id、isbn、title、edition_url、status和reading_date。再新增一個選填的 Text 參數,名稱為note,預設值留白。status 請從reading、finished、paused或abandoned中選一個。日期請使用讀者記下的日期,格式為YYYY-MM-DD。 - 在 API Endpoint → Body 中貼上下面的 JSON。兩組方括號代表一列資料、共八個儲存格。
conversation_url是內建的。再把這份工具包的 append 說明貼到 API Action Description。 - 將
read_reading_journal建立為指向同一份試算表的 GET,結尾使用/values/Events!A2:H1000。加入相同的 Bearer 標頭、工具包的歷史紀錄說明,不要填參數,body 保持空白。儲存後啟用這兩個 Action。
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
這個陣列對應到 A 到 H 欄。把筆記放在第七個位置,讀者寫下的內容就會落在 G 欄。
起始列就緒後,在 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.
檢查提議的版本、ID、日期和標點。這時 Events 應該還是只有開頭那一筆資料。接著輸入 「Yes, that is my edition. Save PAP-01 with that status, date and note.」。第 3 列應該會出現第二個事件。
這個提議會讓你最後再看一次 ISBN 和你的措辭。閱讀日誌變更前,你可以先修正其中任何一項。
在我們的實測中,提議沒有更動起始列。確認後,Shelf Notes 檢查閱讀日誌、重新查核 ISBN、只新增一列,並讀回那個新資料列。在 Inbox 中展開 append_reading_event,把 Google 的 updates.updatedRange 和你試算表中的儲存格對照。如果請求逾時,先查看是否已有新增資料列,再重試。 Google 試算表新增資料列參考
Google 回報 Events!A3:H3 已更新一列八個儲存格。選取 G3,將其中的文字和你核准的筆記比對。
4. 在新對話中可以問什麼?
在 AI Preview 開啟一段新對話,然後輸入 「What was the last note I saved for PAP-01?」。在我們的測試中,Agent 再次讀取 Events,並回傳 “I kept noticing who misunderstood whom.”第 2 列仍保留稍早那則關於 Netherfield 的筆記。Google 在回傳資料列時,可能會省略尾端的空白儲存格,因此起始列中的對話連結留白是正常的。
對於 「Which books am I still reading?」,如果同一次閱讀有兩個事件,而你又逐列計算,就會得到誤導性的答案。請使用 Status 分頁,為每個 reading ID 挑出最後追加的事件。
- 把
Status.tsv貼到 Status!A1。它在 A2 的公式會讓每個 reading ID 只列出一次。B2 會從 Events 底部開始,用精確比對查找。隨著書架上的資料增加,請將 B2 向下填滿,對齊新增的 ID。D2 會計算最新狀態為finished的 ID 數量。 - 建立
read_reading_status,也就是另一個 GET,使用相同的 bearer header,並採用尾碼/values/Status!A1:B1000。貼上工具包的狀態說明,body 和參數都留空,然後儲存並啟用。 - 詢問哪些書已經讀完。以範例來說,Status 有一筆已完成的閱讀,
PAP-01。如果你第二次重讀這本小說,請給它PAP-02。這樣你就能分辨第一次注意到的事情,和第二次注意到的事情。
複製這三個 Google 試算表公式
Status!A2 會列出各個 ID。
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2 會查找 A 欄中該 ID 的最新事件。
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2 會計算已完成的閱讀數量。
=COUNTIF(B2:B1000,"finished")
這份做法涵蓋 999 個事件。在新條目會落到第 1000 列以下之前,請一併延伸讀取範圍與公式範圍。決定一次對話要回傳多少歷史資料時,也要把長筆記和大量收藏納入考量。Google 試算表 XLOOKUP 說明
5. 它能用在你桌上的那本書嗎?
拿另一本書,試試它印在書上的 ISBN。先請它查出版本,然後先停下來。第一個適合的檢查點,是確認你可以只瀏覽一本書而不把它加進去。接著,替它指定一個閱讀 ID,再寫下一句只有你自己會寫得出的話。確認後,結束這段對話,再把那句話問回來。
要做可重複的檢查,請使用 Testing → Simulation,然後查看 Actions & MCPs → View logs 和目標儲存格。試著輸入無法辨識的 ISBN、拒絕建議加入的項目,並儲存一則以 =1+1 開頭的測試筆記。前兩種情況都不應該改動歷史紀錄。最後一種則應該在筆記儲存格中顯示這些原樣字元。
我們也讓本機工作表先存入一列資料,接著在回覆前逾時。Shelf Notes 讀回了那一列、回報逾時,而且沒有再追加第二列。如果某次儲存後讓你拿不準是否該再按一次送出,你也可以在 Action log 裡確認同樣的細節。
在找不到版本的測試中,書目來源回傳了 404。Agent 請求另一個識別碼,而閱讀日誌仍維持兩列。
如果你偏好從另一個助理來設定 Agent,套件內也附有 Quickchat AI 帳號連接器的設定請求。請附上 action-recipes.md 和 main-prompt.txt,再提供 setup-request.txt。檢查這五個 Action,親自完成 Google 的授權,並執行相同的閱讀測試。ChatGPT 連接器 · Claude 連接器 · 帳號設定指南
常見問題
如何用 ISBN 把書加入 Google 試算表?
用印在你手上那本書上的 ISBN,到 Open Library 查詢該版本。確認書名、出版社和年份,加入你的閱讀狀態與筆記,然後確認該列。入門套件已包含工作表欄位標題、公式,以及全部五個 Quickchat AI Action 配方。
我可以使用自己原本在 Google 試算表裡的閱讀紀錄嗎?
把你想保留的條目複製到由 Quickchat AI 連線建立的試算表中的 Events 分頁。對齊這八個欄位,並把 ISBN 保持為文字格式。把另一個私人檔案的 ID 貼進 Action,並不會讓它取得開啟那個檔案的權限。
如果 Open Library 找不到我的 ISBN,怎麼辦?
檢查條碼旁或版權頁上的號碼,包括前導 0 或最後的 X。若仍無法確認版本,就不要更動閱讀日誌。ISBN 用來識別版本,並不提供書籍全文的存取權。
我要怎麼統計讀完的書,並追蹤重讀?
每次閱讀都給它自己的 ID。暫停或讀完這本書時,沿用同一個 ID;若是重讀,就建立新的 ID。在 Status 分頁統計已讀完的條目。這樣同一版本讀完兩次會算兩次,而同一次閱讀的兩次更新只會算一次。
關閉對話之後,我還能找回閱讀筆記嗎?
可以。在新的私人對話中,詢問那本書或該次閱讀的 ID。history Action 會再次讀取 Events 分頁,裡面存有附日期的條目和你的原始措辭。Status 分頁則提供每次閱讀最近一次記錄的狀態。