Bạn đã viết gì khi đọc xong Pride and Prejudice? Trong nhật ký đọc sách này, câu trả lời là “I kept noticing who misunderstood whom.” (Tôi cứ để ý xem ai đang hiểu lầm ai). Câu này thuộc về bản bìa mềm của Penguin, ISBN 9780141439518, hoàn thành vào 8 tháng 11. Câu đó vẫn còn ở đây khi bạn mở một cuộc chat mới.
Bạn sẽ tạo Shelf Notes, một nhật ký đọc sách riêng tư trong Google Trang tính. Open Library cung cấp thông tin ấn bản, bạn cung cấp ngày tháng và điều bạn muốn lưu lại, rồi một Agent của Quickchat AI sẽ đưa chúng vào cùng một hàng sau khi bạn xác nhận.
Tải bộ khởi đầu Shelf Notes. Mở Shelf Notes.xlsx để xem ví dụ đã hoàn thành. Dùng hai tệp TSV để tạo nhật ký của riêng bạn trong Google Trang tính. Chúng bắt đầu sớm hơn một mục, khi người đọc vẫn đang đọc. Bộ tài liệu cũng có sẵn đúng các thiết lập Action và Main Prompt.
1. Trên giá sách của bạn là ấn bản nào?
Hãy thử tra cứu trước khi kết nối bất cứ thứ gì. Mở ấn bản ứng với ISBN 9780141439518. Đây là một bản bìa mềm tiếng Anh dày 435 trang do Penguin Books xuất bản năm 2003. Tiểu thuyết của Jane Austen lần đầu ra mắt vào năm 1813. Cả hai năm đều thuộc về Pride and Prejudice, nhưng chỉ một năm mô tả đúng cuốn sách đang nằm trên bàn.
- Tạo tài khoản hoặc đăng nhập vào Quickchat AI. Dùng Agent trống của bạn hoặc chọn Add new AI Agent → Set up manually. Đặt tên là Shelf Notes. Bạn sẽ cần một tài khoản Google cho nhật ký và đủ AI credits để thử một cuộc trò chuyện mới.
- Trước khi thêm ghi chú cá nhân, hãy mở Your Website → Install → Availability and access. Tắt Widget & Embed access, đặt Chat Page Access thành Nobody, và giữ các kênh khác chưa kết nối. Dùng AI Preview trong bảng điều khiển khi bạn đã đăng nhập.
- Trong Identity → Main Prompt, dán
main-prompt.txttừ bộ tài liệu. Tệp này hướng dẫn Agent hiển thị mục ghi dự kiến và chờ một xác nhận riêng. - Trong Actions & MCPs → Add Action → API Action → Create manually, hãy tạo hai Action GET bên dưới. Với mỗi Action, dùng When to run → AI decides, thêm một tham số Text bắt buộc có tên
isbndưới What to ask the user first, và để trống phần body. Xóa dấu cách và dấu gạch nối khỏi số này, giữ lại số 0 ở đầu và ký tựXcuối cùng của ISBN-10.
| Tên action | Điểm cuối API | Phần cần dùng từ kết quả trả về |
|---|---|---|
lookup_book_isbn | https://openlibrary.org/search.json | Trong Query Params, nhập isbn={{isbn}}, fields=key,title,author_name,first_publish_year và limit=1. Tác phẩm sẽ cho biết tác giả và năm xuất bản đầu tiên của tiểu thuyết. |
lookup_edition | https://openlibrary.org/isbn/{{isbn}}.json | Kiểm tra xem số đã cung cấp có xuất hiện trong isbn_13 hoặc isbn_10 không. Đọc nhà xuất bản, ngày xuất bản của ấn bản và ngôn ngữ nếu có. Thêm khóa /books/ được trả về vào https://openlibrary.org để tạo liên kết nguồn. |
Nhập ISBN vào cuộc trò chuyện. Action sẽ chèn nó vào một URL có host được cố định trong trình chỉnh sửa.
Lần tra cứu đầu tiên của chúng ta cũng yêu cầu danh sách các ấn bản của tác phẩm. Với ISBN này, kết quả trả về tới 4.042 mã ấn bản. Bỏ trường đó đi thì phản hồi ngắn gọn chỉ còn tác giả và năm xuất bản gốc. Yêu cầu thứ hai vẫn trả về đúng bản bìa mềm mà chúng ta cần.
Trong Headers, đặt User-Agent của mỗi yêu cầu là ShelfNotes/1.0 (YOUR_CONTACT_EMAIL), thay địa chỉ liên hệ ví dụ bằng địa chỉ của bạn. Dán API Action Description tương ứng từ action-recipes.md, lưu rồi bật từng Action. Hãy thử “Look up ISBN 978-0-14-143951-8.”. Bạn sẽ thấy đúng ấn bản mà không cần tạo mục nào trong nhật ký đọc sách. Tra cứu cá nhân này không cần tài khoản Open Library. Dùng nó khi ai đó hỏi về một cuốn sách và làm theo hướng dẫn dùng API của Open Library.
2. Nên ghi gì trong nhật ký đọc sách?
Hãy để thông tin thư mục và quan sát của riêng bạn ở các cột tách biệt. Bạn có thể cho ai đó mượn đúng ấn bản này và hai người bất đồng về mọi nhân vật. ISBN vẫn không đổi. Ghi chú của bạn thuộc về lần đọc của bạn, ở đây được định danh là PAP-01.
- Mở Actions & MCPs → Add Action → Google Sheets → Connect. Cấp quyền cho tài khoản Google sẽ sở hữu nhật ký, rồi chọn Open sheet. Kết nối này tạo một bảng tính trong Drive theo phạm vi cấp quyền
drive.file. Hướng dẫn kết nối Google Trang tính cho thấy các màn hình cấp quyền. Với nhật ký cá nhân, hãy mở Chia sẻ trong Google Trang tính và giữ mục Quyền truy cập chung ở chế độ Hạn chế. - Tắt Action khởi đầu đang hoạt động,
log_lead_to_google_sheet. Giữ nguyên tên của nó và sao chép API Endpoint với file ID đã được điền sẵn. Cứ để Action khởi đầu ở trạng thái tắt. Bạn sẽ tạo các Action riêng cho nhật ký này.
Mở tệp được tạo cho Agent này. Action khởi đầu đã chứa sẵn mã nhận dạng bảng tính mà bạn cần.
- Đổi tên tab Leads thành Events và thay toàn bộ nội dung bằng
Events.tsv, bắt đầu từ A1. Định dạng cột B (ISBN) và F (ngày) là Plain text trước khi dán. Thêm tab thứ hai tên là Status. Với một trang tính mẫu mới, dùng File → Settings → Locale → United States để các công thức bên dưới chấp nhận dấu phẩy.
Bắt đầu với hàng 2. PAP-01 vẫn đang đọc, với “Started with the Netherfield visit.” trong G2. Sau khi bạn xác nhận, mục đã đọc xong sẽ xuất hiện ở hàng 3.
Tám cột của Events, theo thứ tự, là reading_id, isbn, title, edition_url, status, reading_date, note và conversation. Ô cuối cùng chứa liên kết quay lại cuộc trò chuyện. Sự kiện đầu tiên của mẫu khởi đầu ghi reading vào ngày 2 tháng 11. Ghi chú của nó là “Started with the Netherfield visit.”
Giữ nguyên một mã lượt đọc khi một cuốn sách chuyển từ reading sang finished. Chọn mã mới khi bạn quay lại cuốn sách để đọc lại.
3. Lưu ghi chú trong nhật ký đọc sách theo ISBN như thế nào?
Phần tra cứu trả lời câu hỏi “Đó là cuốn nào?”. Còn bước lưu lại trả lời một câu hỏi khác: “Đây có phải điều mình muốn nhớ không?”. Hãy thiết lập một Action để thêm dòng đã xác nhận và một Action khác để kiểm tra bảng tính thực sự đang có gì.
- Tạo một API Action có tên
append_reading_event. Sao chép URL Google Trang tính của bộ khởi đầu, giữ nguyên mọi thứ đến hết file ID thực tế của nó. Thay phần còn lại bằng/values/Events!A:H:append. Đặt POST và thêm mục Query ParamsvalueInputOption=RAW. Chế độ nhập thô giữ nguyên ISBN và coi ghi chú bắt đầu bằng=là văn bản. - Trong Headers, đặt
AuthorizationlàBearer {{google_sheets_access_token}}vàContent-Typelàapplication/json. Quickchat AI sẽ điền token vào lúc gửi yêu cầu. - Thêm sáu tham số Text bắt buộc có tên
reading_id,isbn,title,edition_url,statusvàreading_date. Thêm một tham số Text không bắt buộc có tênnotevới giá trị mặc định để trống. Chọnreading,finished,pausedhoặcabandonedcho trạng thái. Dùng ngày của người đọc theo định dạngYYYY-MM-DD. - Trong API Endpoint → Body, dán JSON bên dưới. Hai cặp ngoặc vuông nghĩa là một hàng với tám ô.
conversation_urllà giá trị có sẵn trong hệ thống. Dán phần mô tả append của bộ công cụ vào API Action Description. - Tạo
read_reading_journaldưới dạng GET tới cùng bảng tính, kết thúc bằng/values/Events!A2:H1000. Đặt cùng header bearer, phần mô tả history của bộ kit, không có tham số và body để trống. Lưu rồi bật cả hai Action.
{
"values": [[
"{{reading_id}}", "{{isbn}}", "{{title}}", "{{edition_url}}",
"{{status}}", "{{reading_date}}", "{{note}}", "{{conversation_url}}"
]]
}
Mảng này khớp với các cột từ A đến H. Giữ ghi chú ở vị trí thứ bảy sẽ đưa lời của người đọc vào cột G.
Khi đã có hàng khởi đầu, hãy gửi tin nhắn sau trong 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.
Kiểm tra ấn bản, ID, ngày và dấu câu được đề xuất. Ở bước này Events vẫn chỉ nên có mục mở đầu. Sau đó nói “Yes, that is my edition. Save PAP-01 with that status, date and note.”. Một sự kiện thứ hai sẽ xuất hiện ở hàng 3.
Đề xuất này cho bạn xem lại lần cuối ISBN và câu chữ của mình. Bạn có thể sửa một trong hai trước khi nhật ký thay đổi.
Trong lần chạy trực tiếp của chúng tôi, đề xuất vẫn giữ nguyên hàng mở đầu. Sau khi xác nhận, Shelf Notes kiểm tra nhật ký, kiểm tra lại ISBN, thêm đúng một hàng và đọc lại hàng mới. Trong Inbox, mở rộng append_reading_event và so sánh updates.updatedRange của Google với các ô trong bảng tính của bạn. Nếu yêu cầu hết thời gian chờ, hãy tìm hàng đó trước khi thử lại. Tài liệu tham khảo cách thêm hàng trong Google Sheets
Google báo cáo một hàng và tám ô được cập nhật tại Events!A3:H3. Chọn G3 để so sánh văn bản trong ô với ghi chú bạn đã duyệt.
4. Bạn có thể hỏi gì trong một cuộc trò chuyện mới?
Mở một cuộc trò chuyện mới trong AI Preview và hỏi “What was the last note I saved for PAP-01?” Trong bài thử của chúng tôi, Agent đọc lại Events và trả về “I kept noticing who misunderstood whom.” Hàng 2 vẫn giữ ghi chú Netherfield trước đó. Google có thể bỏ qua các ô trống ở cuối một hàng được trả về, nên việc liên kết cuộc trò chuyện để trống trong hàng khởi đầu là điều bình thường.
Với câu hỏi “Which books am I still reading?”, hai sự kiện cho một lần đọc sẽ cho ra câu trả lời sai lệch nếu bạn đếm từng hàng. Hãy dùng tab Status để chọn sự kiện được thêm gần nhất cho từng reading ID.
- Dán
Status.tsvvào Status!A1. Công thức của nó trong A2 liệt kê mỗi reading ID một lần. B2 dùng tra cứu khớp chính xác bắt đầu từ cuối của Events. Hãy điền B2 xuống cùng với các ID mới khi kệ sách của bạn lớn dần. D2 đếm các ID có trạng thái mới nhất làfinished. - Tạo
read_reading_status, một GET khác với cùng header bearer, dùng hậu tố/values/Status!A1:B1000. Dán phần mô tả trạng thái của bộ kit, để body và tham số trống, rồi lưu và bật nó. - Hãy hỏi những cuốn nào đã đọc xong. Với dữ liệu mẫu, Status có một lần đọc đã hoàn thành,
PAP-01. Với lần đọc thứ hai của cuốn tiểu thuyết, hãy đặt cho nóPAP-02. Sau đó bạn có thể phân biệt điều mình nhận ra ở lần đầu với điều mình nhận ra ở lần thứ hai.
Sao chép ba công thức Google Trang tính
Status!A2 liệt kê các ID.
=SORT(UNIQUE(IFERROR(FILTER(Events!A2:A1000,Events!A2:A1000<>""),"")),1,TRUE)
Status!B2 tra cứu sự kiện mới nhất cho ID ở cột A.
=IF(A2="","",XLOOKUP(A2,Events!$A$2:$A$1000,Events!$E$2:$E$1000,"",0,-1))
Status!D2 đếm các lần đọc đã hoàn thành.
=COUNTIF(B2:B1000,"finished")
Cách làm này áp dụng cho 999 sự kiện. Trước khi một mục mới rơi xuống dưới hàng 1000, hãy mở rộng cùng lúc các phạm vi đọc và phạm vi công thức. Hãy lưu ý các ghi chú dài và bộ sưu tập lớn khi chọn lượng lịch sử cần trả về trong một cuộc trò chuyện. Tài liệu tham chiếu XLOOKUP của Google Trang tính
5. Nó có hoạt động với cuốn sách trên bàn của bạn không?
Hãy cầm một cuốn sách khác lên và thử ISBN in trên sách. Hỏi ấn bản rồi dừng lại. Một bước kiểm tra đầu tiên hợp lý là bạn có thể tra cứu một cuốn sách mà không thêm nó. Tiếp theo, hãy gán cho nó một mã lần đọc và một câu chỉ mình bạn mới có thể viết. Xác nhận, đóng cuộc trò chuyện rồi yêu cầu lấy lại đúng câu đó.
Để kiểm tra theo cách có thể lặp lại, hãy dùng Testing → Simulation, rồi xem Actions & MCPs → View logs và các ô đích. Hãy thử một ISBN không được nhận diện, từ chối một mục được đề xuất và lưu một ghi chú thử bắt đầu bằng =1+1. Hai trường hợp đầu sẽ không làm thay đổi lịch sử. Trường hợp cuối sẽ hiển thị đúng nguyên văn các ký tự đó trong ô ghi chú.
Chúng ta cũng đã để trang tính cục bộ lưu một hàng rồi hết thời gian chờ trước khi trả lời. Shelf Notes đã đọc lại hàng đó, báo có timeout và không thêm hàng lần thứ hai. Bạn cũng có thể kiểm tra đúng chi tiết này trong nhật ký Action nếu một lần lưu nào đó khiến bạn phân vân có nên nhấn gửi lại hay không.
Trong bài kiểm tra thiếu ấn bản, danh mục trả về 404. Agent đã yêu cầu một mã định danh khác và nhật ký vẫn giữ nguyên hai hàng.
Nếu bạn muốn cấu hình Agent từ một trợ lý khác, bộ kit có sẵn một yêu cầu thiết lập cho trình kết nối tài khoản Quickchat AI. Hãy đính kèm action-recipes.md và main-prompt.txt, rồi gửi cho trợ lý setup-request.txt. Xem lại năm Action, tự bạn hoàn tất bước cấp quyền của Google và chạy lại cùng bài kiểm tra nhật ký đọc sách. Trình kết nối ChatGPT · Trình kết nối Claude · Hướng dẫn thiết lập tài khoản
Câu hỏi thường gặp
Làm sao để thêm một cuốn sách vào Google Trang tính bằng ISBN?
Dùng ISBN in trên cuốn sách của bạn để tra cứu ấn bản đó trên Open Library. Kiểm tra nhan đề, nhà xuất bản và năm, thêm trạng thái đọc cùng ghi chú của bạn, rồi xác nhận hàng đó. Bộ khởi đầu đã có sẵn tiêu đề cột, công thức và đủ 5 recipe Action của Quickchat AI.
Tôi có thể dùng nhật ký đọc sách hiện có của mình trên Google Trang tính không?
Hãy sao chép những mục bạn muốn vào tab Events của bảng tính do kết nối Quickchat AI tạo ra. Khớp đủ tám cột và giữ ISBN ở dạng văn bản. Việc dán ID của một tệp riêng tư khác vào Action không cấp quyền để mở tệp đó.
Nếu Open Library không tìm thấy ISBN của tôi thì sao?
Kiểm tra dãy số trên mã vạch hoặc trang bản quyền, gồm cả số 0 ở đầu hay chữ X ở cuối nếu có. Nếu vẫn không thể xác minh được ấn bản, hãy để nguyên nhật ký. ISBN dùng để định danh một ấn bản và không cấp quyền truy cập toàn văn cuốn sách.
Làm sao để đếm sách đã đọc xong và theo dõi những lần đọc lại?
Hãy gán cho mỗi lần đọc một mã lần đọc riêng. Giữ nguyên mã đó khi bạn tạm dừng hoặc đọc xong cuốn sách, và tạo mã mới cho lần đọc lại. Đếm các mục đã hoàn thành trên tab Status. Khi đó, hai lần đọc xong của cùng một ấn bản sẽ được tính hai lần, còn hai lần cập nhật của một lần đọc chỉ tính một lần.
Tôi có thể tìm lại ghi chú đọc sách sau khi đóng cuộc chat không?
Có. Hãy hỏi theo tên sách hoặc mã lần đọc trong một cuộc chat riêng tư mới. History Action sẽ đọc lại tab Events, nơi lưu các mục có ngày tháng và nguyên văn ghi chú của bạn. Tab Status cung cấp trạng thái được ghi nhận mới nhất cho từng lần đọc.