결정 API

Jev API

POST 한 번으로 상태와 질문을 보냅니다. 응답은 분기할 수 있는 확률이 붙은 Noul, Choice, Score입니다.

POST /api/v1/decisions

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}

예시

바로 실행할 수 있는 결정 8개

카드에 올리면 요청이 보입니다. 복사하거나 플레이그라운드에서 여세요.

빈 결제 화면의 담당

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은 파싱할 문장이 아니라 예 확률을 반환합니다.

{
  "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는 정의한 척도 위의 위치와 분포를 반환합니다.

{
  "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 확률은 사람 검토 큐 앞의 관문입니다.

{
  "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는 구매 시점과 관심만 있는 메모를 나눕니다.

{
  "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은 적은 정책 질문에 답하고, 일반적인 안전 문장을 쓰지 않습니다.

{
  "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는 이탈 가능성이 낮은 단계에서 높은 단계까지 세 칸을 씁니다.

{
  "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"
      ]
    }
  }
}
플레이그라운드에서 열기

어떤 송장 예외인가

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."
      }
    }
  }
}
플레이그라운드에서 열기

응답

코드가 분기할 수 있는 답

Jev는 파싱할 문단을 쓰지 않습니다. 요청한 결정과 그 확률을 반환합니다.

모든 선택지에 확률이 남음

Choice는 승자와 함께 정의한 각 선택지의 확률을 반환합니다.

한 호출의 Noul, Choice, Score

예/아니오, 라벨 선택, 척도 위 위치는 같은 상태를 공유할 수 있습니다.

질문은 함께 평가

같은 상태에 대한 추가 질문은 왕복을 늘리지 않고 그 요청에 남습니다.

임계값이 중요하면 모델을 고정

컷오프를 맞출 때는 jev-1.13을 보내세요. jev-latest는 이 API가 현재 제공하는 버전입니다.

사용 방법

Jev API 호출 방법

  1. 01

    키 만들기

    로그인한 뒤 대시보드에서 키를 복사하세요. 플레이그라운드가 계정용 키를 만들 수 있습니다.

  2. 02

    상태와 질문을 POST

    본문에는 model, state, 질문 맵이 있습니다. id는 라벨이고 질문 문장은 instructions에 둡니다.

  3. 03

    타입 답으로 분기

    noul, choice, score를 읽으세요. Choice와 Score의 confidence는 선택지가 가까운지 알려 줍니다.

사용 사례

자유 프롬프트 대신 타입 결정을 쓰는 곳

지원 라우팅

티켓 본문과 실제로 사람이 있는 큐를 보내세요. 이긴 팀으로 분기하고, 확률이 가까우면 사람에게 넘깁니다.

신뢰와 검토

구체적인 정책 질문을 하세요. Noul이 높으면 보류, 낮으면 통과, 중간은 검토입니다.

인바운드 자격

업무와 구매 시점이 있는 메모와, 흥미만 적은 메모를 나눕니다.

송장 예외

지급 팀이 이미 쓰는 예외 이름을 쓰세요. Score 설명이나 Choice 키가 그 목록과 맞습니다.

첫 호출 이후

답이 타입이 되면 무엇이 바뀌나

티켓이 환불인지 문단을 파싱하지 않습니다. 분기는 noul 값입니다.
지원 리드
두 팀이 가까울 때 confidence가 추측 대신 사람에게 넘기라고 알려 줬습니다.
신뢰 엔지니어
점수 단계는 우리 문장입니다. 응답의 설명은 이미 쓰는 기준과 같습니다.
청구 운영

요청과 답에 대한 질문

Noul, Choice, Score의 차이는?

Noul은 확률이 있는 예/아니오입니다. Choice는 적은 선택지 중 하나를 고르고 각 확률을 반환합니다. Score는 낮은 순서의 척도에 놓습니다.

이기지 못한 선택지에도 확률이 있는 이유?

차점자는 사람에게 넘길 신호입니다. 둘이 가까우면 승자를 확정으로 보지 마세요.

jev-1.13과 jev-latest 중 무엇?

코드의 컷오프가 확률 형태에 의존하면 jev-1.13을 고정하세요. 이 API는 jev-latest도 받으며 현재 같은 모델입니다.

state에는 무엇을 넣을 수 있나?

문자열, JSON 객체, 또는 텍스트 배열입니다. 질문에 필요한 사실을 넣고, 기대하는 답은 넣지 마세요.

confidence가 낮으면?

불확실한 사례로 보세요. 사람에게 넘기거나 더 구체적인 질문을 하나 더 하세요. 가까운 결과를 보기 전에 컷오프를 낮추지 마세요.

422는 무슨 뜻인가?

본문 검증에 실패했습니다. 메시지가 필드를 가리킵니다. instructions 누락, Choice 옵션 2개 미만, Score 순서, snake_case가 아닌 id입니다.

첫 결정을 보내기

예시 하나로 플레이그라운드를 열거나, Jev Docs를 따라 자신의 키로 호출하세요.