> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryvox.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 통화 정보 추출

> 통화 종료 후 대화에서 데이터를 자동 추출하는 규칙을 설정하세요.

# 통화 정보 추출

통화 정보 추출은 통화가 종료된 뒤 LLM이 전체 스크립트를 분석하여 구조화된 데이터를 자동으로 추출하는 기능입니다. 수동 검토 없이 통화 내용에서 핵심 정보를 즉시 확인할 수 있습니다.

## 작동 방식

1. 통화가 종료되면 전체 스크립트가 LLM에 전달됩니다.
2. 사전에 정의한 추출 규칙에 따라 LLM이 스크립트를 분석합니다.
3. 추출된 데이터가 구조화된 형태로 저장됩니다.

```mermaid theme={null}
flowchart LR
    A[통화 종료] --> B[스크립트]
    B --> C[LLM 분석]
    C --> D[구조화 데이터]
    D --> E[결과 저장]
```

<Note>
  통화 중 [에이전트 전환](/docs/build/tools/builtin/transfer-agent)이 일어난 경우(A → B → C), 체인에 등장한 **모든 에이전트의 추출 규칙을 병합**하여 분석합니다. 같은 필드 이름이 여러 에이전트에 설정돼 있으면 **나중(뒤쪽) 에이전트의 설정**이 우선합니다.
</Note>

## 공통 필드

모든 추출 항목은 다음 필드를 공유합니다.

| 필드              | 필수 | 설명                                                  |
| --------------- | -- | --------------------------------------------------- |
| **필드 이름**       | 필수 | 추출 결과의 키로 사용되는 식별자 (예: `inquiry_type`)              |
| **추출 가이드**      | 선택 | LLM에게 무엇을 어떻게 추출할지 안내하는 지시문                         |
| **`null` 값 허용** | 선택 | 해당 정보가 스크립트에 없을 때 `null`로 비워둘지, 타입에 맞는 기본값을 반환할지 결정 |

<Tip>
  추출 가이드는 선택사항이지만, 필드 이름만으로는 LLM이 의도를 정확히 파악하기 어려울 수 있습니다. 가능하면 어떤 상황에서 어떤 값을 뽑아야 하는지 한두 줄로 기술해 주세요.
</Tip>

## 추출 타입

4가지 데이터 타입을 지원합니다. 추출할 정보의 성격에 맞는 타입을 선택하세요.

### 문자열 (`string`)

자유 형식의 텍스트를 추출합니다.

**예시 — 문의 유형 추출:**

* 필드 이름: `inquiry_type`
* 추출 가이드: "사용자의 주요 문의 유형을 한 문장으로 요약하세요."

***

### 숫자 (`number`)

숫자 값을 추출합니다.

**예시 — 주문 금액:**

* 필드 이름: `order_amount`
* 추출 가이드: "통화에서 언급된 주문 총 금액을 숫자로 추출하세요. 단위는 원(KRW)입니다."

***

### 불리언 (`boolean`)

예/아니오로 판단할 수 있는 값을 추출합니다.

**예시 — 예약 확인 여부:**

* 필드 이름: `reservation_confirmed`
* 추출 가이드: "통화 중 예약이 최종 확인되었는지 판단하세요."

***

### 열거형 (`enum`)

미리 정의된 선택지 중 하나를 추출합니다. 다른 타입과 달리 **선택 옵션** 목록을 반드시 함께 정의해야 합니다.

**예시 — 고객 만족도:**

* 필드 이름: `satisfaction`
* 추출 가이드: "통화 내용을 바탕으로 고객의 만족도를 판단하세요."
* 선택 옵션: `매우 만족`, `만족`, `보통`, `불만족`, `매우 불만족`

## 활용 사례

| 추출 항목  | 타입  | 활용                     |
| ------ | --- | ---------------------- |
| 고객 만족도 | 열거형 | 상담 품질 모니터링, 불만족 고객 재연락 |
| 문의 유형  | 문자열 | 문의 카테고리별 통계, 트렌드 분석    |
| 예약 확인  | 불리언 | 예약 완료율 추적              |
| 주문 금액  | 숫자  | 매출 집계, 평균 주문 금액 분석     |

<Note>
  추출 규칙은 여러 개를 동시에 설정할 수 있습니다. 하나의 통화에서 만족도, 문의 유형, 예약 확인 여부를 동시에 추출할 수 있습니다. 추출된 결과는 [통화 이력](/docs/operate/monitor/history)에서 확인하거나 [통화 후 분석](/docs/operate/monitor/post-call)으로 집계할 수 있습니다.
</Note>

<Warning>
  추출 정확도는 스크립트의 품질과 추출 가이드의 명확성에 따라 달라집니다. 가이드를 구체적으로 작성할수록 정확한 결과를 얻을 수 있습니다.
</Warning>

## 관련 문서

* [시스템 변수](/docs/build/variables/system-variables)
* [웹훅](/docs/build/security/webhooks) -- v2 `call_analyzed` 또는 v1 `call_ended`로 추출 결과 전송

***

<Accordion title="연관 검색어">
  통화 정보 추출, post-call extraction, 데이터 추출, 추출 타입, custom analysis, call analysis, 구조화 데이터
</Accordion>