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

# 고객 속성

> 정해 둔 항목에 맞춰 대화에서 고객 정보를 모아 다음 대화에 이어 써요.

## 언제 쓰나요

[고객 메모리](/agents/memory)는 대화에서 확인한 사실을 문장으로 기억해요. 고객 속성은 **미리 정한 항목**에
값을 채워요. 멤버십 등급, 관심 상품, 재연락 희망 여부, 예약 날짜처럼 고객마다 같은 모양으로 모아 두고
고객 목록에서 거르거나 내보내고 싶은 정보에 써요.

* 속성은 **계정 단위**로 정해요. 모든 에이전트·크루가 같은 항목을 함께 써요.
* 값은 고객 한 명에 항목마다 **하나**예요. 어느 에이전트가 채웠든 같은 칸을 고쳐요.

## 만들기

사이드바 **고객 › 고객 속성**에서 **추가**를 눌러요.

| 항목 | 설명 |
| - | - |
| **타입** | 값의 모양이에요. 아래 5가지 중 하나를 골라요. **만든 뒤에는 바꿀 수 없어요** |
| **이름** | 1\~100자. 계정 안에서 겹칠 수 없어요(대소문자 구분 없음) |
| **추출 지시문** | 무엇을 뽑을지 설명해요. 예: «고객이 구매 의사를 밝힌 제품명». 최대 500자 |
| **선택 옵션** | 열거형일 때만 적어요. 한 줄에 하나, 2\~50개 |
| **충돌 처리** | 이미 값이 있을 때 새로 뽑은 값을 어떻게 할지 정해요 |

| 타입 | 저장되는 값 | 예시 |
| - | - | - |
| **문자열** | 짧은 글, 최대 200자 | 관심 상품 |
| **숫자** | 수 | 가족 인원 |
| **참/거짓** | 예 / 아니요 | 재연락 희망 |
| **열거형** | 선택 옵션 중 하나 | 멤버십 등급(일반·실버·골드) |
| **날짜** | 연·월·일 | 방문 예정일 |

충돌 처리는 두 가지예요.

* **항상 덮어쓰기**: 새로 뽑은 값으로 바꿔요. 바뀌기 쉬운 정보(관심 상품)에 맞아요.
* **비어 있을 때만**: 처음 확인한 값을 지켜요. 잘 바뀌지 않는 정보(가입 경로)에 맞아요.

새로 뽑은 값이 지금 값과 같으면 **항상 덮어쓰기**여도 그대로 둬요. 늦게 끝난 대화 분석이 그보다 최근에 바뀐 값을 덮어쓰지도 않아요.

<Note>
  속성은 계정당 **50개**까지 만들 수 있어요. 비활성화한 속성도 개수에 들어가요.
</Note>

## 켜는 법

