엑셀 파일을 테이블데이터로 실행 및 활용하기

엑셀 데이터를 구조화된 데이터베이스 형태로 변환하여 검색의 정확도와 일관성을 극대화할 수 있습니다. 엑셀 시트 내의 테이블을 대시보드에서 직접 확인 및 편집할 수 있으며, 완성된 스키마는 자동으로 DB화되어 LLM이 정형 데이터를 더 효과적으로 분석할 수 있습니다. 이를 통해 대규모 표 데이터를 처리할 때 발생하던 비정형 데이터 해석 문제를 최소화하고, 보다 정확하고 신뢰성 있는 답변을 제공합니다.

엑셀 파일 업로드 및 지원 파일 형식

대시보드에서는 다음 형식의 엑셀 파일을 업로드할 수 있습니다:

• .csv

• .xls

• .xlsx

• .xlsm

업로드한 파일의 형식이 위 네 가지 중 하나일 경우, 자동으로 테이블 편집 화면으로 진입할 수 있는 아이콘 표시됩니다.

주의 1. .docx 등 엑셀 이외의 형식은 테이블 편집 화면이 표시되지 않습니다.

📊 테이블 데이터를 구조화된 데이터로 구성하기

Table Agent 앱에서 테이블 형태의 구조화된 데이터를 사용하려면, 반드시 ‘테이블 편집’ 기능으로 데이터를 재구성해야 합니다.

편집 방법

1. 테이블 편집 아이콘 클릭

   • 클릭 시, 테이블 범위, 헤더(열 이름), 데이터 타입 등을 설정할 수 있는 편집 화면으로 이동합니다.

2. 설정 가능 항목

   • 테이블 범위: 데이터가 포함된 셀 영역 지정

   • 헤더(열 이름): 각 열의 이름 지정

   • 데이터 타입: 각 열의 값 형식(텍스트, 숫자, 날짜 등) 지정

주의 1. 테이블 편집 아이콘은 문서에 대한 편집 권한이 있는 멤버에게만 활성화됩니다. 권한이 없는 멤버는 해당 기능을 사용할 수 없습니다.

📊 테이블 데이터 구성하기

테이블 편집 화면은 왼쪽과 오른쪽 영역으로 나뉘어 있으며, 각 영역의 역할은 다음과 같습니다.

왼쪽 영역: 업로드 파일 미리보기

• 업로드한 엑셀 파일의 미리보기가 표시됩니다.

• 열과 행 정보를 함께 확인할 수 있습니다.

  주의 1. 행이나 열의 수가 많은 경우, 미리보기 표시가 제한될 수 있습니다. 이때 화면 상단에 다음 안내 문구가 표시됩니다 : "원본 파일을 참고하여 테이블 데이터를 추가하세요" 해당 안내 문구가 나타난 경우, 원본 파일을 바탕으로 테이블 데이터를 구성해 주세요.

오른쪽 영역: 테이블 데이터 편집

• 왼쪽 영역의 파일 정보를 기반으로 테이블 데이터를 직접 편집할 수 있습니다.

• 편집 가능한 항목:

  • 테이블 범위 지정

  • 헤더(열 이름) 수정

  • 데이터 타입 설정(텍스트, 숫자, 날짜 등)

주의 1. 현재는 첫 번째 시트의 1개의 테이블만 지원되므로, 1개의 테이블이 추가되면 더이상의 +추가 버튼은 비활성화되게 됩니다.

테이블 구성 단계

1. 테이블 이름 지정 데이터 용도에 맞는 테이블 이름을 입력합니다. (예: 직원 상세 정보 or 직원 인사 정보 등등)

2. 테이블 범위 지정 시트 내에서 데이터로 사용할 셀 범위를 지정합니다. 예를 들어, A1:N1001과 같이 입력하면 A열부터 N열, 1행부터 1001행까지의 데이터를 테이블 정보로 활용합니다.

