메인 콘텐츠로 건너뛰기

사전 준비

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

1단계: 정책 그룹 생성

1

콘솔 열기

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

그룹 생성

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

버전 생성

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

2단계: 규칙 정의

1

fact 등록

아래 액션이 paymentAmount에 값을 쓰므로 먼저 fact로 등록합니다. 관리 → fact 정의에서 fact 추가를 클릭하고 다음과 같이 입력합니다.
  • 키 (Key): paymentAmount
  • 표시명 (Name): 결제 금액
  • 데이터 타입: NUMBER
액션이 값을 쓰는 fact가 등록되어 있지 않으면 규칙을 저장할 수 없습니다(ACT-032).
2

규칙 추가

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

조건 설정

paymentAmount fact를 사용하여 조건을 추가합니다:
4

액션 추가

MUTATE_FACT 액션을 추가합니다:
  • 대상 fact (targetVar): paymentAmount
  • 연산자 (operator): SUB (targetVar에서 차감)
  • 방식 (method): 비율 (Percentage)
  • 값 (operand): 10 (targetVar를 10% 감소)
userId, userTags는 미리 등록되어 있어 바로 사용할 수 있습니다. paymentAmount나 customerTier처럼 도메인별 fact는 사용자가 정의합니다. fact 정의를 참조하세요.

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

배포 전에 드라이런으로 규칙을 검증합니다:
응답에서 변경된 paymentAmount: 135000과 generatedVariables의 paymentAmount__delta: -15000(규칙이 적용한 부호 포함 변화량)이 출력되면 성공입니다.

4단계: 발행 및 배포

1

발행

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

배포

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

5단계: API로 실행

애플리케이션에서 실행 엔드포인트를 호출합니다:
위 스니펫은 호출 자체입니다. 오류 처리·멱등·타입까지 갖춘 완성된 서비스는 실행 가능한 예제(Java·TypeScript, GitHub)에 있습니다.

다음 단계

fact 정의

customerTier, orderRegion 같은 커스텀 변수를 추가합니다.

변경 영향 시뮬레이션

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

정책 실행

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

CLI & MCP

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