# 템플릿 및 열: 재사용 가능한 추출 설정

> 템플릿은 저장된 재사용 가능한 추출 열 목록입니다. 이 페이지에서는 열 이름과 형식 요구 사항이 어떻게 작동하는지, 계정에 보관할 수 있는 템플릿 수, 템플릿이 재사용되는 위치를 설명합니다.

[**템플릿**](/docs/reference/glossary#template)은 문서에서 추출하려는 [열](/docs/reference/glossary#column) 목록을 저장한 재사용 가능한 목록입니다. 한 번 저장하면 이후 모든 [배치](/docs/reference/glossary#batch)에서 동일한 열을 다시 입력하지 않고 재사용할 수 있습니다.

## 템플릿이란

템플릿은 추출할 열 목록을 보관합니다. 각 열은 결과 테이블의 열이 됩니다. 템플릿 자체는 해당 목록을 저장하는 컨테이너일 뿐이므로, 동일한 열 세트를 다시 입력하지 않고도 배치마다 적용할 수 있습니다.

템플릿과 일회성 실행의 차이는 다음과 같습니다:

- **저장된 템플릿** — 이름이 지정된 재사용 가능한 열 세트입니다. 계정에 유지되며 모든 배치에서 전환하거나 이 페이지 아래에 나열된 다른 진입점을 통해 재사용할 수 있습니다.
- **일회성 실행** — 열이 해당 단일 실행에만 존재하며 재사용을 위해 저장되지 않습니다. 웹 앱에서 선택한 템플릿에 정의된 열이 없을 때 발생합니다. AI가 문서 자체에서 테이블 구조를 추론합니다. API를 통해서도 템플릿을 먼저 만들지 않고 단일 요청에만 열 목록을 전달할 수 있습니다.

## 템플릿 생성, 전환 및 편집

템플릿은 대시보드의 **Data Columns** 패널에서 관리합니다. 패널 헤더에는 현재 선택된 템플릿과 세 가지 작업이 표시됩니다:

| 작업 | 기능 |
| --- | --- |
| New | New Template 대화상자를 엽니다. 템플릿 이름을 지정하고, 선택적으로 기존 템플릿을 기반으로 해당 템플릿의 열을 복사할 수 있습니다. 또한 Preset Library를 탐색하여 준비된 세트로 시작할 수도 있습니다. |
| Switch | 템플릿 목록을 표시하는 Switch Template 대화상자를 엽니다. 각 행에는 Select , Settings , Share , Delete 옵션이 제공됩니다. |
| Settings | 현재 템플릿의 Template Settings 를 엽니다 — 아래 템플릿 전체 설정 을 참조하세요. |

열을 추가하려면 템플릿 제목 아래의 입력란에 이름을 입력하고 **Add Column**을 클릭하세요. 아직 선택된 템플릿이 없으면 자동으로 생성됩니다. 열을 변경하려면 목록에서 편집 아이콘을 클릭하고, 제거하려면 삭제 아이콘을 클릭하세요.

## 열의 구성 요소

각 열은 정확히 두 부분으로 구성됩니다: **열 이름**과 선택적으로 [**Format Requirement**](/docs/reference/glossary#format-requirement)입니다. 문서가 처리될 때 두 부분이 함께 전송됩니다.

| 구성 요소 | 제어 기능 |
| --- | --- |
| 열 이름 | 출력 열의 레이블이자 문서에서 무엇을 찾을지에 대한 지침입니다 — 예: Invoice Number 또는 Total Amount . 이름은 AI가 찾는 기준이기도 하므로 원하는 데이터를 설명해야 합니다. |
| Format Requirement | 해당 열의 값이 어떻게 반환되어야 하는지에 대한 추가 지침입니다 — 예: 금액을 일반 숫자로 변환, 통화 기호 제거, 날짜를 고정 형식으로 정규화 등. 이 열에만 적용됩니다. 비워 두면 문서에 표시된 그대로 값이 반환됩니다. |

열에 Format Requirement가 있으면 목록의 이름 옆에 정보 아이콘이 표시되어 편집 대화상자를 열지 않고도 지침을 확인할 수 있습니다. Format Requirement가 없는 열은 값을 직접 추출합니다.

[Custom Columns](/docs/concepts/custom-columns) 페이지에서는 열 값이 생성되는 다양한 방식을 설명합니다 — 문서에서 직접 읽기, 다른 값에서 계산, 또는 맥락에서 추론.

## 열 순서 변경

열은 템플릿에 표시된 순서대로 추출되어 반환됩니다. 순서를 변경하려면 목록에서 열의 드래그 핸들을 끌어서 이동하세요. 새 순서는 즉시 저장되며 출력 테이블에도 반영됩니다. 결과 스프레드시트에서 특정 열을 맨 앞에 배치하려는 경우 유용합니다.

## 템플릿 전체 설정

**Template Settings** 대화상자에는 단일 열이 아닌 템플릿 전체에 적용되는 설정이 포함되어 있습니다:

- **Global Format Requirement** — 각 열의 자체 Format Requirement에 더해 템플릿의 모든 열에 적용되는 하나의 지침입니다. 동일한 서식 규칙이 전체에 적용되는 경우 사용하세요.
- **Merge Multiple Results** — 추출된 여러 행을 하나로 결합합니다. 이는 [Multi-Page Merge](/docs/concepts/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 참조](/developers/reference/templates-fields)를 확인하세요.

템플릿은 텍스트로도 공유할 수 있습니다: Switch Template 대화상자의 **Share** 작업을 통해 다른 사람에게 보낼 수 있는 블록이 생성되며, 받는 사람은 이를 열 이름 상자에 붙여넣고 **Add Column**을 클릭하여 열과 설정을 자신의 계정으로 가져올 수 있습니다.

---

Source: https://imagetotable.ai/ko/docs/concepts/templates-and-columns