analyze_folder_structure
Read-onlyIdempotent
Analyzes a folder's subdirectory tree, file counts by extension, total size, and largest file to reveal how the folder is organized. Use to grasp folder structure before deeper inspection.
Instructions
폴더의 하위 디렉터리 트리와 확장자별 통계, 용량, 최대 파일을 분석합니다.
scan_folder보다 한 단계 더 깊은 "구조" 파악용 도구입니다. 폴더가 어떻게 구성돼 있는지(하위 폴더별 파일 분포, 가장 큰 파일 등)를 먼저 감 잡고 싶을 때 사용하세요.
Returns:
FolderStructureResponse: tree는 {"하위폴더명": {...}, "_files": [...]}
형태의 중첩 딕셔너리입니다. 파일이 max_files보다 많으면 tree에는 앞쪽
max_files개만 반영되고 list_truncated=True가 되지만, total_files/
by_extension/total_size_bytes 등 통계는 항상 전체 파일 기준입니다.
Examples: - 사용: "이 폴더 구조 좀 분석해줘", "가장 큰 파일이 뭐야?" - 사용하지 않음: 파일 목록만 빠르게 보고 싶을 때 → scan_folder
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max_files | No | 트리(tree)에 포함할 최대 파일 수(컨텍스트 보호용 상한). 통계(개수/용량 등)는 상한과 무관하게 항상 전체 기준입니다. | |
| extensions | No | 필터링할 확장자 목록. 생략하면 pdf/docx/pptx/svg/png 전체를 대상으로 함 | |
| folder_path | Yes | 분석할 폴더의 절대 경로 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tree | Yes | ||
| folder | Yes | ||
| status | Yes | OK 또는 PARTIAL 등 처리 결과 상태 | |
| max_depth | Yes | ||
| total_files | Yes | 조건에 맞는 전체 파일 수(통계는 항상 전체 기준) | |
| by_extension | Yes | ||
| next_actions | No | ||
| largest_files | Yes | ||
| list_truncated | Yes | 파일이 너무 많아 tree에는 max_files개까지만 반영됐으면 True | |
| total_size_bytes | Yes |