📥 프로젝트 소스: 들어온 모든 파일을 날짜별로

모든 프로젝트에는 두 영역이 있습니다.

• 소스 — 나와 팀이 제공한 모든 파일. Telegram 그룹, Google 드라이브 폴더, 이 컴퓨터의 폴더에서 들어온 파일, Drive 소스가 **파일 한 번 가져오기…**로 가져온 파일, 직접 추가한 파일입니다. 디스크에서는 프로젝트의 sources/ 폴더입니다.
• 작업 — 그 밖의 모든 것. 나와 에이전트가 자유롭게 정리하며 정해진 폴더는 없습니다. 정기 보고서는 다른 곳을 지정하지 않으면 reports/<YYYY-MM>/에 저장됩니다.

프로젝트에는 숨김 폴더 .amba/도 있어 AMBA가 자체 상태(프로젝트에 대해 파악한 내용, 파일의 이전 버전)를 보관합니다. 열어 볼 필요는 없습니다.

파일 트리에서는 두 영역이 소스(소스 → 날짜)와 작업(자유로운 트리)으로 표시됩니다.

---

1. 에이전트는 소스를 절대 바꿀 수 없습니다

에이전트, 프로세스, Office 처리 엔진, 모델이 작성한 스크립트, 테스트 실행은 소스를 읽을 수는 있지만 소스나 .amba/ 안에서 쓰기, 이동, 이름 바꾸기, 삭제를 전혀 할 수 없습니다. 이는 모든 파일 작업과 모든 모드에서 앱이 강제하는 규칙으로, 설정이 아니며 어떤 권한이나 승인으로도 해제할 수 없습니다. 결과는 항상 작업 영역의 새 파일로 저장됩니다.

프로젝트 밖에 있는 파일(Drive 폴더, 컴퓨터의 폴더)은 소스로 복사되며, 원본은 그대로 남고 절대 손대지 않습니다.

2. 소스 파일은 직접 수정할 수 있습니다

소스는 에이전트에게만 읽기 전용이며, 사용자에게는 아닙니다. 파일을 직접 고치면(예: Excel에서):

• AMBA가 이전 버전을 보관합니다. 파일 트리에서 그 파일에 기록 아이콘이 붙고, ⋯ → 파일 기록에서 이전 버전을 볼 수 있습니다.
• 이전 버전에 기반한 수치와 보고서는 다시 확인하도록 표시됩니다. 그 파일의 날짜에는 *""…" 파일이 보고서 "…"에 사용된 뒤 바뀌었습니다 — 다시 실행하세요"*와 다시 실행 버튼이 나타납니다.

앱에서 소스 파일을 삭제할 수도 있으며, 그 내용은 기록에 남습니다.

3. '최종본'은 폴더가 아니라 상태입니다

프로세스가 전달한 파일, 또는 직접 표시한 파일(파일 트리의 최종본으로 표시, 취소는 최종본 표시 해제)이 최종본입니다. 최종본 파일은 어디에 저장되어 있든 최종본 배지가 붙습니다. 원한다면 나만의 final/ 폴더를 계속 써도 됩니다.

4. 파일 종류

파일이 들어오면 AMBA는 AI 없이 다음을 기록합니다.

• 파일이 속한 영업일(내용, 제목, 파일 이름, 함께 온 메시지, 받은 시각으로 판단)
• 종류(예: "매출 보고서", "비용"). 파일의 구조(시트 이름, 열, 제목)로 알아봅니다
• 보낸 사람, 중복인지, 이미 받은 파일의 새 버전인지
• 어느 프로세스 실행이나 보고서에서 언제 사용했는지

새 구조의 파일이 처음 들어오면 AMBA가 한 번만 제안과 함께 이 파일은 어떤 종류인가요? 하고 묻습니다(내 Telegram 채팅에서도). 한 번 이름을 붙이면 이후 같은 종류의 파일은 자동으로 알아봅니다. 데모 매장에서는 두 종류에 이름을 붙이는 것만으로 43개 파일이 모두 분류되었습니다. 프로젝트 설정 → 파일 종류에서 AMBA가 익힌 종류의 이름을 바꾸거나 합칠 수 있습니다.

5. 소스는 파일 트리의 항목입니다

파일 트리의 소스 아래에서 소스마다 하나의 항목이 됩니다. 예: Telegram · 회계 그룹, Drive · 지점 보고서, 폴더 · 청구서. 항목에는 상태 점이 있습니다. 초록은 받는 중, 노랑은 확인 필요(아직 파일 없음, 일시 중지, 일시적 오류), 빨강은 받기가 멈춘 상태(다시 로그인 필요, 봇이 그룹을 읽지 못함, 폴더가 없음)입니다. 직접 추가한 파일은 직접 업로드에 있습니다.

