Cách dùng thường gặp

Mỗi cách dùng dưới đây đều kèm một câu lệnh bạn có thể gõ thật, những công cụ nó sẽ dùng tới, và mức quyền thấp nhất đủ để nó chạy. Chỉ cấp đúng những gì các cách dùng của bạn cần — xem các nhóm quyền để biết mỗi lần cấp quyền đánh đổi điều gì.

Một điều đúng với gần như tất cả: ghi chú được lưu theo ID trường, không phải tên trường, nên một trợ lý biết việc sẽ đọc schema của Notebase trước lần ghi đầu tiên. Nếu nó đoán thay vì đọc, hãy bảo nó đọc schema trước.

Thu thập

Lưu một từ từ cuộc trò chuyện

Chúng ta vừa nói về "hedge" theo nghĩa tài chính. Lưu nó vào Notebase tiếng Anh của tôi, điền theo đúng kiểu các ghi chú đã có.

get_notebase_schema → create_notes · notes:write

Trợ lý đọc các trường của bạn, rồi ghi một ghi chú theo đúng hình dạng chúng mô tả. Nếu bạn có nhiều Notebase đều hợp, hãy nói rõ là Notebase nào. Mẫu thẻ nào đã có trên Notebase đó sẽ biến ghi chú mới thành thẻ ngay lập tức.

Biến một tệp PDF hay một bài viết thành ghi chú có cấu trúc

Đây là PDF của một chương. Lọc ra những từ mà ở trình độ B2 tôi có thể chưa biết, và lưu mỗi từ vào Notebase tiếng Anh của tôi kèm định nghĩa và câu mà nó xuất hiện trong đó.

get_notebase_schema → create_notes · notes:write

Trợ lý đọc tài liệu bằng công cụ đọc tệp hoặc truy cập web của riêng nó; Read Frog chỉ lưu những gì ra được. create_notes ghi tối đa 50 ghi chú mỗi lệnh gọi và hoàn tác cả lô nếu có bất kỳ ghi chú nào xung đột, nên một chương dài sẽ vào theo vài lô gọn gàng thay vì một lần ghi được tất cả hoặc không được gì.

Tìm lại một ghi chú bạn chỉ nhớ mang máng

Trước đây tôi có lưu một từ nghĩa là "đi lang thang không mục đích". Tìm nó trong Notebase tiếng Anh của tôi.

list_notes · notes:read

Tìm kiếm là so khớp chuỗi con theo đúng mặt chữ, không phân biệt hoa thường, dài tối thiểu hai ký tự; mỗi lần chỉ chạy trong một Notebase, và chỉ xét các trường văn bản — giá trị kiểu số, ngày, ô tích hay danh sách chọn sẽ không bao giờ khớp. Cần tìm mơ hồ hơn thì hãy để trợ lý liệt kê cả Notebase rồi tự phán đoán.

Định hình Notebase

Để trợ lý thiết kế Notebase và các trường của nó

Tôi bắt đầu học tiếng Nhật. Hãy lập một Notebase cho nó với những trường bạn thấy cần cho việc học từ vựng — nhưng nói phương án cho tôi trước khi tạo bất cứ thứ gì.

create_notebase → create_notebase_field · notebases:write

create_notebase tạo một Notebase rỗng, kèm các trường đầu tiên nếu bạn muốn; ghi chú luôn là một bước riêng. Hỏi phương án trước đáng để mất thêm một lượt, vì kiểu của một trường không đổi được về sau — chỉ tên và các lựa chọn của nó là đổi được.

Sinh một mẫu thẻ

Xem Notebase tiếng Nhật của tôi và dựng một thẻ nhận biết: mặt trước là từ, mặt sau là nghĩa và ví dụ.

get_notebase_schema → create_card_template · card_templates:write kèm notebases:read

Mẫu thẻ tham chiếu tới trường bằng ID, và đó là lý do phải đọc schema trước. Tạo một mẫu thẻ sẽ sinh thẻ cho mọi ghi chú đã có trong Notebase, nên một Notebase 400 ghi chú sẽ có thêm 400 thẻ ngay khi mẫu thẻ được lưu.

Sửa một mẫu thẻ hiển thị sai

Mặt sau thẻ tiếng Nhật của tôi đang hiện trường thô chứ không phải câu ví dụ. Xem một thẻ rồi sửa mẫu thẻ giúp tôi.

get_card → get_card_template → update_card_template · card_templates:write kèm notes:read và study:read

get_card là thứ khiến việc này khả thi: nó trả về mặt trước và mặt sau đã kết xuất, nhờ vậy trợ lý thấy được đầu ra thật thay vì suy luận trừu tượng về mẫu thẻ.

Dọn dẹp các trường

Trường "từ loại" trong Notebase tiếng Anh của tôi là văn bản tự do và đang rất lộn xộn. Chuyển nó thành danh sách chọn với đúng những lựa chọn đang được dùng.

get_notebase_schema → list_notes → update_notebase_field · notebases:write kèm notes:read

Kiểu của một trường là cố định, nên việc này là đổi tên và cấu hình lại, không phải chuyển đổi kiểu. Bỏ một lựa chọn khỏi danh sách chọn sẽ xóa giá trị đó khỏi mọi ghi chú đang mang nó, còn trường nào đang được một mẫu thẻ tham chiếu thì không xóa được.

