Skip to main content
学習が進むにつれて Arkor は 5 つのコールバックを発火します。すべてオプションで、いずれもあなたのプロセス内で動く普通の TypeScript 関数です。これがアプリケーション本体と同じ感触のループにする鍵です。ノートブックも、外部のダッシュボードも、別の設定言語もいりません。

それぞれのコールバックがいつ発火するか

5 つすべてのコールバックは wait() 内からディスパッチされます。start() を呼んで wait() を呼ばないと、学習はバックエンドで進行していてもコールバックは 一切発火しませんarkor start はあなたの代わりに wait() を呼びます。CLI の外側で学習を自分のコードに組み込む場合は、自分でも呼ぶようにしてください。 onCompletedonFailed は排他で、学習 1 回あたり最大 1 つしか発火しません。終端イベント到達前に wait() が throw した場合(例えば abortSignal が Abort された、再接続試行が尽きた)、どちらも発火しないことがあります。 どのコールバックも Promise を返して構いません。Arkor は次に進む前に await するので、非同期処理(DB への書き込み、Slack への投稿、infer の呼び出し)を競合なくこなせます。

onStarted({ job })

wait() が開いた SSE ストリームが training.started イベントを報告したときに 1 回発火します。これは start() の resolve のタイミングと同じではありません。start() はジョブを投入して jobId を返すだけです。
ログ行、メトリックスカウンター、「学習開始しました」の通知に使ってください。

onLog({ step, loss, evalLoss, learningRate, epoch, samplesPerSecond, job })

学習が進むにつれて繰り返し発火します。各数値フィールドはバックエンドがまだそのメトリックスを出していなければ null になり得ます(例えば evalLoss は eval ステップのときだけ)。
よくある用途:
  • 自前のメトリックスパイプライン(PostHog、Datadog など)に転送。
  • 早期発散の検知: loss が増えていれば、abortSignalwait() を Abort し、trainer.cancel() でバックエンドの GPU を止める。
  • カスタム Early Stopping(指標が悪化したら学習を自動で打ち切るパターン。詳しくは Early Stopping レシピ を参照)を実装。

onCheckpoint({ step, adapter, job, infer, artifacts })

学習中にバックエンドでチェックポイントが保存されたタイミングで発火します。
adapter はチェックポイントを識別する小さなオブジェクト({ kind: "checkpoint", jobId, step })。infer は関数で、チャット形式のリクエストを取り、生の Response を返します。await res.text()(または res.json()、ストリーム処理)で読み取ります。 実用上もっとも価値のあるコールバックです。学習の最後まで待たずに、途中でモデルを動作確認できます。チェックポイントが既にベースモデルより悪ければ、止めるべきだとわかります。

onCompleted({ job, artifacts })

成功時に 1 回発火します。artifacts はこの学習でバックエンドが生み出したものを並べたリストです。用途:
  • 最終アダプタ ID をアプリの他の部分から見つけられる場所に保存。
  • モデルを昇格させる前に最終スモークテスト。
  • 「学習完了」通知の送信。

onFailed({ job, error })

バックエンドが失敗を報告した場合に 1 回発火します。errorstring(バックエンドが送ってきたメッセージ)であって Error インスタンスではないことに注意:
onFailed はバックエンド報告の失敗専用です。あなたのコールバック内で throw した例外は onFailed を経由しませんし、wait() をクリーンに失敗させる保証もありません。現行のランタイムはイベントディスパッチ中に throw されたエラーを catch し、SSE 失敗として扱って再接続ループに送ります。元の例外は予想外の場所でリトライされたりスキップされたりすることがあります。決定的な振る舞いが必要なら、コールバック内で catch して、エスケープする前に何をするか(ログ、Abort、永続化)を決めてください。

完成例

コールバックを理解してしまえば、Arkor のほとんどはその上に乗る設定にすぎません。