Temp Files
경로: 하단 툴바 Temp Files
에이전트 세션의 임시 작업 공간. 사용자가 업로드한 파일과 함께, 에이전트가 도구 호출로 생성·수정한 모든 임시 파일도 이 패널에 그대로 가시화 됩니다. 작업 과정·산출물을 한곳에서 추적·다운로드할 수 있어, “에이전트가 뭘 만들었는지” 채팅 밖에서도 확인 가능합니다.
| 소스 | 예시 | 노출 위치 |
|---|
| 사용자 업로드 | CSV 드래그, 분석 데이터 투입 | 드롭한 폴더 (기본 Root) |
| 도구 호출 산출물 | generated_docxs/report.docx, generated_images/chart.png, analytics.duckdb 쿼리 결과 | 도구별 지정 폴더 |
| 중간 파일 | pptx_screenshots/slide_01.png, 변환된 HTML/PDF | 용도 폴더 |
| DuckDB 데이터 | analytics.duckdb · documents.duckdb | Root |
도구 호출과 Temp Files 는 실시간 동기화 됩니다. 에이전트가 create_file · write_file · html_to_pdf 등을 호출하는 순간, 해당 파일이 이 패널에 즉시 나타나고 크기·수정 시각이 표시됩니다. 채팅 응답에 언급되지 않은 부산물(중간 캐시·스크린샷) 까지 모두 확인할 수 있어 디버깅·감사에 유리 합니다.
UI 구성
| 영역 | 설명 |
|---|
| Search files… | 파일명·경로 실시간 필터 |
| Folders 패널 | 폴더 트리 — 각 폴더 옆에 아이템 수 뱃지 |
| Tools 체크리스트 | 현재 세션에서 활성화할 파일 도구 (최대 12 개) |
| 파일 드롭 영역 (Root) | Drop files here or click to upload — 드래그 앤 드롭 |
| 폴더 카드 | 폴더명 + N items |
| 파일 행 | 파일명 + 크기 (예: 347 B, 12 KB, 386.8 KB) |
기본 폴더 구조
세션 시작 시 자동 생성되는 폴더. 각 폴더는 전용 용도 로 매핑되어 있어 에이전트가 일관된 경로로 산출물을 저장합니다.
| 폴더 | 용도 | 주 사용 도구 |
|---|
| Root | 임의 업로드 / 자유 작업 공간 | 사용자 업로드 · 사용자 편집 |
| docx_data | DOCX 생성 입력 데이터 (CSV 등) | docx 도구 |
| docx_specs | DOCX 스펙 JSON | docx 도구 |
| docx_templates | DOCX 템플릿 ({{변수}} 포함) | docx 도구 |
| generated_docxs | 생성된 DOCX 결과물 | docx 도구 결과물 |
| generated_pptxs | 생성된 PPTX 결과물 | pptx 도구 |
| generated_images | 생성된 이미지 (Image-gen) | image-gen |
| generated_videos | 생성된 비디오 | 비디오 생성 도구 |
| pptx_screenshots | PPTX 슬라이드 스크린샷 | pptx 도구 |
| pptx_specs | PPTX 스펙 JSON | pptx 도구 |
| pptx_templates | PPTX 템플릿 | pptx 도구 |
| finance_data*(예시)* | 분석용 CSV·DuckDB 데이터 | analytics |
주요 파일 (기본)
| 파일 | 크기(예) | 용도 |
|---|
| analytics.duckdb | 12 KB | Analytics 패널의 테이블 저장소 (DuckDB) |
| analytics.duckdb.wal | 9.6 KB | DuckDB 쓰기 전 로그 |
| documents.duckdb | 268 KB | 인덱스된 문서 저장소 |
| documents.duckdb.wal | 257.5 KB | 쓰기 전 로그 |
| finance_schema.md | 6.4 KB | 데이터 스키마 설명 |
17, 7 등) 는 포함된 항목 수.
화면 중앙의 체크리스트. Select All 로 전체 선택하거나 개별 체크로 활성화 (N/12 enabled).
| 도구 | 용도 |
|---|
| create_file | 새 파일 생성 |
| read_as_text | 바이너리/텍스트를 텍스트로 읽기 |
| write_file | 전체 내용 덮어쓰기 |
| delete_file | 파일 삭제 |
| list_files | 폴더 내 목록 |
| get_file_info | 메타 (크기·수정일) |
| unified_diff | 두 파일·텍스트 diff 출력 |
| compare_files | 파일 비교 |
| html_to_pdf | HTML → PDF 변환 |
| glob_search | glob 패턴 파일 검색 |
| grep_search | 내용 기반 검색 |
| grep_context | 매치 주변 컨텍스트 포함 검색 |
꼭 필요한 도구만 활성화 하세요. 예: 읽기 전용 분석 작업이면 read_as_text·list_files·grep_search 만 켜고, write_file·delete_file 은 끔 → 에이전트의 사고(실수 덮어쓰기·삭제) 차단.
파일 업로드
- Root 드롭 영역 에 드래그 앤 드롭 또는 클릭 → 파일 선택
- 업로드된 파일은 즉시 Root 에 배치
- 폴더 카드를 클릭해 진입한 상태에서 드롭하면 해당 폴더로 업로드 (UI 버전에 따라)
파일 작업 흐름 예시
CSV 업로드
customers.csv · orders.csv 를 Root 또는 finance_data/ 에 드롭.
에이전트에 지시
finance_data 의 csv 를 분석해서 매출 상위 5 개 고객을 찾아줘
도구 자동 호출
에이전트가 list_files → read_as_text → analytics 도구로 DuckDB 쿼리 → 결과 요약.
결과물 저장
목표달성.csv / 설계사_성적수수료_추이.html / 설계사_성적수수료_추이.pdf 가 Root 또는 generated_docxs/ 에 자동 생성.
다운로드·이관
각 파일 행에서 다운로드하거나, Storage 에 이관해 영구 보관.
수명 주기
- 세션 단위 임시 공간 — 기본적으로 세션 종료 시 정리 대상
- 중요한 파일은 Storage 에 이관하거나 로컬로 다운로드
- DuckDB 파일은 같은 세션 내 Analytics 쿼리 결과 캐시 로 동작 — 재사용 시 응답 속도 향상
운영 주의
- 영구 보관이 필요한 파일은 즉시 Storage 업로드 — 세션 정리 시점에 Temp Files 가 비워질 수 있습니다.
- 민감 데이터 업로드 시 도구 제한 — 고객 데이터·개인정보가 담긴 CSV 를 올릴 때는
write_file·delete_file·html_to_pdf (외부 전송 가능) 등을 비활성화.
- 대용량 파일 — Temp Files 는 세션 실시간 작업용. 수 GB 대 파일은 Storage 에서 관리.
- DuckDB.wal 파일 삭제 금지 — 활성 세션의 쓰기 전 로그. 삭제 시 데이터 손실.
관련 문서
