Documentation Index
Fetch the complete documentation index at: https://arkor-92aeef0e-eng-736.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Playground
Playground(#/playground)はモデルを動作確認するための小さなチャット UI です。ラジオボタンで切り替える 2 モード:
- ベースモデル。 クラウド API が
/v1/inference/chatで受け付けるベースモデルとチャット。現在サポートされる値は 1 つ:gemma-4-E4B-it(サポートしているモデル を参照)。 - アダプター。 完了済みジョブの 最終 アダプター(
{ kind: "final", jobId })とチャット。中間チェックポイントはここから選べません。
/api/jobs を 1 度取得し、レスポンスを status === "completed" でフィルターします。アダプターのドロップダウンはバックエンドが返した順でそれらのジョブを並べます。自動リフレッシュはなく、モードを切り替えても再取得は行われません。新しい学習が終わったらドロップダウンに反映するため、ページをリロードする(あるいは #/playground から離れて戻り、再マウントする)必要があります。
メッセージの送信
チャット UI はあえて最小限です。{ role, content } メッセージのリスト、入力欄、Send ボタン。会話履歴はページローカルで、リロードでクリアされます。
送信すると Studio は POST /api/inference/chat を次のように呼びます:
このページがしないこと
- 中間チェックポイント。 ドロップダウンは完了済みジョブのみリストし
kind: "final"だけ送ります。学習中に推論したいなら SDK のonCheckpoint({ infer })を使ってください。与えられるinferは直前に到達したチェックポイントに紐づいています。 temperature/topP/maxTokens。 HTTP の形(InferArgs)はこれらを受け付けますが、Playground は入力欄を提供しません。Studio はmessagesとモード固有のフィールドだけを送ります。これらのノブを試したい場合は SDK のinferを直接呼んでください。- System プロンプト。 入力欄は
userロールのみ追加します。system用のフィールドはありません。System プロンプトを試すならsrc/arkor/trainer.tsを編集する(あるいはプログラムからinferを呼ぶ)。 - 会話のエクスポート/共有。 ページをリロードすると履歴は消えます。残したいなら手動でコピーしてください。
- 認証情報を意識したリストフィルター。 アダプターのドロップダウンは現在の認証情報で
/api/jobsが返すものをそのまま表示します。著者など他次元でフィルターしません。
Playground を使う場面
- 固定プロンプトでベース vs アダプターの素早い前後比較。
- アプリケーションに組み込む前に、ファインチューンが意味のある効果を発揮したかの最初の動作確認。
- 同じ環境でチームメンバーに完成した学習をデモする。