LiveKit Job

Definition

LiveKit Job は、Worker にディスパッチされる個別の実行要求であり、ある Room や参加状況に紐づいて Agent logic を起動する単位である。

Why It Matters

Worker と Job を混同すると、長寿命の実行基盤と、都度発生する処理要求の区別が崩れる。スケーリング、dispatch、障害切り分けを理解するには Job の粒度が重要になる。

Current Understanding

Job は LiveKit の dispatch によって Worker へ割り当てられ、その Job の文脈で Agent が部屋に参加し、対話や処理を開始する。Job は 1 回のセッション開始要求に近く、永続的なホストではない。

Job Lifecycle を見ると、Job は生成、割り当て、実行、終了という流れを持ち、Worker 側はそれを受ける立場にある。したがって Job は「走る処理の単位」、Worker は「受け皿」である。

Connections

New Insights

  • Job は Room 参加や Agent 起動の直接トリガーになる実行要求として見ると理解しやすい
  • dispatch の理解は Job を中心に置くと整理できる

Open Questions

  • Front-desk sample では Job と entrypoint がコード上でどう接続されるか
  • Job failure 時の retry / cleanup はどこまで framework が面倒を見るか