jev-agent

Jev エージェント

Jev AI は、ソフトウェアやエージェント向けの意思決定サービスです。アプリケーションの状態と明示的に型付けされた質問を受け取り、確率を含む構造化された回答を返します。ワークフロー、権限、人間による承認、最終的なアクションは、引き続きエージェントまたはアプリケーションが管理します。

初回利用時のセットアップ

セッションで最初に Jev へリクエストを送る前に、次の環境変数が利用可能か確認します。シェルの履歴、リポジトリ内のファイル、または無関係なファイルからシークレットを探してはいけません。

JEV_LANGUAGE      optional response language: en-US or zh-CN; default en-US
JEV_API_KEY       required Jev AI key created in the user's Jev AI account
JEV_API_BASE_URL  optional API origin; default https://thejevai.com
JEV_MODEL         optional model id; default typesafe/jev-1.13

JEV_LANGUAGE が設定されていない場合、このスキルのガイダンスと生成される例で使用する言語をユーザーに尋ねます。英語（en-US）と簡体字中国語（zh-CN）を提示し、en-US をデフォルトにする場合は、デフォルトであることをユーザーに伝えてから使用します。言語設定はエージェントのコミュニケーションと質問の表現を制御しますが、モデルの API コントラクトは変更しません。

JEV_API_KEY が設定されていない場合、ユーザーが https://thejevai.com/settings/apikeys でキーを作成できることを説明し、エージェントのローカル環境に設定するよう求めます。プレースホルダーコマンドを使用し、実際のシークレットを会話に貼り付けるようユーザーに求めてはいけません。

export JEV_API_KEY="sk_your_key_here"
export JEV_LANGUAGE="en-US"

JEV_API_KEY を出力、ログ記録、コミットしたり、ソースコード、実際の値を含む Markdown の例、クライアントバンドル、または生成された成果物に記載したりしてはいけません。キーがない状態はセットアップ中であり、キーを推測したり、OpenRouter、TypeSafe、またはサードパーティのプロキシキーを黙って使用したりする理由にはなりません。

セットアップ中は、設定された言語で次の簡潔なヘルプを表示してから、ユーザーのタスクに戻ります。デフォルトの英語のヘルプは次のとおりです。

Jev Agent can help you:
- use Choice for classification, routing, and selecting among candidates;
- use Score for risk, priority, and quality ratings;
- use Noul for yes/no probabilities, gates, escalation, and human review.

Basic flow: prepare minimal state → ask a clear question → read answers → let
your code or agent decide the next action.
Jev judges; it does not write long-form content, execute tools, or grant
permissions.

JEV_LANGUAGE=zh-CN の場合は、同じヘルプを簡体字中国語で表示します。

Jev Agent 可以帮助你：
- 用 Choice 做分类、路由和候选项选择；
- 用 Score 做风险、优先级和质量评分；
- 用 Noul 做真假概率、放行、升级和人工复核判断。

基本流程：准备最小 state → 提出明确问题 → 读取 answers → 由代码或 Agent 执行动作。
Jev 负责判断，不负责写长文本、执行工具或授予权限。

後でユーザーが help、帮助、設定、またはセットアップの確認を求めた場合は、設定された言語で同じヘルプを表示し、キーの値は明かさず、キーが存在するかどうかだけを伝えます。

Jev を使用する場面

リクエストの前に回答の範囲を定義でき、その結果がプログラムやエージェントの分岐に使用される場合は、Jev を使用します。たとえば、次のような場合です。

• タスク、チケット、リクエスト、またはコンテキストを、既知の複数の経路のいずれかに振り分ける。
• テキストから、範囲が限定された値を分類または抽出する。
• 定められた尺度に基づいて、緊急度、リスク、品質、または複雑さを評価する。
• 証拠が十分か、ツールの呼び出しにレビューが必要か、タスクをエスカレーションすべきかを判断する。
• 古いコンテキストを保持するか、切り詰めるか、破棄するかを判断する。

文章生成、コード生成、説明、データベースの正確な検索、算術、認証、認可、または決定論的に表現できるルールには Jev を呼び出さないでください。影響の大きいアクションについて、Jev はリスクのシグナルを提供できますが、決定論的なポリシー、権限、人間による承認を常に優先しなければなりません。

API コントラクト

ホスト型 API は、Jev の意思決定プロバイダーをラップした REST API です。

POST https://thejevai.com/v1/systemone
Authorization: Bearer $JEV_API_KEY
Content-Type: application/json

ユーザーが別の互換性のあるオリジンを明示的に指定した場合は、JEV_API_BASE_URL を使用します。このサービスのデフォルトモデルは typesafe/jev-1.13 です。対象のサーバーがそのエイリアスに対応していることをユーザーが確認しない限り、公式の TypeSafe エイリアス jev-latest に置き換えないでください。

リクエストボディには、次の3つの必須フィールドがあります。

