파일 읽기¶

파일 읽기 스킬은 Excel(xlsx/xls), CSV, JSON 파일을 읽어 테이블 형식(TabularData)으로 변환합니다.

설정 방법¶

1. 스킬 노드 추가 및 선택¶

스킬 노드를 추가하고 우측 패널에서 파일 읽기를 선택합니다.

2. 파라미터 입력¶

설정 탭에서 파일 소스(경로, URL, 또는 이전 노드의 파일 참조)를 입력합니다. 인증이 필요 없는 스킬이므로 바로 파라미터를 설정합니다.

파라미터¶

파라미터	필수	설명
source	O	파일 경로, URL, 또는 base64 데이터
file_type		파일 타입 (`auto`, `xlsx`, `xls`, `csv`, `json`) — 기본: auto
sheet_name		Excel 시트명
encoding		CSV 인코딩 (기본: utf-8)

출력¶

{
  "success": true,
  "data": {
    "rows": [
      {"이름": "홍길동", "나이": 30, "부서": "개발팀"},
      {"이름": "김철수", "나이": 25, "부서": "마케팅"}
    ],
    "columns": ["이름", "나이", "부서"],
    "row_count": 2,
    "metadata": {
      "source_type": "xlsx",
      "source_name": "employees.xlsx",
      "sheet_name": "Sheet1"
    }
  }
}

출력 참조¶

{{ $('skill_1').data_content.result.rows }}               → 전체 데이터
{{ $('skill_1').data_content.result.rows[0].이름 }}       → 첫 행의 이름
{{ $('skill_1').data_content.result.row_count }}           → 행 수
{{ $('skill_1').data_content.result.columns }}             → 컬럼 목록

사용 예시¶

Excel → AI 분석 → 보고서¶

이메일 첨부파일 → 데이터 처리¶

참고¶

파일 타입은 매직 바이트와 MIME 타입으로 자동 감지됩니다.
storage:// S3 참조, presigned URL, base64 데이터 URI 모두 지원합니다.
CSV 파일의 구분자(콤마, 탭 등)는 자동 감지됩니다.