For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/modules/schedules.md (or send Accept: text/markdown).

スケジュールタスク

スケジュールアクションによるワークスペースの定期処理。

このガイドについて質問

初心者向けのウォークスルー

前提条件: 以下の 2 つの初心者向けガイドを読み、Web ローカルのセットアップを完了し、エディターでルートにあるこのモノリポジトリを開きます。 Web 設定は apps/web/.env.local に属します。 Next.js はルート .env を読み取りません。デフォルトのフェイクモードの /dashboard はデータベースなしのデモです。 /auth には移行されたデータベースが必要です。

簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダーキーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデルカタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。

1. Settings → Developers を開き、スケジュールコントロールを使用して、UTC ランタイムでテストジョブを作成します。

2. アプリを実行し続け、同じサーバー専用の SCHEDULER_TICK_SECRET をアプリと端末で利用できるようにします。リポジトリのルートから以下のコマンドを実行します。

3. 期限が進み、ジョブが独自のステータスに達することを確認します。何も実行されない場合は、UTC 時間、スケジューラプロバイダー、およびサーバーログを確認してください。秘密をチャットに貼り付けないでください。

カスタムコードの場合は、提供された prompts/README.md から始めて、最も近いプロンプト (アプリ画面の場合は prompts/new-app-screen.md、パブリックページの場合は prompts/new-landing-page.md) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディングエージェントにこのガイドのタスクを与え、AGENTS.md、.ai/PROJECT_CONTEXT.md、および一致する .ai/ ミラーを読み取るように依頼します。ここで指定されている正確なソースファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テストアカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

始める前に

【端末の基本】(/docs/web/terminal-basics)

corepack pnpm jobs:tick

定期的な作業をデータベースに保存する

設定スケジュールでは、ジョブタイプと cron ルールがワークスペーススコープの job_schedule 行に保存されます。 Cron フィールドは UTC で評価されます。 createDrizzleJobScheduler.claimDueSchedules は、FOR UPDATE SKIP LOCKED を使用して期限切れの行を要求し、次の実行を進めてから、ハンドラーをディスパッチします。

汎用の JobRunner は、エンキュー/ステータス/キャンセルを約束します。繰り返しはスケジューラ行に属します。 Trigger.dev ワークフローセマンティクスは明示的なままです。

ドライブスケジューラのティック

サーバー専用の SCHEDULER_TICK_SECRET を設定して、POST /api/internal/scheduler-tick を有効にします。 corepack pnpm jobs:tick は、dev/CI に対してそれを呼び出します。構成が存在しない場合は 404 が返されます。JOB_PROVIDER=trigger では、デプロイされた scheduler.tick cron がスケジューラを駆動します。

# Against a running local app, with SCHEDULER_TICK_SECRET configured:
corepack pnpm jobs:tick

請求と実行を個別に検証する

重複するティック、期限/期限外ルール、無効な行、ハンドラーの失敗、キャンセル、別のワークスペースのスケジュールをテストします。請求/前払いとジョブの完了を個別に検査します。主張された行は完了した作業の証拠ではありません。

インストールとセットアップ

定期処理——ダイジェスト、クリーンアップ、更新——はアドホックなタイマーではなく schedule-actions を通ります：listWorkspaceSchedules、upsertScheduleAction、removeScheduleAction がワークスペースの cron 駆動タスクを管理します。

スケジュールはタスク、cron 式、実行されるワークスペースを名指します。ワーカーは実行時にコンテキストを解決するため、一時停止または削除されたスケジュールは再デプロイなしに処理を止めます。

listWorkspaceSchedules()
upsertScheduleAction({ task, cron })
removeScheduleAction(formData)

実装ワークフロー

すべての定期実行を信頼できない入力として扱います：登録時から状態が変わっている可能性があるため、実行内でワークスペースとエンタイトルメントを再解決します。タスクを冪等にしてください——再試行や二重発火が効果を重複させてはいけません。

スケジュールは運用面です：設定やログで見えるように保ち、スタックしたり暴走したスケジュールをユーザーが気づく前に見つけられるようにします。

検証とトラブルシューティング

サンドボックスでスケジュールを手動発火し、一時停止し、無効化されたワークスペースが実行を止めること、二重発火が1つの効果しか生まないことを確認します。cron 式はタスクコードに散らさず、管理された設定に置いてください。