각 소스 아래에는 날짜가 있고, 오른쪽의 작은 배지는 그 소스의 파일만 셉니다.

배지	의미	클릭하면
✓	그날의 파일이 보고서에 사용됨	어떤 보고서, 언제, 어떤 실행인지
종류 불명 N	새 형식의 파일이 있음	이 파일은 어떤 종류인가요? — 그 자리에서 답하기
날짜 필요 N	날짜가 불분명한 파일이 있음	날짜 선택(또는 날짜 없음)
⚠	파일은 있지만 보고서가 없거나, 보고서 후 파일이 바뀜	이유와 해결 버튼: 지금 실행, 다시 실행, 프로세스 보기, 다시 로그인

배지에 마우스를 올리면 이유를 읽을 수 있고, 모든 해결은 트리에서 두 번 클릭 이내입니다. 종류를 모르는 파일에는 작은 점이 붙습니다. 파일의 ⋯ → 파일 기록에서 그 파일을 사용한 보고서와 AMBA가 보관한 이전 버전을 볼 수 있습니다.

소스 열기

소스를 클릭하면 파일처럼 탭으로 열립니다(닫기, 다시 열기, 전환). 본문은 가져오기 기록으로, 최신순·날짜별입니다. AMBA가 소스를 확인할 때마다 시각과 하나의 결과가 한 줄이 됩니다.

• ✓ 새 파일 N개 — 파일 이름과 보낸 사람(Telegram 그룹) 또는 "폴더에서"
• – 새 파일 없음 — 아무것도 없는 확인이 이어지면 한 줄로 묶습니다: 새 파일 없음 (17회)
• ⚠ N개 건너뜀 — 이유와 함께: 이미 있는 파일과 같은 내용, 너무 큼(Telegram 봇은 최대 20 MB), AMBA가 읽지 않는 형식(설치 프로그램), Office 임시 파일(~$…), 다운로드할 수 없는 Google 파일
• ✗ 파일 N개를 다운로드하지 못했습니다 — 다음 ‘파일 가져오기’ 때 다시 시도합니다 — 네트워크 끊김, Telegram이나 Google의 일시적인 오류, 다른 프로그램이 잡고 있는 파일 등. AMBA는 그 파일을 기억했다가 이후 파일 가져오기 때마다 먼저 다시 받습니다. 받으면 새 줄에 다시 시도해 N개 받음이 표시되고 파일은 보낸 날짜로 들어갑니다. 5번 다시 시도해도 안 되면 파일 이름과 다시 시도 버튼이 표시됩니다. 일부러 건너뛴 파일(중복, 너무 큼, 읽지 않는 형식)은 다시 시도하지 않습니다.
• ✗ 오류 — 예: Google에 다시 로그인해야 합니다, 다시 로그인 버튼과 함께. 같은 오류의 반복은 묶습니다: 06:00부터 12회 반복

종류를 모르는 파일의 줄에는 분류 버튼이 있습니다. 아래로 스크롤(또는 더 보기)하면 이전 기록이 보입니다. 기록은 90일 동안 보관됩니다.

탭 오른쪽의 설정 버튼으로 설정 패널을 열고 닫으며, 선택은 기억됩니다. 패널은 소스 종류에 따라 다릅니다.

• Telegram 그룹 — 봇, 그룹(이름으로 선택), 날짜가 불명확하면 묻기(나, 디렉터리의 누군가, 묻지 않음), Telegram에서 파일 종류 묻기
• Google 드라이브 폴더 — 계정(Google이 요구하면 그 자리에서 다시 로그인), 폴더(이름으로 선택), 이미 있는 파일도 가져오기
• 이 컴퓨터의 폴더 — 경로, 이미 있는 파일도 가져오기

모든 종류에 파일 정리 방식이 있습니다. AMBA는 Drive 폴더와 이 컴퓨터의 폴더의 모든 단계 하위 폴더를 읽습니다. 위를 가리키는 폴더는 한 번만 읽고, 파일 가져오기 한 번에 최대 5,000개 파일을 가져옵니다(나머지는 다시 누르세요).

아래에는 확인, 일시 중지 / 재개, 소스 삭제가 있습니다.

파일 정리 방식

파일 정리 방식은 소스의 파일이 그 소스 자신의 폴더 안에서 어떤 폴더에 놓일지 정합니다.

• 일별(기본) — 업무일마다 폴더 하나(2026-10-07)
• 월별 — 월마다 폴더 하나(2026-10)
• 연도별 — 연도마다 폴더 하나(2026)
• 원래 폴더 유지(Drive 폴더와 이 컴퓨터의 폴더만) — 소스와 같은 폴더 구조(예: Kế toán/Tháng 10/…)

