JEV連携
JEV LIVE は、サーバー側のVercel AI Gateway評価エンドポイントを通じて typesafe-ai/jev に接続します。ブラウザはローカルの /api/decide へテレメトリを送り、ゲートウェイキーを受け取りません。
ローカルでJEVを有効にする
.env.exampleを.envにコピーし、ローカルサーバー環境のAI_GATEWAY_API_KEYを設定します。npm run devを実行してhttp://127.0.0.1:4173/を開き、JEV LIVEを選びます。PILOT INTELLIGENCEがJEV LIVEを示し、JEV responsesの件数が増えることを確認します。ヘッダーの準備完了表示はキーの設定だけを示し、ライブ応答の成功を証明するものではありません。
キーはサーバー側に留まります。公開静的デモではこの設定を実行せず、ライブ要求にはローカルNodeサーバーを使います。
評価するもの
各リクエストには、機体、最近傍の生存目標、武器、脅威、ミッション状態、進行状況の範囲付きテレメトリが入ります。JEVは次を返します。
- 6種類の機動: pursue、climb、descend、左右break、extend
- 射撃、フレア、アフターバーナーの真偽
- 1〜10の脅威度と機動確率
リクエストの流れ
ブラウザは判断リクエスト中も物理を動かします。同時に1件だけ送り、次のリクエストまで最低600ms待ち、source: "jev" の現行判断だけを受理します。受理済み判断が3秒より古くなるとローカル操縦へ戻り、テレメトリから4秒を超えて遅れた応答は破棄します。
サーバーはテレメトリ、本文サイズ、クライアントレート、上流タイムアウトを検証し、安全なエラーを返します。上流HTTP 429は upstream_rate_limited として扱い、ローカルAPI制限のHTTP 429とは分けています。
ローカル補助と上限
起動直後、初回応答待ち、通信失敗、判断の古さがある場合は localDecision が機体を操縦します。3回連続で失敗するとローカルモードへ移行します。1出撃のJEV呼び出しは最大120回、同時リクエストは1件です。
静的PagesデモではNodeゲートウェイを動かせず、秘密値も安全に保持できません。静的デモは手動とローカルAI用、JEVはローカルサーバー用です。
JEVモードでしないこと
ブラウザを認証情報の保管場所にしたり、シミュレーション時計を置き換えたりしません。受理したJEV回答も、ローカル操縦と同じ範囲付き飛行コントローラーへの入力です。