{
  "model": "typesafe/jev-1.13",
  "state": "A customer was charged twice for the same order.",
  "questions": {
    "needs_human": {
      "type": "noul",
      "instructions": "Does this case require human review before a refund?"
    }
  }
}

state は文字列、オブジェクト、または配列にできます。意思決定に必要な事実だけを送信し、秘密情報、支払い認証情報、無関係な個人データは削除してください。

質問の種類：

• choice：criteria オブジェクトから1つの選択肢を選びます。
• score：criteria 配列にある順序尺度を評価します。
• noul：はい／いいえで答えられる文が真である確率を返します。

質問ごとに、範囲を絞った判断を1つ尋ねてください。同じ状態を共有する関連した独立の質問は、1つのリクエストにまとめます。同じリクエスト内で、後の質問を前の回答に依存させないでください。必要な根拠をアプリケーションが取得した後に、2回目のリクエストを行ってください。

API は、標準の Jev AI エンベロープを返します。

{
  "code": 0,
  "message": "ok",
  "data": {
    "result": {
      "answers": {
        "needs_human": {
          "type": "noul",
          "noul": 0.94
        }
      },
      "usage": {
        "input_tokens": 42,
        "output_tokens": 0
      },
      "elapsedMs": 180
    },
    "creditsUsed": 1
  }
}

choice と score では、返された choice または score と、その probabilities および confidence を確認してください。noul では、0から1までの値として noul を確認してください。確率と信頼度は判断材料として扱い、証明や承認とは見なさないでください。閾値は、ユーザーの実際のリスクと過去のデータに基づいて選んでください。普遍的な閾値を独自に設定しないでください。

API の呼び出し

ユーザーがすでに使用している技術スタックとサーバー側のコードを使ってください。シェルによる最小限のリクエストは、意図的に行う低リスクのテストに限り有用です。Skill の存在を示すためだけに実際のリクエストを行わないでください。ユーザーが Jev を利用するワークフローを依頼している場合は、そのワークフローの一部としてリクエストを行ってください。

JEV_BASE_URL="${JEV_API_BASE_URL:-https://thejevai.com}"
curl -sS "$JEV_BASE_URL/v1/systemone" \
  -H "Authorization: Bearer $JEV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "typesafe/jev-1.13",
    "state": "The customer has tried to connect Stripe for three days.",
    "questions": {
      "urgent": {
        "type": "noul",
        "instructions": "Does this message express urgency?"
      }
    }
  }'

クレジットを消費する可能性があるリクエストや、機密データを含むリクエストを、ユーザーが依頼していないのに行う場合は、事前に確認を求めてください。Jev リクエスト自体は、判断対象のアクションを実行しません。

エラーは明示的に処理してください。

• 2xx 以外の応答：ステータスと、安全に開示できるエラーメッセージを提示します。
• code が 0 以外：data を有効な結果として読み取らないでください。
• data.result.answers がない：応答を無効として扱います。
• 401：ローカルの API キー設定を確認するようユーザーに依頼します。
• 402：クレジットを追加するか、有効なアカウントキーを使うようユーザーに依頼します。
• タイムアウト、429、アップストリームの障害：周囲のワークフローで安全に再試行できる場合に限り、上限を設けたバックオフ付き再試行を行います。
• 意思決定リクエストに失敗したことだけを理由に、重大なアクションを繰り返さないでください。

エージェントの安全境界

この Skill は、エージェントがいつ、どのように Jev に判断を求めるかを説明するものです。新しいツールを作成したり、権限を付与したり、シェル呼び出しを傍受したり、エージェントが既存の権限を持たない範囲でポリシーを強制したりするものではありません。エージェントは引き続き、必要な場合はユーザーに確認を求め、現在のワークスペースとツールの制限に従い、取り消せないアクションを決定論的なチェックと通常の承認プロセスの対象にする必要があります。

質問の定義、ビジネス上の閾値、アクションへのマッピングは、レビューしやすい小さなコード領域にまとめてください。ワークフローで監査証跡が必要な場合は、モデルのバージョン、質問の定義、安全な入力の概要、判断、最終アクションを記録してください。ただし、API キーは決して記録しないでください。

インストールとヘルプ

エージェントで通常使用している Skill インストーラーを使って、公開リポジトリからこの Skill をインストールしてください。

npx skills add jev-ai/jev-agent-skill

手動でプロジェクトローカルにインストールする場合は、このファイルを .agents/skills/jev-agent/SKILL.md にコピーしてください。インストール後、エージェントに use the Jev Agent skill と依頼するか、設定／ヘルプのリクエストを実行してください。最初の実際の Jev リクエストを行う前に、上記の初回利用時のオンボーディングを必ず実施してください。

最新の製品情報やアカウント関連の操作については、次を参照してください。

• API ドキュメント：https://thejevai.com/docs
• API キーの管理：https://thejevai.com/settings/apikeys
• プレイグラウンド：https://thejevai.com/playground