Genie — 자연어 데이터 분석

지시사항 예시:
- "매출"이라고 하면 total_revenue 컬럼을 사용하세요
- 금액의 단위는 원(KRW)입니다
- "이번 달"은 현재 월을 의미합니다
- "VIP 고객"은 tier = 'Gold' 또는 tier = 'Platinum'인 고객입니다
- 날짜 관련 질문에는 order_date 컬럼을 기준으로 답변하세요
- 답변은 항상 한국어로 제공하세요

-- 인증된 답변으로 등록할 SQL 쿼리 예시
-- 질문: "이번 달 순매출은?"

SELECT
    DATE_TRUNC('MONTH', order_date) AS 월,
    SUM(CASE WHEN type = 'SALE' THEN amount ELSE 0 END)
    - SUM(CASE WHEN type = 'RETURN' THEN amount ELSE 0 END)
    - SUM(CASE WHEN type = 'DISCOUNT' THEN amount ELSE 0 END) AS 순매출
FROM gold.transactions
WHERE order_date >= DATE_TRUNC('MONTH', CURRENT_DATE())
GROUP BY 1;

👤 CEO: "지난 분기 대비 이번 분기 매출 성장률은?"
🧞 Genie: "2025년 1분기 매출은 45.2억원으로, 전 분기(42.8억원) 대비 5.6% 성장했습니다."
         [차트: 분기별 매출 추이 막대 그래프]

👤 CEO: "가장 성장이 빠른 지역은?"
🧞 Genie: "대전 지역이 전분기 대비 23.4% 성장으로 가장 높은 성장률을 보였습니다."
         [표: 지역별 성장률 순위]

👤 마케터: "3월 프로모션 기간 동안 신규 고객 수는?"
🧞 Genie: "3월 1일~15일 프로모션 기간 동안 신규 가입 고객은 1,847명입니다."

👤 마케터: "그 중 실제 구매한 고객 비율은?"
🧞 Genie: "1,847명 중 623명(33.7%)이 첫 구매를 완료했습니다."

권장 운영 전략:

1. 핵심 KPI (매출, DAU, 이탈률 등)
   → 반드시 Trusted Assets 등록 (정확도 100% 보장)

2. 자주 묻는 질문 Top 20
   → Trusted Assets 등록 (80/20 법칙 적용)

3. 탐색적 질문
   → Genie AI가 생성 (지시사항으로 가이드)
   → 사용자가 SQL 검증 후 사용

# Genie Space 품질 테스트 자동화 예시
test_cases = [
    {
        "question": "이번 달 총 매출은?",
        "expected_columns": ["total_revenue"],
        "expected_range": (1_000_000, 1_000_000_000),  # 합리적 범위
        "must_contain_table": "gold.daily_revenue"
    },
    {
        "question": "VIP 고객 수는?",
        "expected_columns": ["customer_count"],
        "expected_sql_contains": "tier IN ('Gold', 'Platinum')",  # 비즈니스 로직 확인
    },
]

# Genie API로 자동 테스트 (SDK 활용)
from databricks.sdk import WorkspaceClient
w = WorkspaceClient()

for tc in test_cases:
    # Genie Space에 질문 전송
    response = w.genie.start_conversation(
        space_id="<genie-space-id>",
        content=tc["question"]
    )
    # 생성된 SQL 검증
    generated_sql = response.attachments[0].query.query
    assert tc["must_contain_table"] in generated_sql, f"잘못된 테이블 참조: {generated_sql}"

전사 Genie 아키텍처:

[경영진 Genie Space]
  - 테이블: gold.executive_summary, gold.kpi_monthly
  - 지시사항: 경영 지표 중심, 한국어 답변
  - 사용자: C-Level, VP

[영업팀 Genie Space]
  - 테이블: gold.sales_pipeline, gold.customer_360
  - 지시사항: 영업 용어 정의, 파이프라인 단계 설명
  - 사용자: 영업 담당자

[마케팅팀 Genie Space]
  - 테이블: gold.campaign_performance, gold.customer_segments
  - 지시사항: 캠페인 관련 용어, 전환율 계산 방법
  - 사용자: 마케터

[재무팀 Genie Space]
  - 테이블: gold.financial_ledger, gold.budget_vs_actual
  - 지시사항: 회계 용어, 기간 구분 규칙
  - 사용자: 재무팀

-- 행 필터: 사용자가 담당하는 지역의 데이터만 조회 가능
CREATE FUNCTION gold.region_filter(region_col STRING)
RETURN IF(
    IS_ACCOUNT_GROUP_MEMBER('all-regions-access'),
    TRUE,
    region_col = CURRENT_USER_ATTRIBUTE('region')
);

ALTER TABLE gold.sales_data
SET ROW FILTER gold.region_filter ON (region);

-- 컬럼 마스크: 급여 컬럼을 HR 팀만 볼 수 있음
CREATE FUNCTION gold.salary_mask(salary_col DECIMAL)
RETURN IF(
    IS_ACCOUNT_GROUP_MEMBER('hr-team'),
    salary_col,
    NULL
);

ALTER TABLE gold.employee_data
SET COLUMN MASK gold.salary_mask ON salary;

[1] 사용자가 Genie에 질문
    ↓
[2] Genie가 SQL 생성 + 결과 반환
    ↓
[3] 사용자가 결과에 👍/👎 피드백
    ↓
[4] 관리자가 👎 피드백 분석
    ↓
[5-a] 반복적인 오류 → Trusted Asset 등록
[5-b] 용어 문제 → 지시사항 보완
[5-c] 데이터 문제 → 테이블/컬럼 설명 보완
    ↓
[6] 다음 주기에 동일 질문으로 검증