일·월·연도별로 정리할 때 날짜를 모르는 파일은 날짜 미정에 들어갑니다. 각 파일의 업무일, 종류, 날짜 배지, 프로세스가 읽는 것은 정리 방식과 관계없습니다. 월·연도별 또는 원래 폴더로 정리하면 날짜 배지가 소스 탭 위쪽(업무일별)에도 표시되고, 트리의 월·연도 폴더에는 그 날짜들의 배지가 모여 붙습니다.

새 정리 방식은 새 파일에 적용됩니다. 설정에서 바꾸고 저장하면 이미 있는 파일을 지금 다시 정리할지 새 파일에만 적용할지 묻습니다. 다시 정리…(트리나 탭에서 소스의 ⋯)로 언제든 같은 일을 할 수 있습니다. 방식을 고르고 파일 N개를 폴더 M개로 옮깁니다를 확인한 뒤 실행합니다. 한 폴더에 같은 이름의 파일이 두 개면 둘 다 남고 두 번째에 *(2)*가 붙습니다. 사실, 보고서, 파일 기록, 대화 속 언급은 파일의 새 위치를 따라갑니다. 바뀌는 것은 소스 자신의 폴더뿐이며, 에이전트와 프로세스는 여전히 소스의 파일을 옮길 수 없습니다.

소스와 그 파일 삭제

소스는 스스로 받은 파일과 한 번 가져온 파일을 모두 포함해, 가져온 파일을 소유합니다. 소스 삭제는 확인을 묻고, 이 소스가 가져온 파일 N개도 삭제(용량 포함)가 미리 선택되어 있습니다.

• 선택한 채로: 그 파일, AMBA가 보관한 이전 버전, 가져오기 기록이 완전히 삭제됩니다. 이 파일을 사용한 사실이나 보고서가 있으면 다시 확인해야 한다고 대화 상자에 표시됩니다.
• 선택 해제: 새 파일 받기를 멈추고, 이미 가져온 파일은 삭제된 소스 · <이름> 아래 소스에 남습니다. 이 항목도 탭으로 열리며 나중에 삭제할 수 있습니다.

프로세스가 읽고 있는 소스는 삭제할 수 없으니 먼저 그 프로세스의 파일 가져오기 단계에서 소스를 빼세요. 다른 앱에서 열려 있어 아직 삭제하지 못한 파일이 있으면 AMBA가 이름을 알려 주고 다음 실행 때 다시 시도합니다. 직접 업로드의 파일은 전처럼 하나씩 삭제할 수 있습니다. 에이전트와 프로세스는 소스 안의 어떤 것도 삭제할 수 없습니다.

직접 업로드도 탭으로 열려, 추가한 파일을 시간순으로 보여 줍니다.

파일 가져오기

AMBA는 백그라운드에서 소스를 읽지 않습니다. 파일은 요청할 때, 또는 그 소스를 읽는 프로세스가 실행될 때 소스에 들어옵니다.

• 소스 탭 위쪽의 파일 가져오기(또는 파일 트리의 소스 항목에서 ⋯ → 파일 가져오기, 마우스 오른쪽 클릭도 가능)는 그 소스를 한 번 읽습니다. 실행 중에는 **파일 가져오는 중…**이 표시되고, 끝나면 결과(새 파일 2개를 가져왔습니다, 새 파일 없음)가 나타나며 기록에 수동으로 가져옴 항목이 추가됩니다. 같은 봇을 쓰는 Telegram 그룹은 함께 가져옵니다.
• 소스 위쪽의 ⋯ → 모든 소스에서 파일 가져오기는 프로젝트의 활성 소스를 차례로 가져옵니다.
• 이전 버전에서 “파일이 들어오면 실행”으로 만든 프로세스(지금은 고급 단계)는 가져온 파일이 도착하면 그대로 시작됩니다. 새 프로세스는 일정에 따라 실행됩니다.
• Telegram은 메시지를 약 24시간만 보관합니다. Telegram 소스를 20시간 넘게 가져오지 않으면 탭에 마지막 가져오기: N시간 전 — Telegram은 메시지를 약 24시간만 보관합니다가 표시되고 점이 노란색이 됩니다. 24시간이 지나면 빨간색으로 바뀌며 24시간보다 오래된 메시지는 사라졌을 수 있습니다가 표시됩니다. 하루에 한 번 이상 가져오세요.
• 프로세스는 ‘파일 가져오기’ 단계로 가져옵니다. 프로세스는 파일 가져오기 단계가 실행될 때(일정에 따라, ▶ 전체 프로세스 실행으로, 또는 그 단계의 ▶(이 단계 실행)로)만 소스를 읽습니다. 파일 가져오기 버튼과 똑같이 바로 가져오며 기다리지 않습니다. 나중에 다시 보려면 대기와 파일 가져오기 단계를 하나 더 추가하세요. 기록에는 프로세스 …에서 가져옴이 표시됩니다. 단계별 테스트에서는 테스트 전에 파일 가져오기를 선택했을 때만 소스를 읽습니다.
• AMBA는 아직 Telegram으로 질문을 보내지 않으며(파일 날짜와 종류는 앱에서 묻습니다), 프로세스의 소유자와의 Telegram 대화는 계속 일시 중지됩니다(일시 중지됨(자동 가져오기 필요)).

