클레어 활용하기

AI 크루 - '클레어'

에이전트 ‘클레어’는 데이터 분석 전문 에이전트입니다. 이제 SQL을 직접 작성하거나 복잡한 필터를 하나하나 설정할 필요 없이 클레어와 대화하듯 질문하면, 내 서비스에 대한 데이터 분석 결과를 차트 형태로 확인할 수 있습니다.

클레어의 주요 기능

• 자연어 데이터 분석: "지난달 VIP 그룹의 평균 구매액은 얼마야?"처럼, 개발자의 도움이나 SQL 없이 누구나 대화하듯 데이터를 분석할 수 있습니다.

• 자동 시각화 리포트: 데이터의 특성에 맞춰 표, 바 차트, 라인 차트 등 가장 이해하기 쉬운 형태의 보고서를 즉시 생성합니다.

• 복합 질문에 대한 심층 분석: "VIP 그룹과 신규 그룹의 구매 횟수를 비교하고, VIP가 가장 많이 산 카테고리도 알려줘" 와 같이 여러 단계의 질문에도, [심층 분석]을 통해 단계별 상세 결과를 모두 확인할 수 있습니다.

• 분석 결과 데이터 다운로드: '심층 분석'을 통해 얻은 상세 데이터는 관리자가 CSV 파일로 다운로드하여 2차 분석이나 보고서 작성에 바로 활용할 수 있습니다.

클레어를 잘 활용하는 방법

클레어가 질문을 더 정확하게 이해하고, 원하는 답변을 생성하도록 하려면 질문(프롬프트)를 구체적으로 하는 것이 중요합니다. 클레어를 '똑똑한 신입사원'이라고 생각해 주세요. 명확하고 구체적으로 질문할수록 훨씬 더 정확한 답변을 얻을 수 있습니다.

• 최대한 구체적으로 질문해 주세요. 모호한 표현 대신, 시간, 순서, 조건을 명확하게 포함하여 질문하는 것이 가장 좋습니다.

아쉬운 질문 : "전체 매출 알려줘” 좋은 질문 : “올해 1월~3월, 월별 매출 금액 알려줘”

• 복잡한 질문은 단계별로 나눠서 질문해 보세요. 하나의 질문에 너무 많은 조건을 담기보다, 여러 단계로 나누어 질문하고 결과를 조합하면 오류를 줄일 수 있습니다.

아쉬운 질문 : "1분기 신규 가입자 중, 2회 이상 구매하고 VIP 등급이면서 마지막 접속이 1주일 이내인 고객 수 알려줘.” 좋은 질문 : "1분기 신규 가입자 수를 알려줘." ㄴ 이어지는 질문 : "그중에서 2회 이상 구매한 고객은 몇 명이야?" ㄴ 이어지는 질문 : "거기서 VIP 등급인 고객을 찾아줘."

• 중요한 데이터는 공식 리포트와 교차 확인해 주세요. AI 분석 기능은 데이터의 전반적인 트렌드를 빠르게 파악하거나 새로운 인사이트를 탐색하는 데 매우 유용합니다. 하지만 매출, 성과 등 중요한 비즈니스 의사결정을 위한 최종 데이터는 반드시 공식 리포트를 통해 교차 확인하는 것을 권장합니다.

상세 작성 가이드

기본 공식

• [시간 범위] + [분석 대상] + [측정 지표] + [동작어]

  예시 질문 : [오늘] [카테고리별 매출][액] [조회]

올바른 작성법

피해야 할 표현

지표별 질의문 예시

1. 매출 관련

1. 사용자 관련

1. 상품/카테고리 관련

기본 분석과 심층 분석

클레어는 사용자의 질문에 대해 2가지의 분석 수준을 제공합니다.

[심층 분석] 버튼을 누르고 질문을 하지 않으면, 모든 질문에 대해서는 기본적으로 ‘기본 분석’ 결과로 제공됩니다. 만약 질문이 복합적이어서 더 상세한 분석이 가능하다고 판단될 경우, 질문을 입력하는 인풋에 [심층 분석] 버튼을 통해 심층 분석 모드로 변경 할 수 있습니다.

심층 분석은 이럴 때 사용하세요!

두 개 이상의 그룹을 비교하거나, 여러 지표를 순차적으로 분석해야 하는 복합적인 질문을 했을 때 기본 분석 결과만으로 부족하다고 느낄 수 있습니다. 이 때 [심층 분석] 버튼을 눌러 상세 데이터를 얻을 수 있습니다.

