Skip to main content

​
Temp Files

경로: 하단 툴바 Temp Files 에이전트 세션의 임시 작업 공간. 사용자가 업로드한 파일과 함께, 에이전트가 도구 호출로 생성·수정한 모든 임시 파일도 이 패널에 그대로 가시화 됩니다. 작업 과정·산출물을 한곳에서 추적·다운로드할 수 있어, “에이전트가 뭘 만들었는지” 채팅 밖에서도 확인 가능합니다.
Image
도구 호출과 Temp Files 는 실시간 동기화 됩니다. 에이전트가 create_file · write_file · html_to_pdf 등을 호출하는 순간, 해당 파일이 이 패널에 즉시 나타나고 크기·수정 시각이 표시됩니다. 채팅 응답에 언급되지 않은 부산물(중간 캐시·스크린샷) 까지 모두 확인할 수 있어 디버깅·감사에 유리 합니다.

​
UI 구성

​
기본 폴더 구조

세션 시작 시 자동 생성되는 폴더. 각 폴더는 전용 용도 로 매핑되어 있어 에이전트가 일관된 경로로 산출물을 저장합니다.

​
주요 파일 (기본)

폴더 옆의 숫자(17, 7 등) 는 포함된 항목 수.

​
Tools — 12 개 파일 도구

화면 중앙의 체크리스트. Select All 로 전체 선택하거나 개별 체크로 활성화 (N/12 enabled).
꼭 필요한 도구만 활성화 하세요. 예: 읽기 전용 분석 작업이면 read_as_text·list_files·grep_search 만 켜고, write_file·delete_file 은 끔 → 에이전트의 사고(실수 덮어쓰기·삭제) 차단.

​
파일 업로드

  • Root 드롭 영역 에 드래그 앤 드롭 또는 클릭 → 파일 선택
  • 업로드된 파일은 즉시 Root 에 배치
  • 폴더 카드를 클릭해 진입한 상태에서 드롭하면 해당 폴더로 업로드 (UI 버전에 따라)

​
파일 작업 흐름 예시

1

CSV 업로드

customers.csv · orders.csv 를 Root 또는 finance_data/ 에 드롭.
2

에이전트에 지시

finance_data 의 csv 를 분석해서 매출 상위 5 개 고객을 찾아줘
3

도구 자동 호출

에이전트가 list_files → read_as_text → analytics 도구로 DuckDB 쿼리 → 결과 요약.
4

결과물 저장

목표달성.csv / 설계사_성적수수료_추이.html / 설계사_성적수수료_추이.pdf 가 Root 또는 generated_docxs/ 에 자동 생성.
5

다운로드·이관

각 파일 행에서 다운로드하거나, Storage 에 이관해 영구 보관.

​
수명 주기

  • 세션 단위 임시 공간 — 기본적으로 세션 종료 시 정리 대상
  • 중요한 파일은 Storage 에 이관하거나 로컬로 다운로드
  • DuckDB 파일은 같은 세션 내 Analytics 쿼리 결과 캐시 로 동작 — 재사용 시 응답 속도 향상

​
운영 주의

  • 영구 보관이 필요한 파일은 즉시 Storage 업로드 — 세션 정리 시점에 Temp Files 가 비워질 수 있습니다.
  • 민감 데이터 업로드 시 도구 제한 — 고객 데이터·개인정보가 담긴 CSV 를 올릴 때는 write_file·delete_file·html_to_pdf (외부 전송 가능) 등을 비활성화.
  • 대용량 파일 — Temp Files 는 세션 실시간 작업용. 수 GB 대 파일은 Storage 에서 관리.
  • DuckDB.wal 파일 삭제 금지 — 활성 세션의 쓰기 전 로그. 삭제 시 데이터 손실.

​
관련 문서