> ## 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.

# 메모리

> 대화에서 확인한 사실을 저장했다가 같은 고객과의 다음 대화에서 에이전트에게 전달합니다.

메모리는 에이전트가 대화에서 확인한 사실입니다. "지난주에 배송 지연 문의를 했다",
"매장 픽업을 선호한다" 같은 내용이 고객과 에이전트별로 저장되고, 같은 고객이 다시
연락하면 대화 시작 시점에 에이전트에게 전달됩니다. 고객은 같은 설명을 반복할
필요가 없고, 에이전트는 단골을 아는 상담원처럼 응대합니다.

## 이럴 때 사용하세요

메모리는 정해진 칸에 넣기 어려우면서 다음 대화에 도움이 되는 사실에 적합합니다.

| 상황                  | 메모리 예시                       |
| ------------------- | ---------------------------- |
| 이전 문의를 이어서 처리할 때    | 배송 지연으로 문의했고 금요일까지 확인하기로 함   |
| 고객의 반복되는 선호를 반영할 때  | 택배보다 매장 픽업을 선호함              |
| 다음 상담사가 맥락을 알아야 할 때 | 설치 일정은 배우자와 상의한 뒤 다시 연락하기로 함 |

멤버십 등급처럼 고객 목록에서 분류할 값은
[고객 속성](/docs/build/customer-memory/attributes)에 저장하세요. 주문 상태처럼 실시간으로
확인해야 하는 값은 [API 도구](/docs/build/tools/api)로 조회하는 편이 좋습니다.

## 메모리 켜기

에이전트 빌드 화면에서 **메모리** 섹션을 열고 **메모리 활성화**를 켭니다.
이 토글 하나로 메모리 추출과 [고객 속성](/docs/build/customer-memory/attributes)
자동 추출이 함께 동작합니다.

## 동작 흐름

```mermaid theme={null}
flowchart LR
    A[대화 종료] --> B[핵심 정보 추출]
    B --> C[고객별 메모리 저장]
    C --> D[다음 대화 시작 시 주입]
```

1. **추출** — 통화나 채팅이 끝나면 대화 내용에서 기억할 가치가 있는 사실을
   추출합니다. 추출은 대화가 끝난 뒤 백그라운드에서 진행되므로 대화 품질에
   영향을 주지 않습니다.
2. **저장** — 추출된 사실은 고객 상세 화면에서 확인할 수 있습니다.
3. **주입** — 같은 고객과 다음 통화를 시작하면 저장된 메모리를 에이전트
   프롬프트에 주입합니다. 프롬프트를 따로 수정할 필요가 없습니다.

통화 중 다른 에이전트로 이관해도 처음 주입한 메모리는 유지됩니다.

<Note>
  추출은 통화와 채팅 모두에서 동작하지만, 주입은 전화 통화에서 동작합니다.
  채팅과 SDK 웹 세션은 추출된 메모리를 대화에 주입하지 않습니다.
</Note>

<Note>
  개인정보 마스킹을 켠 에이전트도 메모리를 사용할 수 있습니다. vox.ai는 마스킹된
  대화에서 메모리와 고객 속성을 추출합니다.
</Note>

## 메모리 직접 관리하기

자동 추출된 메모리는 대시보드나 API에서 관리할 수 있습니다.

* **대시보드** — 고객 상세 화면에서 메모리를 확인하고 삭제할 수 있습니다. 추가와
  수정은 지원하지 않습니다. 잘못 추출됐거나 더 이상 유효하지 않은 내용을 정리할 때
  사용하세요.
* **API** — v3 API로 메모리를 조회·추가·삭제하거나 조건에 따라 일괄 만료할 수 있습니다.
  [v3 API 참조](/api-reference/v3/introduction)를 확인하세요.

## 권장 운영법

* **다음 대화에 필요한 사실만 남기세요.** 인사말이나 일회성 잡담처럼 다시 참고할
  가치가 낮은 내용은 직접 추가하지 마세요.
* **사실과 추측을 구분하세요.** 고객이 명시적으로 말했거나 상담 과정에서 확인한
  내용만 저장하세요.
* **실시간 데이터의 원본으로 쓰지 마세요.** 재고, 배송 상태, 잔액처럼 자주 바뀌는
  값은 원본 시스템을 조회하세요.
* **잘못되거나 오래된 메모리를 정리하세요.** 고객 상세 화면에서 내용을 검토하고,
  다음 상담에 혼선을 줄 수 있는 항목은 삭제하세요.
* **구조화가 필요하면 고객 속성을 사용하세요.** 검색, 분류와 외부 연동에 쓸 값은
  자유 문장 대신 고객 속성으로 정의하는 편이 좋습니다.

***

<Accordion title="연관 검색어">
  메모리, 메모리 fact, 고객 메모리, memory, 메모리 활성화, 재통화, 맥락 유지, 프롬프트 주입
</Accordion>