예시 질문 : "지난달(2025년 6월) 동안 'VIP 고객' 그룹과 '신규 가입 고객' 그룹의 총 구매 횟수를 비교하고, VIP 그룹이 가장 많이 구매한 상품 카테고리 TOP 3도 알려줘.”

기본 분석 결과 기본 분석의 경우 두 그룹의 비교 결과를 1개의 차트로 명확하게 보여줌

심층 분석 결과 각 수행되는 쿼리 결과에 따른 하나의 답변 내 여러 차트를 명확하게 보여주며, 데이터 CSV 다운로드 가능

심층 분석은 위와 같이 더 심도있는 답변을 제공하므로, 기본 분석보다 더 많은 토큰이 소모될 수 있습니다.

'클레어' 관련 FAQ

1. 클레어는 서비스의 모든 데이터를 보나요?

아니요, 클레어는 답변의 정확성과 신뢰도를 위해, 디파이너리에서 표준으로 정의된 데이터 범위 안에서만 분석을 수행합니다.

[분석 가능한 데이터 범위]

• 표준 이벤트 : dfn_purchase 등 디파이너리에서 기본으로 제공하는 이벤트

• 표준 이벤트 속성 : product_id 등 디파이너리에서 기본으로 제공하는 표준 이벤트에 종속된 속성

• 표준 유저 프로필 : gender, country 등 디파이너리에서 기본으로 제공하는 사용자 속성

• 수신 동의 속성 : df_push_optin 등 푸시, SMS, 카카오 채널 등 광고성 메시지 수신 동의 여부

• CRM 및 오디언스 정보

  • 캠페인 정보 (캠페인 ID로 질문 시 분석 가능)

  • 오디언스 정보 (오디언스 ID로 질문 시 분석 가능)

2. 커스텀 이벤트는 분석이 안되나요?

네, 현재는 커스텀 이벤트에 대한 상세 분석은 지원하지 않으며, 제한된 범위의 집계만 가능합니다.

▶️ 왜 상세 분석이 어려운가요?

쉽게 비유하자면, 클레어는 '표준 이벤트 명세서'를 보고 데이터 분석 방법을 학습합니다. 이 명세서에는 '구매' 이벤트에는 '가격', '상품명' 속성이 있다는 식의 정보가 상세히 정의되어 있습니다.

반면 고객사에서 직접 생성하신 커스텀 이벤트는 이 명세서에 포함되어 있지 않아, 클레어는 해당 이벤트의 속성이나 의미를 알 수 없어 상세 분석이 어렵습니다.

▶️ 그럼에도 불구하고, 왜 '커스텀 이벤트 수'가 집계되나요?

"오늘 발생한 전체 이벤트 수는?"처럼 일반적인 수치를 집계할 때, 실제 데이터베이스에 기록된 커스텀 이벤트까지 포함하여 계산될 수 있습니다. 이는 클레어가 커스텀 이벤트를 '이해하고' 분석한 것이 아니라, 전체 데이터를 대상으로 한 집계에 자연스럽게 포함된 결과입니다.

3. 캠페인 이름, 오디언스 이름을 입력했는데 분석이 안돼요.

캠페인과 오디언스의 경우 정확한 대상 식별을 위해 캠페인과 오디언스는 이름이 아닌 ID로 질문해야 합니다. 이름의 경우 중복되거나 변경될 가능성이 있어, 고유한 식별값인 ID를 기준으로 분석하도록 설계되었습니다. 캠페인 ID와 오디언스 ID는 각 메뉴의 목록 화면에서 확인하실 수 있습니다.

4. 답변의 근거가 된 SQL 쿼리를 직접 확인할 수 있나요?

아니요, 현재는 클레어가 생성한 SQL 쿼리나 분석 과정을 직접 확인하는 기능은 제공되지 않습니다. 답변의 신뢰도를 높일 수 있도록, 향후 고도화를 통해 다른 방식으로 제공해 드릴 수 있도록 개선해나갈 예정입니다.

5. 클레어가 만들어준 결과는 어떻게 저장하거나 공유하나요?

현재 클레어의 답변을 활용하는 방법은 아래와 같습니다.

• 데이터 다운로드 : 심층 분석을 통해 얻은 결과에 한해, ‘관리자’ 권한을 가진 사용자가 CSV 파일로 다운로드 할 수 있습니다.

