Jev入門｜型付きの判断を返すSystem Oneモデルの基本

from typesafe_sdk import Noul, TypeSafeClient

with TypeSafeClient() as client:
    res = client.system_one(
        state="請求書の金額が契約書と違います。至急確認をお願いします。",
        questions={"is_urgent": Noul(instructions="送り手は急ぎだと伝えている")},
    )

print(res.answers["is_urgent"].noul)  # 0.0〜1.0
print(res.model)                      # jev-1.13.0
print(res.usage.input_tokens)

TypeSafeError: No API key was provided. Pass api_key or set the TYPESAFE_API_KEY environment variable.

from typesafe_sdk import Noul

Noul(instructions="この文章には個人情報が含まれている")

print(res.answers["has_pii"].noul)  # 0.93

from typesafe_sdk import Choice, TypeSafeClient

with TypeSafeClient() as client:
    res = client.system_one(
        state={"摘要": "懇親会 一式", "勘定科目": "交際費"},
        questions={
            "expense_type": Choice(
                instructions="この支出の費用区分はどれか",
                criteria={
                    "meeting": "社内打合せの飲食",
                    "entertainment": "取引先の接待・贈答",
                    "other": "判断できない",
                },
            )
        },
    )

a = res.answers["expense_type"]
print(a.choice)         # 'entertainment'
print(a.confidence)     # 0.94
print(a.probabilities)  # {'meeting': 0.02, 'entertainment': 0.96, 'other': 0.02}

from typesafe_sdk import Score

Score(
    instructions="摘要が、第三者が取引内容を特定できる程度に具体的か",
    criteria=[
        "内容がまったく特定できない",
        "費目は分かるが相手先や目的が不明",
        "相手先・目的が具体的に書かれている",
    ],
)

s = res.answers["detail"]
print(s.score)          # 0.28
print(s.confidence)     # 0.58
print(s.probabilities)  # {0: 0.72, 1: 0.28, 2: 0.0}
print(s.legend)         # {0: '内容がまったく特定できない', 1: ..., 2: ...}

confidence = (n × p − 1) / (n − 1)

a = res.answers["expense_type"]

if a.confidence < 0.5:
    to_human_review(record)          # 判断が割れている。人が見る
elif a.confidence < 0.9:
    apply_with_flag(a.choice)        # 採用するが、印を付けておく
else:
    apply(a.choice)                  # そのまま処理する

from typesafe_sdk import Choice, Noul, Score, TypeSafeClient

with TypeSafeClient() as client:
    res = client.system_one(
        state={"摘要": "懇親会 一式", "勘定科目": "交際費", "計上部門": "営業部"},
        questions={
            "expense_type": Choice(
                instructions="この支出の費用区分はどれか",
                criteria={
                    "meeting": "社内打合せの飲食",
                    "entertainment": "取引先の接待・贈答",
                    "other": "判断できない",
                },
            ),
            "detail": Score(
                instructions="摘要が、第三者が取引内容を特定できる程度に具体的か",
                criteria=[
                    "内容がまったく特定できない",
                    "費目は分かるが相手先や目的が不明",
                    "相手先・目的が具体的に書かれている",
                ],
            ),
            "private_doubt": Noul(
                instructions="個人的な支出が混ざっている疑いを説明する必要がある",
            ),
        },
    )

for name, ans in res.answers.items():
    print(name, ans.type)

from typesafe_sdk import (
    RetryPolicy,
    TypeSafeAPIError,
    TypeSafeAuthenticationError,
    TypeSafeRateLimitError,
    TypeSafeClient,
)

retry = RetryPolicy(max_retries=4, backoff_initial=0.5, backoff_max=8.0)

with TypeSafeClient(timeout=20.0) as client:
    try:
        res = client.system_one(state=..., questions=..., retry=retry)
    except TypeSafeRateLimitError:
        ...  # レート超過。時間をおく
    except TypeSafeAuthenticationError:
        ...  # APIキーが不正
    except TypeSafeAPIError as e:
        ...  # その他のAPIエラー