사용 사례
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나 가까운 두 옵션은 결정이 경계선이었음을 뜻하며 사람 검토 후보입니다.
지금 하나 실행하기
위의 각 요청은 플레이그라운드에서 미리 채워져 열립니다. 가격 페이지에서 작은 일회성 크레딧 팩을 충전하고 로그인해 바로 실행하세요. 실패한 호출은 크레딧을 쓰지 않습니다.