Рецепты

Каждый рецепт ниже даёт формулировку, которую вы могли бы действительно набрать, инструменты, за которыми он потянется, и минимальное разрешение, позволяющее ему сработать. Выдавайте только то, что нужно используемым вами рецептам — чего стоит каждая выдача, см. в группах разрешений.

Замечание, применимое почти ко всем: заметки хранятся по идентификаторам полей, а не по их названиям, поэтому воспитанный ассистент читает схему notebase перед первой записью. Если он вместо этого угадывает — скажите ему сначала прочитать схему.

Сбор

Сохранить слово из разговора

Мы только что обсуждали «hedge» в финансовом смысле. Сохрани это в мою английскую notebase, заполнив так же, как заполнены существующие заметки.

get_notebase_schema → create_notes · notes:write

Ассистент читает ваши поля, затем пишет одну заметку в описанной ими форме. Если подходящих notebase у вас несколько, скажите, в какую именно. Шаблоны карточек, уже имеющиеся у этой notebase, тут же превращают новую заметку в карточки.

Превратить PDF или статью в структурированные заметки

Вот PDF с главой. Вытащи лексику, которую я на уровне B2 правдоподобно мог бы не знать, и сохрани каждое слово в мою английскую notebase с определением и предложением, из которого оно взято.

get_notebase_schema → create_notes · notes:write

Ваш ассистент читает документ своими собственными файловыми или браузерными инструментами; Read Frog только сохраняет то, что получилось. create_notes пишет до 50 заметок за вызов и откатывает весь пакет, если какая-то из них столкнётся с существующей, поэтому длинная глава приезжает несколькими чистыми пакетами, а не одной записью по принципу «всё или ничего».

Найти заметку, которую помните наполовину

Я когда-то сохранил что-то про слово со значением «бродить без цели». Найди это в моей английской notebase.

list_notes · notes:read

Поиск — это буквальная подстрока без учёта регистра длиной не менее двух символов, он работает по одной notebase за раз и заглядывает только в текстовые поля: значение типа число, дата, флажок или выбор не совпадёт никогда. Для чего-то более расплывчатого пусть ассистент выведет notebase и рассудит сам.

Придать notebase форму

Пусть ассистент спроектирует notebase и её поля

Я начинаю японский. Подготовь для него notebase с теми полями, какие ты сам захотел бы для лексики, — но сначала расскажи план, ничего не создавая.

create_notebase → create_notebase_field · notebases:write

create_notebase создаёт пустую notebase, при желании вместе с первыми полями; заметки — всегда отдельный шаг. Попросить сначала план стоит лишнего хода, потому что тип поля потом изменить нельзя — только его название и его варианты.

Сгенерировать шаблон карточки

Посмотри мою японскую notebase и собери карточку на узнавание: слово на лицевой стороне, значение и пример — на оборотной.

get_notebase_schema → create_card_template · card_templates:write вместе с notebases:read

Шаблоны ссылаются на поля по идентификатору — потому чтение схемы и идёт первым. Создание шаблона порождает карточки для каждой уже имеющейся в notebase заметки, поэтому notebase из 400 заметок получает 400 карточек в момент появления шаблона.

Починить шаблон, который плохо отрисовывается

Оборотная сторона моих японских карточек показывает сырое поле вместо примера предложения. Посмотри на одну карточку и исправь шаблон.

get_card → get_card_template → update_card_template · card_templates:write вместе с notes:read и study:read

Возможность даёт именно get_card: он возвращает отрисованные лицевую и оборотную стороны, поэтому ассистент видит настоящий вывод, а не рассуждает о заготовке в отрыве от результата.

Привести поля в порядок

Поле «часть речи» в моей английской notebase — свободный текст, и там бардак. Преврати его в выбор с теми вариантами, которые реально используются.

get_notebase_schema → list_notes → update_notebase_field · notebases:write вместе с notes:read

Тип поля зафиксирован, поэтому это переименование и перенастройка, а не преобразование. Удаление варианта выбора очищает это значение из каждой заметки, где оно стояло, а поле, на которое ссылается шаблон, удалить нельзя вообще.

Заполнить пропущенное

Дозаполнить примеры, часть речи и фонетику

Пройди по моей английской notebase и заполни каждую заметку, в которой нет примера предложения, части речи или фонетики. Всё остальное не трогай.

list_notes → update_note · notes:write

update_note сливает данные: поля, которые вы не упомянули, сохраняют свои значения, а null очищает поле намеренно. Каждое обновление несёт текущую метку времени заметки, поэтому если что-то изменилось в промежутке, запись падает, а не переписывает вашу правку — ассистенту следует перечитать эту заметку и попробовать снова. Работает по одной заметке за вызов, так что большую notebase он будет проходить пакетами.

Занятия

Что мне повторять сегодня

Что меня сегодня ждёт и сколько это примерно займёт?

get_study_stats → list_cards · study:read вместе с notes:read для содержимого карточек

get_study_stats даёт счётчики очереди по каждой notebase на заданный день, а list_cards умеет фильтровать по состоянию расписания и показать, из чего эти счётчики состоят.

Повторять внутри разговора

Погоняй меня по десяти карточкам со сроком из моей японской notebase. Показывай лицевую сторону, дожидайся моего ответа, затем записывай, как у меня получилось.

list_cards → record_review → undo_review · study:write вместе с notes:read

Это работает, и именно с этим рецептом стоит быть особенно осознанным. Каждая оценка, записанная ассистентом, — настоящее повторение: FSRS обновляет по ней стабильность, сложность и следующий срок карточки в точности так, как если бы кнопку нажали вы сами. Записи повторения нужен ещё и часовой пояс, потому что он решает, какому учебному дню повторение принадлежит: если у вашего аккаунта он никогда не сохранялся, вызов падает и просит его, а не угадывает. undo_review откатывает последнее повторение одной карточки, когда оценка была выставлена неверно, — и только его.

Отложить или приостановить слишком трудную карточку

Вот эта карточка никак не заходит, и я её всё время проваливаю. Убери её из оборота пока что.

set_card_suspended / set_card_buried · study:write

Откладывание скрывает карточку до конца дня; приостановка убирает её, пока вы не вернёте. И то, и другое обратимо теми же инструментами.

Посмотреть на мой недавний прогресс

Как прошли последние две недели? Есть что-то, в чём я стабильно ошибаюсь?

get_study_stats → list_review_history · study:read

list_review_history возвращает ваши записи повторений — оценки и время, с фильтрами по notebase или карточке — без содержимого заметок. Соедините это с list_cards, если хотите, чтобы ассистент называл слова, на которых вы постоянно спотыкаетесь: это добавляет notes:read.

Изменить дневные лимиты

Двадцать новых карточек в день — это слишком много при всём остальном. Урежь вдвое для моей японской notebase.

get_study_settings → update_study_settings · study:write

Эти два достают только до дневного лимита новых карточек, дневного лимита повторений и желаемого удержания. Переименовать или удалить что-либо они не могут.

Уборка

Проверить, какой аккаунт подключён

К какому аккаунту Read Frog ты подключён?

whoami · account:read

Стоит одного хода, если у вас больше одного аккаунта или перед тем, как дать ассистенту что-нибудь записать.

Вычистить то, что больше не нужно

В моей английской notebase есть дубликаты. Выведи их и удали лишние, но сначала покажи список.

list_notes → delete_note · notes:write

Удаления здесь необратимы и каскадны: удалённая заметка уносит с собой свои карточки и их историю повторений. delete_notebase идёт дальше и убирает notebase целиком — поля, заметки, шаблоны, карточки, записи повторений. Просите список до удаления.