구축 사례: 비서 에이전트

비서 에이전트는 캘린더, 메일, 영수증 등 개인 데이터의 핵심을 다룹니다. 이 구축 사례에서는 설계 단계로 넘어가기 전, 초기 인터뷰 단계에서 작업별로 어디까지 권한을 넘길지를 먼저 정리합니다.

도구는 단 두 가지

도구	역할	비유하자면
Chat Claude (claude.ai)	대화를 통해 "무엇을 만들지" 결정합니다. 설계/사양 담당	건축가와의 기획 회의
Claude Code in VS Code	확정된 설계를 바탕으로 실제 파일을 만들고 코드를 작성합니다	현장의 시공업자

기본 워크플로우

Chat Claude와 대화 → "무엇을 만들지" 사양을 확보
Chat Claude가 그 사양을 지시서(TASK.md)로 변환
TASK.md를 VS Code의 Claude Code에 전달 → 실제로 구축
결과를 Chat Claude에 보고 → 다음 지시서를 받음
완성될 때까지 1~4단계를 반복

비서 업무 정리하기 (인터뷰의 출발점)

"비서가 있었으면 좋겠다"는 말은 쉽지만, 실제로 무엇을 맡기고 싶은지를 말로 옮기는 것은 의외로 어렵습니다. 실제 비서 업무가 다루는 범위를 바탕으로, 인터뷰의 출발점을 정리했습니다.

일정 관리

일정 추가, 변경, 취소(소리 내어 말하면 캘린더에 등록)
일정 충돌 감지와 이동 시간을 고려한 현실적인 여유 확보
정해진 시각에 그날의 일정 읽어주기 — 아침 일찍, 또는 전날 밤
반복 일정, 그리고 공휴일과 휴무일 반영

경비 정산

영수증과 청구서 사진에서 날짜, 금액, 거래처, 항목 읽어내기
계정 과목과 세무 분류로 정리(최종 확인은 사람이 하는 것을 전제)
월별 집계와 제출 형식으로 내보내기
미처리 영수증이 쌓이면 알림

메일

수신 메일 분류(답장 필요 / 참고용 / 대응 불필요)와 우선순위 부여
답장 초안 작성(발송 여부는 원칙적으로 사람이 판단)
정형적인 문의에 템플릿 적용
답장 누락 감지(일정 시간이 지나도 응답이 없는 스레드 표시)

음성 회의록

녹음을 건네면 전사, 요점 정리, 보고서 작성을 하나의 연속된 작업으로 처리합니다 — 필요하다면 원하는 언어로 번역까지 함께
API를 하나도 추가하지 않고 구축할 수 있습니다. 전사는 로컬 Whisper 모델을 재사용하고, 요약과 번역은 모두 에이전트 자신의 LLM이 처리합니다
외국어로 진행되는 회의에서 특히 효과가 큽니다: 한 언어로 진행된 논의가 다른 언어로 된 보고서로 돌아오며, "다시 들은 뒤 번역한다"는 왕복이 사라집니다

회의 메모 정리, 각종 신청서 초안 작성, 항공편과 숙소 후보 추리기도 함께 다룰 수 있습니다. 출장 관련 기능은 필수가 아니므로, 업종 특성상 출장이 드물다면 처음부터 제외하세요.

왜 하나가 아니라 여러 에이전트로 나누는가

"비서 에이전트"라고 하면 무엇이든 하는 하나의 에이전트를 떠올리기 쉽습니다. 이 구축 사례에서는 대신 업무별로 나눌 것을 권장합니다.

업무마다 필요한 판단 기준이 다르기 때문

일정 관리에는 캘린더를 지나치게 채우지 않는 신중함이, 메일 분류에는 중요한 것을 놓치지 않는 폭넓음이 필요하며, 경비 업무는 숫자에 대한 엄격한 정확성을 무엇보다 우선합니다. 이 모두를 하나의 성격에 담으면 지시마다 기준이 흔들립니다

권한 범위를 분리할 수 있기 때문

메일 에이전트에게는 받은편지함 읽기 권한이 필요하지만, 경비 에이전트에게는 필요 없습니다. 나누면 각자가 최소한의 권한만 갖게 됩니다. 실제로 오작동이 일어나더라도 영향 범위가 그 에이전트의 영역 안에 머무릅니다

문제가 생겼을 때 원인을 특정하기 쉽기 때문

경비 집계가 이상해 보일 때, 역할이 나뉘어 있으면 어디를 봐야 할지 바로 알 수 있습니다. 하나의 에이전트에 전부 담겨 있으면 어떤 지시가 간섭했는지 추적하는 데 시간이 걸립니다

대략적인 기준: 일정 관리, 경비, 메일의 세 가지로 시작하는 것이 가장 다루기 쉬운 구성입니다. 처음부터 지나치게 세분화하면 관리 부담만 늘어나므로, 진행하면서 나누거나 합치세요.

