사용 사례

Jev 사용 사례

플레이그라운드에 붙여넣거나 코드에 맞게 고칠 수 있는 완성된 요청 본문 8개입니다. 각각 state와 타입화된 질문을 /api/v1/decisions에 보내고, 분기에 쓸 수 있는 Noul, Choice, Score를 돌려받습니다. 성공 호출당 크레딧 1입니다.

업데이트

빈 결제 화면의 담당

이런 Choice로 들어오는 모든 티켓을 내 큐 중 하나로 보내세요. 답은 팀 이름과 옵션별 확률을 주므로, 아슬아슬한 경우는 잘못된 큐 대신 사람에게 넘길 수 있습니다.

Choice는 담당 팀과 각 팀의 확률을 반환합니다.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
이 요청을 플레이그라운드에서 열기

환불 요청인가

질문이 이진이면 Noul이 맞습니다 — 이 메시지가 돈을 돌려달라는가. 생성된 텍스트를 파싱하는 대신 noul 값으로 환불 매크로나 검토 큐를 게이트하세요.

Noul은 파싱할 문장이 아니라 예 확률을 반환합니다.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
이 요청을 플레이그라운드에서 열기

지급 실패의 긴급도

순위 판단에는 Score가 맞습니다. 직접 단계를 정의하고(여기서는 3단계 긴급도) 소수 score로 백로그를 정렬하세요. 라벨을 손으로 읽을 필요가 없습니다.

Score는 정의한 척도 위의 위치와 분포를 반환합니다.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
이 요청을 플레이그라운드에서 열기

메시지 속 자격 증명 요구

사람 검토 큐 앞에 Noul을 사전 필터로 두세요. 자격 증명을 요구하는 메시지는 확률로 표시되고, 차점 확률이 게이트의 신뢰도를 알려줍니다.

Noul 확률은 사람 검토 큐 앞의 관문입니다.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
이 요청을 플레이그라운드에서 열기

인바운드 메모 자격

Choice는 구매 의사를 영업 프로세스의 기존 버킷(ready, nurture, ignore)으로 나눕니다. 라우팅 규칙은 설명 가능하고 각 옵션에 확률이 남습니다.

Choice는 구매 시점과 관심만 있는 메모를 나눕니다.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
이 요청을 플레이그라운드에서 열기

수익 보장 문구

규칙을 자연어로 쓸 수 있는 정책 검사에는 Noul이 맞습니다. 리스팅이 수익을 보장하는지 아닌지 — 확률이 집행 신호입니다.

Noul은 적은 정책 질문에 답하고, 일반적인 안전 문장을 쓰지 않습니다.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
이 요청을 플레이그라운드에서 열기

갱신 메모의 이탈 위험

벤더의 감정 점수 대신 내 사다리로 갱신 위험을 채점하세요. 단계가 직접 정한 것이라 소수 score가 이미 있는 플레이북 단계로 바로 매핑됩니다.

Score는 이탈 가능성이 낮은 단계에서 높은 단계까지 세 칸을 씁니다.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
이 요청을 플레이그라운드에서 열기

어떤 송장 예외인가

'both' 옵션이 있는 Choice는 두 번째 호출 없이 복합 예외를 잡습니다. 경리팀은 예외 유형과 옵션별 확률로 분쟁을 라우팅합니다.

Choice는 발주 초과, 예상 밖 항목, 또는 둘 다와 확률을 반환합니다.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
이 요청을 플레이그라운드에서 열기

조합되는 패턴

위 예시는 단일 호출입니다. TypeSafe 문서는 이를 조합하는 몇 가지 패턴을 설명합니다.

  • Confidence 게이트 라우팅 — confidence가 기준을 넘을 때만 자동 처리하고 나머지는 사람에게 보냅니다.
  • 투기적 팬아웃 — Choice 옵션 순서를 바꾸거나 상태를 줄여 같은 질문을 하고 답의 일관성을 비교합니다.
  • 가드레일 — 사용자 입력이 생성 모델이나 프로덕션 동작에 닿기 전에 Noul을 실행합니다.
  • RAG 구절 필터링 — 후보 구절마다 Noul 또는 Score를 실행해 생성 전에 관련 컨텍스트만 남깁니다.

자주 묻는 질문

각 예시 실행 비용은?

각 요청은 /api/v1/decisions 한 번 호출이므로 성공하면 질문 수와 관계없이 크레딧 1입니다. 검증 오류와 업스트림 실패는 무료입니다.

이 중 여러 개를 한 번에 물을 수 있나요?

네 — questions는 맵이라서 라우팅 Choice, 환불 Noul, 긴급도 Score가 하나의 state를 공유하는 한 호출에 들어가도 크레딧 1입니다.

플레이그라운드 말고 코드에서 실행하려면?

같은 JSON 본문을 Bearer 키와 함께 https://jev-api.org/api/v1/decisions에 POST하거나, https://jev-api.org를 가리키는 TypeSafe SDK로 /v1/systemone을 사용하세요.

답의 confidence는 무슨 뜻인가요?

Choice와 Score 답에는 확률 분포에서 유도된 confidence가 있습니다. 낮은 confidence나 가까운 두 옵션은 결정이 경계선이었음을 뜻하며 사람 검토 후보입니다.

지금 하나 실행하기

위의 각 요청은 플레이그라운드에서 미리 채워져 열립니다. 가격 페이지에서 작은 일회성 크레딧 팩을 충전하고 로그인해 바로 실행하세요. 실패한 호출은 크레딧을 쓰지 않습니다.