메인 콘텐츠로 건너뛰기

​
사전 준비

  • LexQ 계정 (무료 가입)
  • API 키 (콘솔 → 관리 → API 키에서 생성)

​
1단계: 정책 그룹 생성

1

콘솔 열기

console.lexq.io로 이동하여 로그인합니다.
2

그룹 생성

정책 그룹 → 그룹 생성을 클릭합니다.
  • 이름: discount-policy
  • 우선순위: 0
  • 실행 제어 방식: 제한 없음 (NONE)
3

버전 생성

새 그룹에서 새 초안 생성을 클릭합니다. 규칙을 추가할 수 있는 DRAFT 버전이 생성됩니다.

​
2단계: 규칙 정의

1

규칙 추가

규칙 편집 탭에서 규칙 추가를 클릭합니다.
  • 이름: 고액 결제 할인
  • 우선순위: 0
2

조건 설정

payment_amount 팩트를 사용하여 조건을 추가합니다:
payment_amount >= 100000
3

액션 추가

MUTATE_FACT 액션을 추가합니다:
  • 기준 팩트 (refVar): payment_amount
  • 연산자 (operator): SUB (refVar에서 차감)
  • 방식: 비율 (Percentage)
  • 비율: 10 (refVar를 10% 감소)
user_id, email, user_tags는 시스템 팩트로 이미 등록되어 있어 바로 사용할 수 있습니다. payment_amount나 customer_tier처럼 도메인별 팩트는 사용자가 정의합니다 — 팩트 정의를 참조하세요.

​
3단계: 드라이런으로 테스트

배포 전에 드라이런으로 규칙을 검증합니다: 
curl -X POST https://api.lexq.io/api/v1/partners/analytics/dry-run/versions/{versionId} \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "facts": {
        "payment_amount": 150000,
        "user_id": "user-001"
    },
    "includeDebugInfo": true,
    "mockExternalCalls": true
}'
응답에서 변경된 payment_amount: 135000과 generatedVariables의 payment_amount__delta: -15000(룰이 적용한 부호 포함 변화량)이 출력되면 성공입니다.

​
4단계: 발행 및 배포

1

발행

버전 발행을 클릭합니다. 버전이 DRAFT에서 ACTIVE로 전환되며 잠깁니다 — 더 이상 편집할 수 없습니다.
2

배포

라이브 배포를 클릭합니다. 배포 메모를 입력하고 확인합니다. 정책이 이제 라이브 상태이며 트래픽을 처리합니다.

​
5단계: API로 실행

애플리케이션에서 실행 엔드포인트를 호출합니다: 
curl -X POST https://api.lexq.io/api/v1/execution/groups/{groupId} \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "facts": {
        "payment_amount": 150000,
        "user_id": "user-001"
    }
}'

​
다음 단계

팩트 정의

customer_tier, order_region 같은 커스텀 변수를 추가합니다.

변경 영향 시뮬레이션

배포 전에 대량 데이터로 정책을 테스트합니다.

정책 실행

4가지 실행 모드(단일, 버전, 배치, 복합)를 알아봅니다.

CLI & MCP

터미널 또는 AI 에이전트로 정책을 관리합니다.