3. 테이블 설명 입력 테이블의 목적이나 데이터 구조를 간략히 설명합니다. (예: 2025년 입사자에 대한 연봉, 입퇴사일, 직군 정보) 필요한 경우, 각 열의 입력 규칙이나 데이터 제약 조건을 함께 작성할 수 있습니다. 단, 이 설명은 모델 프롬프트에 직접 반영되므로 핵심 규칙만 간결하게 작성하세요. 불필요하게 긴 문장이나 중복된 예시는 모델이 내용을 혼동할 수 있습니다.

테이블 내 상세 내용 설정 이제 테이블 내에 포함될 각 헤더(열 정보)를 설정합니다. 헤더는 데이터 구조를 정의하는 핵심 요소로, 이후 검색 및 SQL 질의 시 참조되는 기준이 됩니다.

헤더 추가 방법

1. 헤더 셀 번호 입력 헤더로 사용할 행 번호를 입력합니다. (예: 첫 번째 행이 헤더인 경우 해당하는 알파벳과 해당하는 숫자 입력 예 : A1) 만약 A1에서 D99까지가 테이블 범위인 경우, 헤더를 지정할 때는 4개의 헤더를 모두 입력해야합니다.

※ 숨겨진 열(히든컬럼)이 파일 내에 포함되어 있을 경우

문서를 업로드할 때 숨겨진 열이 포함된 상태라면, 해당 열은 미리보기 화면에서도 숨겨진 채로 표시되며, 테이블 데이터로 변환할 때에도 자동으로 제외됩니다. 이 때는 B열이 숨겨진 열로 업로드되었기 때문에 헤더 정보에 A, C, D만 입력할 수 있습니다. 숨겨진 열까지 포함하여 테이블 데이터를 구성하려면, 원본 파일을 참고하여 숨겨진 열의 헤더를 직접 입력해야 합니다. 입력한 헤더를 기준으로 테이블이 재구성되며, 직접 입력한 경우에는 숨겨진 열 데이터도 함께 테이블 데이터에 포함됩니다.

1. 헤더 이름 입력 각 열(Column)에 사용할 헤더 이름을 입력합니다. ※ 엑셀 원본의 열 이름과 완전히 일치하지 않아도 되며, 검색이나 필터링 시 유용하게 활용될 수 있는 이름으로 지정하는 것이 좋습니다.

2. 데이터 타입 지정 각 열에 들어갈 데이터의 유형을 선택합니다.데이터 타입은 검색 정확도와 SQL 질의 결과에 직접 영향을 미치므로, 실제 데이터 특성에 맞게 정확히 지정하는 것이 중요합니다. 가령 타입을 DATETIME 으로 지정하고, 실제 값이 STRING인 경우 null값으로 저장되니 유의해 주세요.

※데이터 타입별 설명 및 예시

STRING (문자열)	문자로 구성된 일반 텍스트 데이터입니다. 숫자라도 계산이 아닌 단순 표기용이면 문자열로 지정합니다.	직원명: 김수현, 사번: A-102
NUMBER (숫자)	정수 또는 실수형 숫자 데이터입니다. 합계, 평균 등 계산이 필요한 데이터에 사용합니다.	연봉: 120, 비율: 0.85
DATETIME (날짜/시간)	날짜 또는 시간 정보를 포함하는 데이터입니다. SQL 검색 시 기간 필터로 활용할 수 있습니다.	입사일: 2025-10-16, 퇴사일: 2025-09-01 14:32:00
BOOLEAN (불린)	참/거짓(True/False) 형태의 데이터입니다. 선택 여부나 상태 값을 표현할 때 사용합니다.	활성 여부: TRUE, 공지 완료 여부: FALSE

헤더가 의미하는 데이터의 뜻이나 사용 목적을 간략히 작성합니다. 이 설명은 모델이 열(Column)의 의미를 이해하는 데 직접 활용되므로, 짧고 명확하게 핵심만 입력하세요.