음성으로 지시하고, 음성으로 보고받기

이 구축 사례의 핵심은 책상 앞에 없는 시간에도 비서가 계속 일한다는 점입니다. 이를 위해 디스코드를 음성이 양방향으로 오가는 창구로 만듭니다.

입력 방향(당신 → 에이전트)

디스코드의 음성 메시지 기능으로 녹음한 음성은 에이전트가 전사해 지시로 받아들입니다
전사는 로컬 Whisper 모델에서 동작하므로 음성이 어디로도 전송되지 않고 API 사용료도 들지 않습니다. 일정, 거래처 이름, 금액 같은 내용을 음성으로 다룰 때는 이 구성을 기반으로 삼으세요

출력 방향(에이전트 → 당신)

보고는 음성과 텍스트 양쪽으로 돌아옵니다 — 이동 중에는 음성을 흘려듣고, 나중에 확인하고 싶을 때는 텍스트를 따라가세요
어떤 음성 합성 엔진을 쓸지는 언어에 따라, 그리고 무엇이든 기기 밖으로 나가도 되는지에 따라 달라집니다. 하나의 엔진으로 정해 놓지 말고 여러 개를 들어 본 뒤 고르는 방식으로 접근하세요
판단 기준은 기계적으로 들리지 않아야 한다는 것입니다. 특히 금액과 날짜는 업무에 직결되므로, 실제로 사용할 형식을 반드시 테스트하세요

전체 일정 (6단계)

Phase	내용	사용 도구	산출물
Phase 0	요구사항 인터뷰(지금의 사무 작업, 무엇을 맡길지, 권한의 경계)	Chat Claude	요구사항 정리서
Phase 1	에이전트 구성 결정(몇 개로 나눌지, 에이전트별 권한 범위, 어떤 도구를 연동할지)	Chat Claude	구성 설계서
Phase 2	카세트 구축(SKILL.md/WORKFLOW.md와 전용 SPEC/soul.md가 모두 필요)	Chat Claude	SKILL.md, WORKFLOW.md, SPEC/soul.md
Phase 3	구현(반복 작업)과 음성 왕복 연결	Claude Code in VS Code	동작하는 카세트
Phase 4	테스트 및 검증	양쪽 모두	검증된 카세트
Phase 5	마무리 및 문서화	Chat Claude	완성품 + 사용 가이드

맡기고 싶은 내용은 사람마다 완전히 다르므로, 인터뷰를 건너뛰는 기성 TASK.md는 존재하지 않습니다. 반드시 Phase 0 요구사항 인터뷰부터 시작하세요.

지금 바로 시작: Phase 0 시작 프롬프트

아래 프롬프트를 그대로 복사해 "Chat Claude"(claude.ai)와의 새 대화에 붙여넣으면 Phase 0 요구사항 인터뷰를 시작할 수 있습니다.

일상적인 사무 작업(일정 관리, 경비 정산, 메일 등)을 대신 처리하는 비서 에이전트를 만들고 싶습니다. 저는 프로그래밍 초보자이므로, 당신(Chat Claude)이 설계/사양 파트너가 되어 주고, 구현은 VS Code의 Claude Code가 담당하는 방식으로 진행하고 싶습니다.

🔒

나머지 내용은 T1 구매 후 전체 가이드에서 확인할 수 있습니다.
(Phase 0 세부 인터뷰 항목, 권한 경계 설정 방법, 음성 왕복 구성, Phase 1 이후 지시서 템플릿을 포함한 전체 내용)

T1 구매하고 가이드 보기 →

면책조항 및 유의사항

처음에는 메일 자동 발송을 꺼 둘 것을 강력히 권장합니다. 에이전트가 초안을 쓰고 발송 여부는 직접 판단하세요 — 잘못 보낸 메일은 되돌릴 수 없습니다. 경비 정산의 금액과 세무 분류 역시 최종적으로는 신고하는 본인의 책임이므로, 에이전트는 집계와 분류라는 준비 작업을 맡고 최종 확인은 항상 사람이 하도록 설계하시기 바랍니다.

전체 구축 가이드

Phase 0 세부 인터뷰 항목, 권한 경계 설정 방법, 음성 왕복 구성, Phase 1 이후 지시서 템플릿까지 — 전체 내용을 BALIA OS 가이드 사이트에서 확인할 수 있습니다.

전체 구축 가이드 보기 →

다른 구축 사례 보기

같은 방식으로 구축된 다른 사례들 — 예약 관리 시스템, 커뮤니티/팬 사이트 자동 업데이트, 암호화폐 트레이딩 등 — 이 공개되었거나 준비 중입니다.

모든 구축 사례 보기 →

구축 사례:비서 에이전트.