Jev API 入門：最初のリクエスト

利用準備

TypeSafe の公式コンソールでキーを作り、サーバー側の環境変数 TYPESAFE_API_KEY に保存します。ブラウザーのコードや共有 URL に入れないでください。最新の利用条件は公式コンソールで確認します。

リクエストの形

公式エンドポイントに state、model、questions を含む JSON を POST します。state は今回の事実、questions は質問 ID と型付き質問の対応です。下の例は架空の問い合わせです。

結果の確認

HTTP 状態と answers の質問 ID を確かめ、choice、probabilities、confidence を読みます。不確実な場合は人の確認へ回します。confidence を検証済み正解率とみなさないでください。

最初の呼び出し前の確認

鍵はサーバー側で保管し、SDK に必要な Python 版を確認し、個人情報を除いた例を使います。質問 ID と候補のキーを固定し、タイムアウト、制限、項目不足の際は人へ渡します。当サイトのラボは鍵を受け取りません。

コードを理解して使う

state は一回の判断に必要な事実、model は版または別名、team はコードが返り値を読む ID です。criteria のキーは処理可能な候補を示します。review や項目不足の場合は自動処理を止めます。

一回の成功から評価へ

最初の成功は接続、権限、形式を示すだけです。匿名化して正解を付けた例で、返り値、要求 ID、時間、最終動作を記録します。質問やモデルを変えたら再試験します。

リクエスト例 · HTTP

これは設計案であり、Jev の実際の回答や精度測定ではありません。

curl -X POST https://api.typesafe.ai/v1/systemone \
  -H "Authorization: Bearer $TYPESAFE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"My parcel says delivered, but nothing arrived.","model":"jev-latest","questions":{"team":{"type":"choice","instructions":"Which team should handle this request?","criteria":{"shipping":"Delivery or missing package","billing":"Payment or charges","other":"None of the above"}}}}'

Python SDK

from typesafe_sdk import Choice, TypeSafeClient

with TypeSafeClient() as client:
    response = client.system_one(
        state="My parcel says delivered, but nothing arrived.",
        questions={
            "team": Choice(
                instructions="Which team should handle this request?",
                criteria={
                    "shipping": "Delivery or missing package",
                    "billing": "Payment or charges",
                    "other": "None of the above",
                },
            )
        },
    )
    answer = response.answers["team"]
    print(answer.choice, answer.confidence)

実行できる Python の例

サーバー側で TYPESAFE_API_KEY を設定し、pip install typesafe-sdk で公式 SDK を入れます。実行前に公式資料で版と利用条件を確認してください。