주의 1. 열 값에 화폐 단위가 포함된 경우, 데이터 구성 시 단위 정보가 사라질 수 있습니다. 필요하면 헤더 설명란에 화폐 단위를 함께 입력해주세요.

※병합셀을 처리하고 싶은 경우

병합셀 처리 방식 병합셀은 테이블 데이터로 변환 시 자동으로 해제되며, 원본 값이 병합 영역의 모든 셀에 복제됩니다.

따라서 하기와 같이 입력합니다.

예시 :

• B2:C2가 병합되어 "부서"이라는 값을 가진 경우 → B1 = "부서", C1 = "부서2" 등으로 입력합니다.

• 이 때 셀네임은 고유의 값이므로 _2 등의 기호를 넣어두는 것을 추천합니다.

※데이터로 저장하고 싶은 헤더의 위치가 다른 경우

구성하고자 하는 테이블의 셀 행이 일치하지 않을 경우에는, 헤더로 지정하고 싶은 영역의 번호를 부여해 주세요. 상기 화면처럼 입력했을 경우, 실제 빈값은 NULL로 처리되어 데이터가 깨지는 일 없이 그대로 유지됩니다. 테이블 데이터로 실행

모든 헤더 정보가 입력되면 저장버튼을 클릭합니다.

모든 정보가 입력되면 '테이블 데이터로 실행' 버튼을 클릭합니다.

이제 앱을 구성하여 해당 테이블 데이터를 답변으로 활용할 수 있습니다.

테이블 데이터로 저장에 성공하여 앱에서 활용할 수 있는 경우에는 초록색으로 표시됩니다.

작성한 내용을 저장만 하고 테이블 데이터로 실행하지 않은 경우(앱에서 활용할 수 없는 경우)에는 주황색으로 표시됩니다.

앱 구성하기

주의 1. 기본적으로 작성 중인 앱에 Table Agent 앱이 구성되어 있으니 해당 앱을 복사하거나 편집하는 형태로 사용하는 것을 추천합니다

1. 앱 편집 버튼을 클릭합니다.

2. LLM 입력 노드에서 방금 구성한 엑셀 파일을 문서 범위 내에서 선택합니다. (이 과정을 반드시 수행해야 앱으로 사용할 수 있습니다. 문서를 지정하지 않은 상태에서 작성 중인 앱을 공개하고 실행하면 참조할 테이블 데이터가 없기 때문에 오류가 발생합니다.)

주의 1.변수는 반드시 시스템 변수인 EXCEL_DOCUMENTS로 지정해야 합니다. 절대로 이를 다른 변수로 변경하지 마세요.

2.권장 모델은 OPENAI CPT-4o 입니다.

1. 앱을 공개합니다.

동작 확인 - 앱 테스트

이제 구성한 테이블 데이터를 기반으로정보를 검색하고 답변을 생성할 수 있습니다.

답변 과정 보기를 클릭하면 SQL 쿼리가 어떻게 생성되었는지 상세과정을 확인할 수 있습니다.

※대시보드 문서 탭 내 엑셀 파일 관리 시 주의점

주의 1. Alli에서 기본 기능으로 제공하고 있는 문서 업데이트 버튼은 테이블 데이터로 실행되지 않은 엑셀 파일에서만 활용 가능합니다. 한번 테이블 데이터로 구성된 엑셀 파일은 업데이트 버튼이 비표시됩니다. 2. 모든 엑셀 파일에는 테이블 편집 아이콘이 표시됩니다. 하지만 실제 편집 화면에서 테이블로 구성하지 않으면 엑셀 파일은 마크다운(줄글) 형태로 파싱되어 기존처럼 문서 내 답변 소스로 자유롭게 활용됩니다. 만약 한 개의 문서를 테이블 데이터와 마크다운 두 방식 모두로 사용하고 싶다면, 문서명을 다르게 해서 두 개를 업로드한 뒤 한쪽에서 테이블 데이터로 구성하세요.