템플릿은 문서에서 추출하려는 열 목록을 저장한 재사용 가능한 목록입니다. 한 번 저장하면 이후 모든 배치에서 동일한 열을 다시 입력하지 않고 재사용할 수 있습니다.
템플릿이란
템플릿은 추출할 열 목록을 보관합니다. 각 열은 결과 테이블의 열이 됩니다. 템플릿 자체는 해당 목록을 저장하는 컨테이너일 뿐이므로, 동일한 열 세트를 다시 입력하지 않고도 배치마다 적용할 수 있습니다.
템플릿과 일회성 실행의 차이는 다음과 같습니다:
- 저장된 템플릿 — 이름이 지정된 재사용 가능한 열 세트입니다. 계정에 유지되며 모든 배치에서 전환하거나 이 페이지 아래에 나열된 다른 진입점을 통해 재사용할 수 있습니다.
- 일회성 실행 — 열이 해당 단일 실행에만 존재하며 재사용을 위해 저장되지 않습니다. 웹 앱에서 선택한 템플릿에 정의된 열이 없을 때 발생합니다. AI가 문서 자체에서 테이블 구조를 추론합니다. API를 통해서도 템플릿을 먼저 만들지 않고 단일 요청에만 열 목록을 전달할 수 있습니다.
템플릿 생성, 전환 및 편집
템플릿은 대시보드의 Data Columns 패널에서 관리합니다. 패널 헤더에는 현재 선택된 템플릿과 세 가지 작업이 표시됩니다:
| 작업 | 기능 |
|---|---|
| New | New Template 대화상자를 엽니다. 템플릿 이름을 지정하고, 선택적으로 기존 템플릿을 기반으로 해당 템플릿의 열을 복사할 수 있습니다. 또한 Preset Library를 탐색하여 준비된 세트로 시작할 수도 있습니다. |
| Switch | 템플릿 목록을 표시하는 Switch Template 대화상자를 엽니다. 각 행에는 Select, Settings, Share, Delete 옵션이 제공됩니다. |
| Settings | 현재 템플릿의 Template Settings를 엽니다 — 아래 템플릿 전체 설정을 참조하세요. |
열을 추가하려면 템플릿 제목 아래의 입력란에 이름을 입력하고 Add Column을 클릭하세요. 아직 선택된 템플릿이 없으면 자동으로 생성됩니다. 열을 변경하려면 목록에서 편집 아이콘을 클릭하고, 제거하려면 삭제 아이콘을 클릭하세요.
열의 구성 요소
각 열은 정확히 두 부분으로 구성됩니다: 열 이름과 선택적으로 Format Requirement입니다. 문서가 처리될 때 두 부분이 함께 전송됩니다.
| 구성 요소 | 제어 기능 |
|---|---|
| 열 이름 | 출력 열의 레이블이자 문서에서 무엇을 찾을지에 대한 지침입니다 — 예: Invoice Number 또는 Total Amount. 이름은 AI가 찾는 기준이기도 하므로 원하는 데이터를 설명해야 합니다. |
| Format Requirement | 해당 열의 값이 어떻게 반환되어야 하는지에 대한 추가 지침입니다 — 예: 금액을 일반 숫자로 변환, 통화 기호 제거, 날짜를 고정 형식으로 정규화 등. 이 열에만 적용됩니다. 비워 두면 문서에 표시된 그대로 값이 반환됩니다. |
열에 Format Requirement가 있으면 목록의 이름 옆에 정보 아이콘이 표시되어 편집 대화상자를 열지 않고도 지침을 확인할 수 있습니다. Format Requirement가 없는 열은 값을 직접 추출합니다.
Custom Columns 페이지에서는 열 값이 생성되는 다양한 방식을 설명합니다 — 문서에서 직접 읽기, 다른 값에서 계산, 또는 맥락에서 추론.
열 순서 변경
열은 템플릿에 표시된 순서대로 추출되어 반환됩니다. 순서를 변경하려면 목록에서 열의 드래그 핸들을 끌어서 이동하세요. 새 순서는 즉시 저장되며 출력 테이블에도 반영됩니다. 결과 스프레드시트에서 특정 열을 맨 앞에 배치하려는 경우 유용합니다.
템플릿 전체 설정
Template Settings 대화상자에는 단일 열이 아닌 템플릿 전체에 적용되는 설정이 포함되어 있습니다:
- Global Format Requirement — 각 열의 자체 Format Requirement에 더해 템플릿의 모든 열에 적용되는 하나의 지침입니다. 동일한 서식 규칙이 전체에 적용되는 경우 사용하세요.
- Merge Multiple Results — 추출된 여러 행을 하나로 결합합니다. 이는 Multi-Page Merge 페이지에 설명된 것과 동일한 기능입니다.
AI-Suggested Columns
선택한 템플릿에 아직 열이 없고 배치에 파일이 두 개 이상 포함된 To Table 배치 처리를 시작하면 웹 앱에서 열 목록을 제안할 수 있습니다. 일부 파일을 샘플링하여 AI가 읽고 AI-Suggested Columns 대화상자가 제안과 함께 열립니다.
- 제안된 열 이름을 검토하고, 수정하거나, 직접 추가하거나, 원하지 않는 열을 삭제하세요.
- Apply & Process를 클릭하면 목록이 템플릿에 저장되고 처리가 시작됩니다.
- 제안이 실패하면 Retry 또는 Define manually를 선택하세요.
템플릿에 이미 열이 있거나 배치에 파일이 하나만 있는 경우 제안은 건너뛰고 처리가 바로 시작됩니다.
보유 가능한 템플릿 수
계정 하나에는 최대 30개 템플릿을 보관할 수 있습니다. 이 한도에 도달한 후 새 템플릿을 만들려고 하면 앱이 다음 메시지를 표시하며 새 템플릿은 생성되지 않습니다:
30개 템플릿 한도에 도달했습니다. 기존 템플릿을 먼저 삭제하세요.
슬롯을 확보하려면 Switch Template 대화상자를 열고 더 이상 필요하지 않은 템플릿을 삭제하세요.
템플릿 재사용 가능 위치
템플릿은 특정 배치에 묶여 있지 않습니다. 저장된 동일한 열 세트는 다음 진입점 중 어디에서든 적용할 수 있습니다:
- 웹 앱 — Data Columns 패널에서 템플릿을 선택하고 모든 배치를 처리하세요.
- Google Sheets 애드온 — 사이드바에서 동일한 저장 템플릿을 사용하므로 웹사이트에서 만든 템플릿도 여기에서 사용할 수 있습니다.
- API — 배치 시작 시 요청에 열을 나열하는 대신 템플릿 식별자를 전달하세요. 개발자용 세부 사항은 API Templates & Fields 참조를 확인하세요.
템플릿은 텍스트로도 공유할 수 있습니다: Switch Template 대화상자의 Share 작업을 통해 다른 사람에게 보낼 수 있는 블록이 생성되며, 받는 사람은 이를 열 이름 상자에 붙여넣고 Add Column을 클릭하여 열과 설정을 자신의 계정으로 가져올 수 있습니다.