활용 예시

아래 예시마다 실제로 입력할 수 있는 프롬프트, 어시스턴트가 쓰게 될 도구, 그리고 그 일이 돌아가는 데 필요한 최소 권한을 적어 두었습니다. 실제로 쓰는 예시에 필요한 것만 허용하세요 — 각 허용이 어떤 대가를 갖는지는 권한 그룹에서 다룹니다.

거의 모든 예시에 해당하는 이야기가 하나 있습니다. 노트는 필드 이름이 아니라 필드 ID를 기준으로 저장되므로, 제대로 동작하는 어시스턴트는 첫 쓰기 전에 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

템플릿은 필드를 ID로 참조하므로 구조를 먼저 읽습니다. 템플릿을 만들면 그 Notebase에 이미 있는 모든 노트에 대해 카드가 생성되므로, 노트가 400개인 Notebase는 템플릿이 만들어지는 순간 카드 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

오늘 건너뛰기는 그날 남은 시간 동안 카드를 숨기고, 영구 중지는 다시 되돌려 놓을 때까지 카드를 빼 둡니다. 둘 다 같은 도구로 되돌릴 수 있습니다.

최근 진행 상황 살펴보기

지난 2주는 어땠나요? 계속 틀리는 게 있나요?

get_study_stats → list_review_history · study:read

list_review_history는 내 복습 기록 — 평가와 소요 시간, Notebase나 카드로 걸러 볼 수 있습니다 — 을 노트 내용 없이 돌려줍니다. 계속 틀리는 단어를 어시스턴트가 짚어 주기를 원한다면 list_cards와 함께 쓰면 되고, 그러면 notes:read가 추가됩니다.

일일 한도 바꾸기

다른 일도 많은데 하루 새 카드 20장은 너무 많아요. 일본어 Notebase는 절반으로 줄여 주세요.

get_study_settings → update_study_settings · study:write

이 두 도구는 일일 새 카드 한도, 일일 복습 카드 한도, 목표 기억 유지율에만 닿습니다. 무엇의 이름을 바꾸거나 삭제할 수는 없습니다.

정리

어떤 계정에 연결되어 있는지 확인하기

지금 어느 Read Frog 계정에 연결되어 있나요?

whoami · account:read

계정이 두 개 이상일 때, 또는 어시스턴트에게 무언가를 쓰게 하기 전에 한 턴 쓸 만합니다.

더 이상 필요 없는 것 지우기

내 영어 Notebase에 중복된 항목이 있어요. 나열하고 불필요한 것을 지워 주세요. 단, 목록을 먼저 보여 주세요.

list_notes → delete_note · notes:write

여기서의 삭제는 영구적이고 연쇄적입니다. 삭제된 노트는 그 카드와 카드의 복습 기록까지 데려갑니다. delete_notebase는 더 나아가 Notebase를 통째로 없앱니다 — 필드, 노트, 템플릿, 카드, 복습 기록까지. 삭제 전에 목록을 먼저 요청하세요.