따로 켜는 스위치가 없어요. [메모리 활성화](/agents/memory#켜는-법)를 켠 에이전트·크루는 **활성** 속성이 하나라도
있으면 속성도 함께 채워요.

* **에이전트**: 에이전트 편집 → **메모리** 탭 → **메모리 활성화**
* **크루**: 캔버스 툴바의 **전체 설정** → **메모리 활성화**

속성을 채우는 대화의 조건(알아볼 수 있는 고객, 테스트 패널 제외 등)은
[메모리가 동작하는 대화](/agents/memory#누구에게-동작하나요)와 같아요.

## 통화에서 일어나는 일

* **대화가 끝난 뒤** 대화 내용을 보고 값을 뽑아요. 대화 중에는 값을 바꾸지 않아요.
* 고객이 말했거나 대화에서 분명히 확인된 값만 채워요. **근거가 없으면 비워 둬요.** 짐작해서 채우지 않아요.
* AI 가 먼저 제안한 값에 고객이 동의만 한 경우는 채우지 않아요.
* 날짜 속성은 고객이 연·월·일을 분명히 말했을 때만 채워요. «내일», «다음 주 화요일», 연도가 없는 «10월 15일»은 비워 둬요. «오늘»은 그 대화 날짜로 채워요.
* 문자열 속성에도 «내일» 같은 상대 날짜 표현은 적지 않아요.
* [개인정보 마스킹](/agents/memory#주의사항)을 켠 에이전트는 전화번호·이메일·생년월일처럼 가려지는 모양의 값을 자동으로 채우지 않아요.
* 속성을 만들기 **전의 대화에서는 뽑지 않아요.** 만든 뒤의 대화부터 채워져요.
* 같은 고객이 다시 연락하면 에이전트가 **첫 응답을 하기 전에** 메모리와 함께 속성 값을 넘겨받아요.

<Tip>
  에이전트는 넘겨받은 값을 참고 정보로만 써요. 값에 따라 어떻게 응대할지(예: 골드 등급이면 전담 안내)는
  에이전트 **프롬프트**에 적어 두세요. 속성 값은 대화에서 들은 내용이라 확인된 사실이 아닐 수 있어요. 등급별 혜택처럼 판단이 필요한 응대는 프롬프트에 확인 조건까지 적어 두세요.
</Tip>

## 저장된 값 관리

**고객 → 고객 관리**에서 고객을 열면 고객 시트의 **정보**에 활성 속성이 한 줄씩 보여요.

* 값을 눌러 그 자리에서 고쳐요. 값을 지우면 **비어 있음**이 돼요.
* 값 위에 마우스를 올리면 **대화에서 채움**인지 **직접 입력**인지와 바뀐 시각이 보여요.
* 직접 바꾼 값에는 충돌 처리가 적용되지 않아요. **항상 덮어쓰기** 속성이면 다음 대화에서 새 값이 나왔을 때 바뀔 수 있어요.
* 열거형 옵션을 고쳐도 저장된 값은 그대로예요. 지금 옵션에 없는 값은 **선택지에 없음**으로 보여요.

고객 목록에서도 속성을 써요.

* **필터 → 고객 속성**: 속성 하나를 고르고 값을 정하면 그 값과 **일치하는** 고객만 보여요. 한 번에 한
  속성만 걸 수 있고, 숫자·날짜의 범위로는 거를 수 없어요.
* **내보내기**: CSV 에 활성 속성마다 열이 붙어요. 참/거짓 속성은 예/아니요로 나와요.

<Tip>
  고객을 병합하면 대표 고객의 값을 그대로 두고, 대표 고객에 비어 있는 속성만 다른 고객의 값으로 채워요.
</Tip>

## 비활성화·이름 변경·삭제

* **비활성화**: 목록의 활성 스위치를 꺼요. 값을 뽑지도, 다음 대화에 넘기지도 않고, 고객 시트·필터·내보내기에서도
  빠져요. 저장된 값은 **남아 있어서** 다시 켜면 돌아와요.
* **이름 변경**: 저장된 값은 **그대로 유지**돼요.
* **삭제**: 고객들에게 저장된 **값도 함께 지워지고** 되돌릴 수 없어요. 확인 창에 값이 있는 고객 수가 나와요.
  값을 남기려면 삭제 대신 비활성화하세요.

고객 데이터 보존 기간이 지나 고객 데이터가 지워져도 속성 정의는 남아요. 계정을 탈퇴하면 함께 지워져요.

## 문제가 생겼을 때

| 증상 | 확인할 것 |
| - | - |
| 값이 채워지지 않아요 | 에이전트·크루의 **메모리 활성화**가 켜져 있고 배포·운영 반영했는지, 속성이 **활성**인지 확인해요. 테스트 패널 통화처럼 메모리가 동작하지 않는 대화는 채우지 않아요 |
| 지난 대화의 값이 없어요 | 속성을 만들기 전의 대화에서는 뽑지 않아요 |
| 값이 계속 바뀌어요 | 처음 값을 지키려면 충돌 처리를 **비어 있을 때만**으로 바꿔요 |
| 엉뚱한 값이 들어가요 | 추출 지시문을 더 구체적으로 적어요. 열거형이면 선택 옵션 이름을 고객이 쓰는 말에 가깝게 지어요 |
| 추가 버튼이 눌리지 않아요 | 속성 50개를 모두 만들었어요. 쓰지 않는 속성을 삭제해요 |
| 전화번호·이메일 같은 값이 비어 있어요 | 개인정보 마스킹을 켠 에이전트는 가려지는 모양의 값을 채우지 않아요. 고객 시트에서 직접 입력해요 |
| 날짜가 비어 있어요 | 고객이 연·월·일을 분명히 말하지 않았어요(«다음 주», 연도 없는 날짜 등) |
| 대화가 끝나자마자 값이 없어요 | 저장까지 수 초에서 수십 초 걸려요 |

## 관련 문서

* [고객 메모리](/agents/memory)
* [에이전트 관리](/agents/manage)
* [크루](/agents/crew)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.