Bổ sung những chỗ còn thiếu

Bổ sung câu ví dụ, từ loại và phiên âm

Rà soát Notebase tiếng Anh của tôi và điền vào mọi ghi chú còn thiếu câu ví dụ, từ loại hoặc phiên âm. Những thứ khác thì đừng động tới.

list_notes → update_note · notes:write

update_note hoạt động theo kiểu hợp nhất: những trường bạn không nhắc tới sẽ giữ nguyên giá trị, còn null là cố ý xóa trắng một trường. Mỗi lần cập nhật đều mang theo dấu thời gian hiện tại của ghi chú, nên nếu trong lúc đó có gì thay đổi thì lệnh ghi sẽ thất bại chứ không ghi đè lên chỉnh sửa của bạn — khi ấy trợ lý nên đọc lại ghi chú đó rồi thử lại. Công cụ này mỗi lệnh gọi xử lý một ghi chú, nên hãy chờ nó đi hết một Notebase lớn theo từng đợt.

Học tập

Hôm nay tôi nên ôn gì

Hôm nay có gì đang chờ tôi, và khoảng bao lâu thì xong?

get_study_stats → list_cards · study:read kèm notes:read nếu muốn có nội dung thẻ

get_study_stats cho bạn số lượng trong hàng đợi của từng Notebase trong một ngày nhất định, còn list_cards lọc được theo trạng thái lịch để cho thấy những con số đó gồm các thẻ nào.

Ôn tập ngay trong cuộc trò chuyện

Lấy mười thẻ đến hạn trong Notebase tiếng Nhật của tôi ra kiểm tra tôi. Cho tôi xem mặt trước, chờ tôi trả lời, rồi ghi nhận kết quả của tôi.

list_cards → record_review → undo_review · study:write kèm notes:read

Cách này làm được, và cũng là cách cần cân nhắc kỹ nhất. Mỗi đánh giá mà trợ lý ghi nhận là một lượt ôn tập thật: FSRS dựa vào đó cập nhật độ ổn định, độ khó và ngày đến hạn tiếp theo của thẻ, đúng như thể bạn tự bấm nút. Ghi nhận một lượt ôn tập còn cần múi giờ, vì nó quyết định lượt ôn đó thuộc ngày học nào — nếu tài khoản của bạn chưa từng lưu múi giờ, lệnh gọi sẽ thất bại và hỏi bạn thay vì đoán. undo_review lùi lại lượt ôn tập gần nhất của một thẻ khi bạn bị chấm sai, và chỉ đúng lượt đó.

Bỏ qua hoặc đình chỉ một thẻ quá khó

Thẻ vừa rồi tôi mãi không nhớ được, cứ trả lời sai suốt. Tạm thời cho nó ra khỏi vòng luân chuyển đi.

set_card_suspended / set_card_buried · study:write

Bỏ qua thì ẩn thẻ cho tới hết ngày; đình chỉ thì lấy nó ra khỏi việc học cho tới khi bạn đưa trở lại. Cả hai đều đảo lại được bằng chính những công cụ đó.

Xem lại tiến độ gần đây của tôi

Hai tuần qua thế nào? Có gì mà tôi liên tục làm sai không?

get_study_stats → list_review_history · study:read

list_review_history trả về các bản ghi ôn tập của bạn — đánh giá và thời gian, lọc được theo Notebase hoặc theo thẻ — nhưng không có nội dung ghi chú. Ghép nó với list_cards nếu bạn muốn trợ lý chỉ tên những từ bạn cứ quên, và khi đó cần thêm notes:read.

Đổi giới hạn hằng ngày

Hai mươi thẻ mới mỗi ngày là quá nhiều so với những việc khác tôi đang có. Giảm một nửa cho Notebase tiếng Nhật của tôi.

get_study_settings → update_study_settings · study:write

Hai công cụ này chỉ chạm tới giới hạn thẻ mới mỗi ngày, giới hạn thẻ ôn tập mỗi ngày và tỷ lệ ghi nhớ mong muốn. Chúng không đổi tên hay xóa được gì.

Việc lặt vặt

Kiểm tra đang kết nối với tài khoản nào

Bạn đang kết nối với tài khoản Read Frog nào?

whoami · account:read

Đáng bỏ ra một lượt khi bạn có nhiều hơn một tài khoản, hoặc trước khi cho một trợ lý ghi bất cứ thứ gì.

Dọn những thứ bạn không cần nữa

Notebase tiếng Anh của tôi có những mục trùng nhau. Liệt kê rồi xóa những mục dư, nhưng cho tôi xem danh sách trước.

list_notes → delete_note · notes:write

Xóa ở đây là vĩnh viễn và lan theo chuỗi: một ghi chú bị xóa sẽ mang theo thẻ của nó và lịch sử ôn tập của những thẻ đó. delete_notebase đi xa hơn, xóa cả Notebase — trường, ghi chú, mẫu thẻ, thẻ, bản ghi ôn tập. Hãy yêu cầu xem danh sách trước khi xóa.