判断 API

Jev API

1 回の 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 は「解約しにくい」から「解約しやすい」までの 3 段階です。

{
  "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 は勝者に加え、定義した各選択肢の確率も返します。

1 回の呼び出しで 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 の値です。
サポートリード
2 チームが近いとき、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 に沿って自分のキーで呼び出します。