소스 추가

소스 제목의 **⋯**에는 파일 업로드와 소스 추가 ▸ Telegram · Drive · 폴더가 있습니다. 소스 추가는 설정 패널이 있는 새 탭을 엽니다. 소스 추가를 누르면 소스가 트리에 나타나고 탭이 그 소스의 탭이 됩니다. Telegram 그룹을 추가하면 그 그룹이 프로젝트 디렉터리에도 (한 번) 저장되어 프로세스에서 이름으로 부를 수 있습니다.

Drive에서 한 번 가져오기. Google Drive 소스를 열고 탭 위쪽의 **파일 한 번 가져오기…**를 누릅니다. Drive 브라우저가 소스의 폴더에서 열리며, 그 Google 계정 안 어디에서든 이름으로 파일을 고를 수 있습니다. 파일은 그 소스로 복사되고, 받은 파일처럼 날짜별로 정리·분류됩니다. 가져오기 기록에는 한 번 가져오기: 파일 N개로 표시됩니다. Drive 소스가 없다면 먼저 추가하세요.

예전에 Drive에서 가져온 파일. 예전에는 한 번 가져온 파일이 별도 항목에 있었습니다. 프로젝트를 열면 같은 Google 계정의 Drive 소스가 정확히 하나일 때 AMBA가 그곳으로 자동으로 옮깁니다(프로세스와 파악한 사실도 함께 바뀝니다). 그렇지 않으면 Drive에서 가져옴 (이전) 아래에 나타나며 **소스로 옮기기…**와 삭제를 쓸 수 있습니다.

특정 날에 속하지 않는 파일(직원 명단, 가격표)은 소스의 날짜 없음 폴더나 직접 업로드에 있습니다. 프로세스 → 소스와 파일 소스도 참고하세요.

Telegram 소스에 파일이 들어오지 않을 때

소스 탭에 이유가 표시되고, 설정 패널에 해결 버튼이 있습니다.

• 키체인 접근이 허용되지 않음 — macOS가 봇 토큰 읽기를 막았습니다. 키체인 접근 허용을 누르고, macOS가 물으면 항상 허용을 선택한 뒤 Mac 암호를 입력하세요. 확인을 눌러도 다시 시도합니다. ‘파일 가져오기’를 눌러도 한 번 다시 시도합니다.
• 연결 안 됨 / 봇 토큰이 더 이상 유효하지 않음 — 봇 토큰 다시 입력을 누르고 @BotFather의 토큰을 붙여 넣으세요.
• 봇이 웹훅을 사용 중 — 봇의 메시지가 다른 서비스로 전달되고 있습니다. 확인 후 웹훅 끄기를 하면 AMBA가 그룹을 읽을 수 있습니다. 그 서비스를 더 이상 쓰지 않을 때만 끄세요.
• 다른 프로그램이 이 봇을 읽는 중 — 그 프로그램(또는 실행 중인 다른 AMBA)을 끄거나 봇에서 다른 봇을 선택하세요. 봇을 바꾸면 그룹을 처음부터 다시 읽습니다.
• 그룹 목록이 비어 있음 — 봇을 그룹에 추가하거나 그룹에서 메시지나 /start를 보낸 뒤 다시 불러오기를 누르세요.

일시적 오류 — ‘파일 가져오기’를 눌러 다시 시도하세요는 네트워크나 Telegram이 잠시 끊겼을 때만 표시됩니다.

6. 0.5.13 이전 버전에서 만든 프로젝트

이전 프로젝트는 세 개의 고정 폴더(input/, workings/, output/)를 사용했습니다. 업데이트 후 처음 시작할 때 AMBA가 한 번만 옮깁니다.

• input/ 중 소스에서 들어온 파일은 소스의 해당 소스 날짜로 옮깁니다.
• input/의 나머지는 하위 폴더를 유지한 채 sources/uploads/로 옮깁니다.
• workings/와 output/는 그대로, 작업 영역의 일반 폴더로 남습니다.

한 번만 나오는 알림 받은 파일이 이제 소스에 있습니다에서 옮긴 파일 수를 알려 줍니다. 프로세스, 파악한 사실, 파일 참조도 함께 업데이트되므로 다시 설정할 필요가 없습니다. 옮길 수 없는 파일이 있으면(예: 이름은 같지만 내용이 다른 파일이 이미 소스에 있는 경우) 아무것도 옮기지 않고 알림에 이유가 표시됩니다.