Recetas
Cosas que vale la pena pedirle a un asistente con tus notas y tarjetas, cada una con el prompt que escribir, las herramientas que usa y el permiso que necesita.
Cada receta de aquí abajo da un prompt que podrías escribir de verdad, las herramientas a las que recurrirá y el permiso mínimo que le permite funcionar. Concede solo lo que necesiten las recetas que uses: consulta los grupos de permisos para ver lo que cuesta cada concesión.
Algo que vale para casi todas: las notas se guardan contra IDs de campo, no contra nombres de campo, así que un asistente que se porte bien lee la estructura del Notebase antes de su primera escritura. Si en lugar de eso se pone a adivinar, dile que lea primero la estructura.
Recopilar
Guardar una palabra de la conversación
Acabamos de hablar de «hedge» en el sentido financiero. Guárdalo en mi Notebase de inglés, rellenado como están las notas que ya hay.
get_notebase_schema → create_notes · notes:write
El asistente lee tus campos y escribe una nota con la forma que describen. Si tienes varios Notebases que encajarían, di cuál. Las plantillas de tarjeta que ya tenga ese Notebase convierten la nota nueva en tarjetas al momento.
Convertir un PDF o un artículo en notas estructuradas
Aquí tienes el PDF de un capítulo. Saca el vocabulario que probablemente no conozca a nivel B2 y guarda cada palabra en mi Notebase de inglés con una definición y la frase de la que viene.
get_notebase_schema → create_notes · notes:write
Tu asistente lee el documento con sus propias herramientas de archivos o de navegación; Read Frog solo guarda lo que sale. create_notes escribe hasta 50 notas por llamada y revierte el lote entero si alguna de ellas choca, así que un capítulo largo llega en unos pocos lotes limpios en lugar de en una escritura de todo o nada.
Encontrar una nota que recuerdas a medias
Hace tiempo guardé algo sobre una palabra que significaba «caminar sin rumbo». Búscala en mi Notebase de inglés.
list_notes · notes:read
La búsqueda es una subcadena literal, sin distinguir mayúsculas, de al menos dos caracteres, funciona sobre un Notebase a la vez y solo mira dentro de los campos de texto: un valor numérico, de fecha, de casilla o de selección nunca coincidirá. Para algo menos exacto, pídele al asistente que enumere el Notebase y lo juzgue él mismo.
Dar forma al Notebase
Que el asistente diseñe un Notebase y sus campos
Estoy empezando con el japonés. Móntame un Notebase para eso con los campos que tú querrías para vocabulario, pero cuéntame el plan antes de crear nada.
create_notebase → create_notebase_field · notebases:write
create_notebase crea un Notebase vacío, opcionalmente con sus primeros campos; las notas son siempre un paso aparte. Pedir el plan primero merece el turno extra, porque el tipo de un campo no se puede cambiar después: solo su nombre y sus opciones.
Generar una plantilla de tarjeta
Mira mi Notebase de japonés y monta una tarjeta de reconocimiento: la palabra en el anverso, el significado y el ejemplo en el reverso.
get_notebase_schema → create_card_template · card_templates:write con notebases:read
Las plantillas referencian los campos por ID, y por eso la lectura de la estructura va primero. Crear una plantilla genera tarjetas para todas las notas que ya haya en el Notebase, así que un Notebase de 400 notas gana 400 tarjetas en el momento en que aterriza la plantilla.
Arreglar una plantilla que se renderiza mal
El reverso de mis tarjetas de japonés muestra el campo en bruto en lugar de la frase de ejemplo. Mira una tarjeta y arregla la plantilla.
get_card → get_card_template → update_card_template · card_templates:write con notes:read y study:read
get_card es lo que hace esto posible: devuelve el anverso y el reverso ya renderizados, así que el asistente puede ver la salida real en lugar de razonar sobre el patrón en abstracto.
Ordenar los campos
El campo «categoría gramatical» de mi Notebase de inglés es texto libre y es un desastre. Conviértelo en una selección con las opciones que se usan de verdad.
get_notebase_schema → list_notes → update_notebase_field · notebases:write con notes:read
El tipo de un campo es fijo, así que esto es renombrar y reconfigurar, no convertir. Quitar una opción de una selección borra ese valor de todas las notas que lo tuvieran, y un campo al que se refiera una plantilla no se puede eliminar en absoluto.
Rellenar lo que falta
Completar ejemplos, categoría gramatical y fonética
Repasa mi Notebase de inglés y rellena las notas a las que les falte la frase de ejemplo, la categoría gramatical o la fonética. No toques nada más.
list_notes → update_note · notes:write
update_note fusiona: los campos que no menciones conservan sus valores, y null borra uno a propósito. Cada actualización lleva la marca de tiempo actual de la nota, así que si algo cambió entre medias la escritura falla en lugar de sobrescribir tu edición; el asistente debería volver a leer esa nota y reintentarlo. Esto funciona nota a nota, así que espera que vaya recorriendo un Notebase grande por lotes.
Estudiar
Qué debería repasar hoy
¿Qué me espera hoy, y cuánto tiempo me va a llevar más o menos?
get_study_stats → list_cards · study:read con notes:read para el contenido de las tarjetas
get_study_stats te da los recuentos de cola por Notebase para un día determinado, y list_cards puede filtrar por estado de programación para mostrar qué contienen esos recuentos.
No hay ninguna herramienta de cola de repaso. Una lista de tarjetas pendientes no es el orden que te daría la pantalla de repaso: la aplicación aplica tus límites diarios, las reglas entre tarjetas hermanas y su propio orden, y nada de eso se reproduce enumerando tarjetas. Tómalo como una vista previa de la carga de trabajo, no como la cola en sí.
Repasar dentro de la conversación
Pregúntame diez tarjetas pendientes de mi Notebase de japonés. Muéstrame el anverso, espera mi respuesta y luego registra cómo me ha ido.
list_cards → record_review → undo_review · study:write con notes:read
Esto funciona, y es la receta con la que hay que ser más consciente. Cada calificación que registra el asistente es un repaso real: FSRS actualiza con ella la estabilidad, la dificultad y la próxima fecha de la tarjeta, exactamente igual que si hubieras pulsado el botón tú. Registrar un repaso también necesita una zona horaria, porque decide a qué día de estudio pertenece el repaso; si tu cuenta nunca ha guardado ninguna, la llamada falla y la pide en lugar de adivinar. undo_review deshace el último repaso de una sola tarjeta cuando te calificaron mal, y solo ese.
Omitir o suspender una tarjeta demasiado difícil
Esa última tarjeta no se me queda y no dejo de fallarla. Sácala de la rotación por ahora.
set_card_suspended / set_card_buried · study:write
Omitir oculta una tarjeta durante el resto del día; suspender la saca hasta que la vuelvas a poner. Las dos cosas son reversibles con las mismas herramientas.
Revisar mi progreso reciente
¿Cómo han ido las dos últimas semanas? ¿Hay algo que falle de forma sistemática?
get_study_stats → list_review_history · study:read
list_review_history devuelve tus registros de repaso —calificaciones y tiempos, filtrables por Notebase o por tarjeta— sin contenido de notas. Combínalo con list_cards si quieres que el asistente nombre las palabras que no dejas de fallar, lo que añade notes:read.
Cambiar los límites diarios
Veinte tarjetas nuevas al día son demasiadas con todo lo que tengo encima. Redúcelo a la mitad en mi Notebase de japonés.
get_study_settings → update_study_settings · study:write
Estas dos solo llegan al límite diario de tarjetas nuevas, al límite diario de repasos y a la retención deseada. No pueden renombrar ni eliminar nada.
Mantenimiento
Comprobar qué cuenta está conectada
¿A qué cuenta de Read Frog estás conectado?
whoami · account:read
Merece un turno cuando tienes más de una cuenta, o antes de dejar que un asistente escriba nada.
Limpiar lo que ya no quieres
Tengo entradas duplicadas en mi Notebase de inglés. Enuméralas y borra las redundantes, pero enséñame la lista primero.
list_notes → delete_note · notes:write
Aquí las eliminaciones son permanentes y van en cascada: una nota eliminada se lleva consigo sus tarjetas y su historial de repaso. delete_notebase va más allá y elimina el Notebase entero: campos, notas, plantillas, tarjetas y registros de repaso. Pide la lista antes del borrado.