프로젝트: 소스와 작업 공간
경영진 문서철(Executive Dossier)은 AMBA의 핵심 업무 공간 아키텍처입니다. 문서를 일시적인 웹 세션이나 클라우드 저장소에 보관하는 기존 챗봇과 달리, AMBA는 사용자 컴퓨터의 실제 로컬 폴더에 프로젝트를 고정하고 이를 소스와 작업 공간의 두 영역으로 체계화합니다.
모든 기업 데이터는 사용자 PC에서 100% 로컬로 안전하게 유지·처리되며, 민감한 비즈니스 자산이 외부 클라우드로 유출될 위험이 전혀 없습니다.
📂 소스와 작업 공간
AMBA의 각 프로젝트 폴더에는 두 가지 영역이 있습니다.
내 프로젝트 폴더 /
├── 📥 소스 (sources/) (사용자나 채널이 제공한 모든 파일 — 에이전트는 읽기 전용)
│ ├── uploads/ 직접 추가한 파일
│ └── <소스>/<YYYY-MM-DD>/ Telegram, Drive, 폴더에서 들어온 파일(날짜별)
└── 🗂️ 작업 공간 (그 밖의 모든 것 — 원하는 방식으로 정리)
├── reports/ 기본 산출물 위치(정기 보고서는 reports/<YYYY-MM>/)
└── workings/ 초안, 계획서, 임시 파일1. 📥 소스 — 안전하게 봉인된 원본 보관소
모든 입력 자료는 여기에 있습니다.
- 은행 입출금 거래 내역 엑셀 파일(
.xlsx,.csv) - 전자세금계산서, 매입/매출장, 영수증(
.pdf,.csv) - 고객사 제안요청서(RFP), 과업지시서, 거래처 견적서
- 매체 단가표 및 사내 운영 가이드라인
앱에서 추가한 파일은 sources/uploads/에 보관됩니다. 연결된 소스(Telegram 그룹, Google Drive 폴더, 로컬 폴더)에서 들어온 파일은 소스와 해당 날짜별로 정리됩니다(예: sources/<소스>/2026-10-07/). 파일 트리에서 소스마다 항목이 있고 그 아래에 날짜가 있습니다. 소스를 클릭하면 가져오기 기록(들어온 것, 건너뛴 것과 이유)을 볼 수 있습니다.
읽기 전용 안전 보장
AMBA는 소스(PC의 sources/ 폴더)를 모든 모드에서 에이전트에 대해 엄격한 읽기 전용으로 설정합니다. AI 어시스턴트는 문서를 읽고, 데이터를 추출하고, 분석할 수는 있지만, 소스의 파일을 수정·덮어쓰기·이동·삭제하는 것은 원천 차단되며 결과는 항상 작업 공간의 새 파일에 기록됩니다. 소스 파일을 사용자가 직접 편집할 수는 있으며, AMBA는 이전 버전을 보관하고 그 파일에서 가져온 수치를 재확인 필요로 표시합니다.
2. 🗂️ 작업 공간 — 원하는 방식으로 정리
소스 밖의 모든 것이 작업 공간입니다. 필수 하위 폴더는 없으며, 사용자와 에이전트가 자유롭게 정리하고 산출물은 요청한 위치에 저장됩니다. 따로 지정하지 않으면 AMBA는 두 가지 관례를 따릅니다.
- 보고서 폴더
reports/: 완성된 산출물 — 엑셀(.xlsx), Word 문서(.docx), 슬라이드, PDF 보고서. 정기 보고서는 월별 폴더(예:reports/2026-10/)에 저장됩니다. workings/: 어시스턴트의 작업대 — 단계별 실행 계획서(workings/plans/), 초안(workings/drafts/), 수식 검증용 중간 계산 테이블 및 대조 작업 시트.
클린 데스크 모드 (Clean Desk Mode)
작업 공간을 항상 쾌적하게 유지하기 위해, AMBA는 클린 데스크 모드를 기본으로 적용합니다. workings/의 내부 임시 로그나 백그라운드 데이터베이스 파일은 자동으로 숨겨져, 진행 중인 계획서와 핵심 증적 파일에만 집중할 수 있습니다. 시스템 파일을 확인하고 싶을 땐 언제든 모두 표시를 누르면 됩니다.
3. ✅ 최종본은 폴더가 아니라 상태입니다
산출물은 프로세스가 전달했거나 사용자가 파일 트리에서 최종본으로 표시하면 최종본이 됩니다. 저장 위치와는 관계없습니다. 원한다면 자신만의 final/ 폴더를 계속 사용할 수도 있습니다.
실제 파일 검증 보장
작업이 완료되기 전, 시스템은 해당 실행이 작업 공간에 기록한 산출물을 실제 PC 디스크에서 물리적으로 검증합니다. 빈 파일이나 손상된 파일을 원천 차단하며, 엑셀, 워드, PDF 뷰어에서 즉시 열어 활용할 수 있는 정상 파일만 안전하게 납품됩니다.
버전 0.5.13 이전에 만든 프로젝트
이전 프로젝트는 세 개의 고정 폴더(input/, workings/, output/)를 사용했습니다. AMBA가 한 번 자동으로 옮겼습니다. input/의 파일은 소스(sources/uploads/…, 소스에서 들어온 파일은 sources/<소스>/<날짜>/)로 이동했고, workings/와 output/는 작업 공간의 일반 폴더로 그대로 남아 있습니다.
⚙️ 간결한 3탭 구성의 프로젝트 설정
AMBA의 프로젝트 관리는 비개발자 실무자도 쉽게 이해할 수 있도록 설계되었습니다. 헤더의 프로젝트 설정 아이콘을 클릭하면 핵심 기능만 모은 3개의 탭이 나타납니다:
- 일반 설정 (General):
- 프로젝트 이름 및 설명.
- AI 모델: 기본값 따르기 (…) 는 설정 → AI 모델을 따릅니다. 모델을 고르면 프로젝트 자체 모델이 됩니다. 채팅에서 모델을 고른 에이전트는 그 선택을 유지합니다 (에이전트 → 프로젝트 → 기본값).
- 보고서 산출물 언어 선택(
ko,en,vi,ja). - 로컬 컴퓨터의 실제 프로젝트 폴더 경로 관리.
- 권한 및 보안 (Permissions & Security):
- 직관적인 허용(Allow) 및 차단(Deny) 스위치 컨트롤.
- 파일시스템 샌드박스, 웹 검색 및 시장 정보 수집, MCP 플러그인 권한 제어.
- 위험 구역 (Danger Zone):
- 실수를 방지하는 2단계 확인 잠금장치가 포함된 안전한 프로젝트 삭제.
네이티브 코어 설계의 이점
AMBA에서는 스프레드시트 수식 연산과 대사용 SQL 엔진이 고성능 Rust 런타임에 기본 내장되어 있으며, 업무 일정 및 스케줄링은 전문 에이전트 설정, 프로세스, 소스가 직접 담당합니다. 따라서 복잡한 기술 설정 탭을 모두 걷어내고 가장 간결하고 명확한 설정 경험을 제공합니다.
🖱️ AMBA Studio에서의 간편한 사용
데스크톱 앱 화면에서 손쉽게 작업할 수 있습니다.
- 드래그 앤 드롭: 바탕화면의 계약서나 엑셀 파일을 소스로 바로 끌어다 놓으세요(
sources/uploads/에 보관됩니다). - 로컬 폴더 즉시 열기: 상단 폴더 아이콘을 클릭하면 macOS Finder나 Windows 탐색기에서 실제 프로젝트 폴더가 바로 열립니다.
- 원클릭 미리보기 및 인쇄: 최종 산출물을 클릭하여 즉시 내용을 확인하고, 기본 오피스 앱으로 실행하거나 PDF로 바로 인쇄할 수 있습니다.
🧠 에이전트가 프로젝트를 아는 방법
에이전트는 프로젝트 내용을 추측하지 않습니다. 실행할 때마다 AMBA는 이 컴퓨터의 파일로 만든, 출처가 있는 짧은 요약을 에이전트에게 전달합니다.
- 파일: 통합 문서마다 시트, 머리글 행, 열(숫자·날짜·텍스트), 행 수, 날짜 범위, 합계 행. 문서와 슬라이드의 제목과 목차. 수신 파일의 영업일. 통화와 숫자 표기 방식.
- 파일에서 확인한 수치: 에이전트가 도구로 수치를 읽으면 출처(파일, 시트, 셀)와 함께 기록합니다. AMBA는 그 셀을 열어 값을 확인한 뒤 저장합니다. 완성된 결과의 핵심 수치도 같은 방식으로 저장됩니다.
- 내 규칙: 채팅에서 말한 내용("회계연도는 4월 시작", "항상 원화, 소수점 없이")은 내가 한 말 그대로 저장됩니다.
파일이 바뀌면 그 파일에서 가져온 수치는 다시 확인 필요로 표시되고 에이전트가 파일을 다시 읽습니다. 목록에 없는 것은 파일에서 읽거나 물어보며, 절대 추정하지 않습니다.
프로젝트 상단 → 에이전트가 아는 내용에서 전체를 볼 수 있습니다. 틀린 항목은 삭제하세요. 프로젝트 폴더(.amba/context.json, 숨김 파일)에 저장되어 프로젝트와 함께 이동하며, 선택한 AI 모델로 보내는 요청(개인정보 마스킹 적용) 외에는 컴퓨터 밖으로 나가지 않습니다.
이전 버전의 메모리
이전 버전에서는 별도의 메모리에 메모를 저장할 수도 있었습니다(답변의 지식으로 수집, 설정 → 메모리). 이제 AMBA는 새 메모를 그곳에 저장하지 않습니다. 에이전트가 프로젝트에 대해 알아야 할 내용은 에이전트가 아는 내용에 있습니다.
- 이전에 저장한 메모는 유지되며 계속 참조될 수 있습니다. 메모를 사용한 답변에는 **사용된 메모리 (n)**이 표시됩니다. 열면 각 메모가 보이며, 틀리거나 오래된 항목은 삭제할 수 있습니다.
- 채팅 세션을 초기화할 때 해당 에이전트 또는 프로젝트 전체의 메모리를 지울 수 있습니다.
- 한 프로젝트의 메모가 다른 프로젝트에서 일하는 에이전트에게 전달되는 일은 없습니다.