• 공유 기능 : 분석 결과를 리포트로 공유하거나 대화 전체를 공유하는 기능은 현재 제공되지 않습니다.

6. 클레어가 분석하는 데이터는 실시간 데이터인가요?

네, 클레어는 디파이너리에 연동된 가장 최신 데이터를 기준으로 분석합니다.

7. 분석 결과는 아무나 다운로드 가능한가요?

아니요, '관리자' 권한을 가진 사용자만 분석 결과를 파일로 다운로드할 수 있습니다. 이는 데이터 보안을 위한 조치로, 같은 서비스 내 멤버라도 권한이 없으면 다운로드가 제한됩니다.

8. 답변의 양에 제한이 있나요?

네, 안정적인 성능을 위해 한 번의 질문으로 수행할 수 있는 쿼리(데이터 조회 및 처리 단위)는 최대 5개로 제한됩니다. 답변이 제공되는 방식은 분석 모드에 따라 다릅니다.

• 기본 분석: 최대 5개의 쿼리를 사용하더라도, 최종 결과는 항상 1개의 요약된 차트로 제공됩니다.

• 심층 분석: 실행된 쿼리 개수만큼 각각의 분석 결과(최대 5개)가 차트와 표로 제공됩니다.

9. 캠페인 결과 데이터가 맞지 않아요. 왜 수치 차이가 발생하나요?

클레어는 사용자의 질문을 가장 보편적이고 일반적인 방식으로 해석하며, 우리 회사만 아는 '암묵적인 비즈니스 규칙'이나 '숨은 맥락'까지는 파악하기 어렵기 때문입니다.

예시 질문 : "클릭 유저 중 구매 유저들의 구매 금액을 조회해줘"

▶️ 클레어 해석

지금까지 '클릭' 이력이 한 번이라도 있고, '구매' 이력이 한 번이라도 있는 모든 사용자의 교집합으로 해석할 가능성이 높습니다. 즉 특정 클릭과 구매의 선후 관계나 시간제한을 고려하지 않아 실제 클릭을 통해 구매로 이어진 사용자가 아닌, 구매 이후에 클릭한 사용자까지 포함했을 가능성이 높습니다.

10. 왜 질문 방식에 따라 결과가 달라지나요?

질의문에 포함된 조건(시간 범위, 측정 기준, 분석 대상)에 따라 데이터 처리 방식이 달라지기 때문입니다. 모호한 질의문은 시스템이 임의로 조건을 설정하여 예상과 다른 결과를 가져올 수 있습니다.

Tip! 시간 범위, 측정 기준, 분석 대상을 구체적으로 명시해 주세요.

▶️ 꼭 포함되어야 하는 요소

• 시간 범위 : "오늘", "이번 달", "최근 7일" 등

  • 피해야 할 표현 : "요즘", "최근에", "평소에", "일반적으로"

• 분석 대상 : "상품", "사용자", "카테고리" 등

• 측정 기준 : "매출액", "구매 건수", "사용자 수" 등

• 조회 방식 : "조회", "분석", "비교" 등

11. 답변에서 원하는 차트 형태로 변경할 수 있나요?

아니요, 현재 답변된 차트의 형태를 사용자가 직접 변경하는 기능은 지원하지 않습니다. 이는 클레어가 사용자의 질문 의도와 분석된 데이터의 특성을 모두 고려하여, 해당 정보를 가장 효과적으로 전달할 수 있는 최적의 차트 형태를 자동으로 판단하여 제공하기 때문입니다.

Tip! 만약 특별히 원하는 차트 형태가 있다면, 질문에 직접 포함하여 요청해 보세요. 질문 마지막에 '바 차트로 보여줘'라고 추가하면, 클레어가 해당 요청을 우선적으로 고려하여 답변을 생성할 수 있습니다.

12. 이전 대화 내용을 잘 기억하지 못해요.

클레어는 현재 바로 직전의 대화 1개의 맥락만 기억하도록 설계되어 있습니다.

예를 들어, "어제 신규 가입자 수는?" 이라고 질문한 뒤 "그럼 이탈률은?" 과 같은 짧은 후속 질문은 이해할 수 있습니다. 하지만 여러 단계 이전의 대화 내용을 참조하는 복잡한 질문은 이해하기 어려울 수 있습니다. 이는 시스템의 과부하를 막고 빠른 응답 속도를 유지하기 위함입니다.