意思決定モデルのAPIキー

意思決定モデル

CluewrenはTypeSafeがAPIエンドポイント https://api.typesafe.ai で提供する高速な意思決定モデルであるJevを使用します。デフォルトのモデル識別子は jev-1.13.0 です。

Cluewrenのbrainは、プレイエピソード中にリアルタイムに判断を行うため、POST /v1/systemone でJevに問い合わせます。

APIキーの取得

APIキーはTypeSafeコンソールの https://console.typesafe.ai/keys で発行されます。TypeSafeはJevを早期アクセスと説明しています。価格と利用可能なモデルは https://docs.typesafe.ai/models に記載されています。レート制限は組織ごとに適用されます（https://console.typesafe.ai/rate-limits を参照）。

APIキーの設定

意思決定モデルには TYPESAFE_API_KEY という名前のAPIキーが必要です。Cluewrenは以下の2箇所からこのキーを検索します。

1. TYPESAFE_API_KEY 環境変数。
2. %LOCALAPPDATA%\Cluewren\keys.env に記述された以下の設定行:

   TYPESAFE_API_KEY=<your key>

   # で始まる行はコメントとして無視されます。

注意

エージェントとの会話にAPIキーを直接貼り付けないでください。キーが設定されていない状態で start_run が呼び出された場合、keys.env にキーを保存するよう説明するメッセージが返され、チャット上でキーを貼り付けるようユーザーに要求しないようエージェントに指示されます。

キーの読み込み動作

start_run の実行ごとにキーが再読み込みされます。

• %LOCALAPPDATA%\Cluewren\keys.env に追加または変更されたキーは、再起動なしで次回の start_run で有効になります。
• 環境変数はMCPサーバープロセス自身の環境から読み込まれます。エージェントセッション開始後に設定されたものは、エージェントセッションを再起動した後にのみ有効になります。
• キー未設定時のメッセージは、キーを keys.env に配置し、チャットには決して貼り付けないようユーザーに伝えることをエージェントに指示します。

Jevに送信される内容

src/Cluewren.Kit/Jev.cs に基づき、Jevへの各決定リクエストには以下の情報が含まれます。

• モデルID（jev-1.13.0）。
• Jevの意思決定指示を含む choice 質問。
• 現在有効な選択肢の一覧（各選択肢の名前と説明）。
• 以下の状態オブジェクト:
  • ハーネスの目標（goal）。
  • 状況（situation）: ハーネスが観察（observation）で計算する任意の事実情報。
  • 選択肢ごとの事実情報（per-option facts）。
  • 現在実行中の選択肢とその継続時間。
  • 最近実行された選択肢とその効果が成功したかどうか。
  • プランを使用している場合のプランの進行状況。

Jevに送信される事実はハーネスが計算した内容そのものであり、特定のゲームプロパティが前提とされたり必須とされたりすることはありません。

ハーネスを実行する子プロセスはキーを保持しません。Jevへのリクエストは、子プロセスの標準入出力パイプを介してbrainを経由して行われます。