클레어 활용하기

AI 크루 - '클레어'

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

클레어의 주요 기능

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

• 투명한 추론 과정 확인 가능 : 클레어가 어떤 단계를 거쳐 답변을 생성하는지 실시간으로 확인하여 결과의 신뢰도를 높입니다.

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

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

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

클레어를 잘 활용하는 방법

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

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

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

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

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

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

상세 작성 가이드

기본 공식

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

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

올바른 작성법

요소	올바른 예시	설명
시간 범위	오늘, 이번 달, 최근 7일	구체적이고 명확한 기간
측정 지표	매출, 사용자 수, 전환율	수치로 측정 가능한 지표
분석 대상	카테고리별, 디바이스별, 지역별	필요 시 세분화 조건
동작어	조회, 분석, 비교	데이터 중심 동작어

프롬프트 작성 시 추가 팁

1. 분석 기간을 명시하지 않을 경우, LLM이 자동으로 판단한 기간을 기준으로 분석이 진행됩니다.

2. ‘이탈율’, ‘전환율’ 등 특정 용어의 정의를 사전에 입력하면 결과의 정확도가 더욱 높아집니다.

3. 캠페인 분석 시, 캠페인 ID를 반드시 명시해야 합니다.

4. 오디언스를 지정할 경우, 오디언스 ID를 반드시 명시해야 합니다.

피해야 할 표현

피해야 할 표현	문제점	개선 방법
"요즘 매출이 어때?"	시간 범위 모호	"최근 7일 일별 매출액 추이 조회"
"성과 좀 보여줘"	지표 불명확	"이번 달 총 매출액 조회"
"어떤 상품이 인기야?"	시간, 기준 불명확	"오늘 구매 금액 기준 상위 10개 상품 조회"

지표별 질의문 예시

1. 매출 관련

구분	예시
기본 매출 조회	"오늘 총 매출액 조회" "이번 달 순매출액 현황(환불 제외)"
순위 기반 조회	"오늘 매출액 기준 상위 10개 상품 조회" "이번 달 매출액 기준 상위 5개 카테고리 조회"
추세 조회	"최근 7일 일별 매출액 추이" "이번 달 주별 매출액 현황"
세분화 조회	"오늘 모바일 디바이스 매출액 조회" "이번 달 서울 지역 매출액 현황"

1. 사용자 관련

구분	예시
사용자 현황	"회원등급별 사용자 수 조회" "이번 달 신규 가입자 수 현황" "최근 30일 지역별 사용자 수 분포"

1. 상품/카테고리 관련

구분	예시
상품 성과	"오늘 구매 건수 기준 상위 10개 상품 조회" "이번 달 판매량 기준 상위 카테고리 순위" "최근 30일 상품별 평균 구매 금액"

기본 분석과 심층 분석

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

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

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

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

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

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

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

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

'클레어' 관련 FAQ

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

아니요, 클레어는 답변의 정확도를 높이기 위해 'AI 분석 설정'에 등록된 데이터 범위 안에서만 분석을 수행합니다.

기본적으로 디파이너리의 표준 데이터는 자동으로 연동되며, 우리 서비스만의 커스텀 데이터는 설정 메뉴에서 직접 추가하여 분석 범위를 확장할 수 있습니다.

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

• 표준 데이터 : 구매, 회원가입 등 기본 제공 이벤트 및 속성 (자동 연동)

• 커스텀 데이터 : 직접 정의한 이벤트 및 속성 (설정에서 수동 추가 필요, 최대 50개)

• 기타 : 수신 동의 정보, CRM 캠페인/오디언스 ID 등 (자동 연동)

분석 가능한 데이터 범위

더 자세한 항목은 데이터 연동 및 분석 범위 를 참고해 주세요.

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

아니요, 가능합니다. 단, 기본 설정은 '미연동' 상태이므로 [AI 데이터 연동 설정] 메뉴에서 분석하려는 커스텀 이벤트를 직접 설정해야 합니다. (최대 50개)

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

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

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

네, 답변 내 [적용된 조건] 섹션을 통해 답변이 어떤 데이터를 기반으로 생성되었는지 확인할 수 있습니다. SQL 쿼리문 대신, 비즈니스 정의와 사용자 질문을 조합하여 생성한 최종 분석 기준을 문장 형태로 보여줍니다.

이번 주 매출 증가율을 보여줘(전주 대비) 질의 시 [적용된 조건] 예시 [적용된 조건]

• 이번 주: 2025년 11월 24일부터 11월 30일까지

• 전주: 2025년 11월 17일부터 11월 23일까지

• 매출액 = (상품 가격 - 할인액) × 구매 수량의 합계

• 증가율(%) = (이번 주 매출액 - 전주 매출액) ÷ 전주 매출액 × 100

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

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

• 텍스트 복사 : 마크다운 형식으로 답변 내용 복사 가능

• 차트 다운로드 : 차트 우측 상단 버튼으로 PNG 이미지 저장

• 리포트 다운로드 : 전체 분석 결과를 PDF 파일로 저장

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

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

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

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

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

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

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

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

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

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

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

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

▶️ 클레어 해석

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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