NodaroAccount
Nodaro ドキュメント
ドキュメントノードリファレンスモデルテンプレートAI エージェント(MCP)開発者向けセルフホスティングリサーチ比較
自動化

スケジュールトリガー

数分、数時間、数日、数週間、数か月ごと、または cron 式で、選んだタイムゾーンに合わせてワークフローを自動で実行します。スイッチ 1 つでオンにできます。

スケジュールトリガーノードは、スケジュールに従ってワークフローを自動で実行します。たとえば、20 分ごと、毎日 9:00、平日の 18:30 などです。スケジュールは、選んだタイムゾーンで解釈されるルールのリストで、いずれかのルールが一致するたびにワークフローが実行されます。トリガーは無料で、スイッチがオンの間だけ実行されます。

使いどころ

  • 毎日の画像、ニュースの要約、名言の動画など、生成したコンテンツを毎日公開します。
  • Web スクレイピングや Telegram チャンネルフィードで、ソースを定期的に確認します。
  • エディターを開かずに、週次や月次のレポートを作ります。
  • Webhook トリガーと組み合わせて、同じワークフローを、スケジュールでも必要なときにも実行します。

クイックスタート

ノードを追加する

キャンバス上で Tab を押し、自動化 › トリガー › スケジュールトリガーを選びます。新しいスケジュールトリガーは、毎日 9:00(UTC)に実行する設定になっており、一時停止の状態で始まります。

スケジュールを設定する

設定パネルを開きます。平日 9:00 などのプリセットをクリックするか、トリガールールでルールを編集します。タイムゾーンを選びます。実行タイミングには、保存する前に、次の実行予定が表示されます。

実行する範囲を決める

ワークフローの一部だけを実行するには、その部分の最初のノードにトリガーを接続します。どこにも接続していないトリガーは、ワークフロー全体を実行します。

オンにする

設定パネルの上部にあるスイッチをオンにするか、エディター上部のバーにあるスケジュールボタンをクリックします。ノードに有効と表示され、次に一致する時刻(分)からスケジュールが実行されます。

プロンプトスケジュールトリガー平日 9:00Web スクレイピングGoogle Searchテキスト生成 - あらゆる LLM短い投稿を書くSNS に公開
スケジュールトリガーはどこにも接続されていないため、平日 9:00 の実行は、毎回ワークフロー全体が対象になります。検索し、書き、公開します。
スケジュールが一時停止中のスケジュールトリガーの設定パネル。プリセット、その日の実行を示す 24 時間のバー、「トリガールールを追加」ボタン、タイムゾーンが表示されています。スケジュールが一時停止中のスケジュールトリガーの設定パネル。プリセット、その日の実行を示す 24 時間のバー、「トリガールールを追加」ボタン、タイムゾーンが表示されています。

スケジュールをオンにする

スケジュールは、スイッチがオンの間だけ実行されます。ノードを配置してワークフローを保存すると、スケジュールは登録されますが、開始はされません。オンにするまで、ノードには一時停止中と表示されます。

  • 設定パネルでは、上部のスイッチを使います。スイッチには、スケジュールはオンですまたはスケジュールは一時停止中ですと表示されます。
  • エディター上部のバーでは、ワークフローにスケジュールトリガーがあると、スケジュールボタンが表示されます。ボタンには、スケジュール:オン、スケジュール:オフ、または 1/2 件のスケジュールがオンのように表示されます。クリックすると、ワークフローのすべてのスケジュールをオンにします。すべてがすでにオンの場合はオフにします。どちらの場合も、ワークフローが保存されます。

スイッチをオフにすると、同じようにスケジュールが一時停止します。インポートしたワークフローやテンプレートでは、スケジュールは必ず一時停止の状態で始まります。API、SDK、MCP で書き込んだスケジュールは、ノードの active フィールドが true の場合にだけオンになります。

スケジュールをオンにせずに、今すぐ分岐を試すには、設定パネルの下部にあるここから実行をクリックします。どこにも接続していないトリガーには、実行を始める分岐がありません。その場合は、代わりにワークフロー全体を実行してください。

設定

設定説明
プリセット5 分ごと、毎時、毎日 9:00、平日 9:00 があります。クリックすると、対応するルールが書き込まれます。スケジュールがプリセットのルールと完全に一致するときは、そのプリセットが強調表示されます。
トリガールール1 つ以上のルールです。いずれかのルールが一致するたびに、ワークフローが実行されます。トリガールールを追加でルールを追加し、ルールを削除でルールを削除します。最後の 1 つのルールは削除できません。
タイムゾーンルールの時刻を、どのタイムゾーンの時刻として扱うかを決めます。すべてのタイムゾーンのリストから検索でき、自分のタイムゾーンが最初に表示されます。設定していない場合、ルールは UTC を使います。
最大実行回数この回数だけ実行すると、スケジュールが止まります。空欄にすると、回数は無制限になります。
失敗時の再試行失敗したスケジュール実行を、後でもう一度実行します。デフォルトはオフです。失敗時の再試行を参照してください。

ルール

各ルールには、トリガーの間隔と、それに対応するフィールドがあります。

トリガーの間隔フィールド実行されるタイミング
分1〜59 分ごと毎時、0 分、N 分、2N 分…の時点
時間1〜23 時間ごと、実行する時刻(分)毎日 0 時、N 時、2N 時…の、指定した分
日1〜31 日ごと、実行する時刻(時)、実行する時刻(分)暦日で N 日ごとの、指定した時刻
週1〜52 週ごと、実行する曜日、時、分N 週ごとの、指定した曜日。週は月曜日に始まります。
月1〜12 か月ごと、1〜31 の実行する日、時、分N か月ごとの、指定した日。月の日数が足りない場合は、その月の最終日
カスタム(cron)5 フィールドの cron 式式に一致するたび
  • 起点は固定:「N 日、N 週、N か月ごと」は、暦の固定された時点から数えます。ワークフローを保存し直しても、実行される日がずれることはありません。
  • cron の形式:フィールドは、分、時、日、月、曜日の順です。日と曜日の組み合わせも含め、すべてのフィールドが一致する必要があります。一部の cron ツールでは、日と曜日はどちらか一方が一致すれば実行されます。0 と 7 は、どちらも日曜日を表します。

実行タイミング

保存する前に、設定パネルの実行タイミングに、ルールの意味が表示されます。

  • スケジュールの説明文と、1 日あたりの実行回数。
  • 今日の実行を示す 24 時間のバー。
  • 次の 3 回の実行と、それぞれまでの残り時間。

ノードには、同じ概要、次の実行、スケジュールが有効か一時停止中かが表示されます。プレビューはサーバーと同じ計算を使うので、実際に起きることがそのまま表示されます。

スケジュールによる実行の仕組み

  • 1 分に 1 回:Nodaro はすべてのスケジュールを 1 分ごとに確認し、ルールがその分に一致すると実行を開始します。再起動の後や時刻が巻き戻ったときでも、同じ分が 2 回実行されることはありません。時刻の切り替えで飛ばされた分は、その日はスキップされます。
  • 一度に 1 つの実行:ワークフローの前回の実行がまだ続いている場合、その分の実行はスキップされます。
  • 開始されなかった実行:実行が作成されたのに開始されないことがあります。たとえば、その瞬間にサーバーが再起動した場合や、実行をキューに入れられなかった場合です。このような実行が、スケジュールを止めることはありません。キューに拒否された実行は、すぐに失敗として記録されます。キューに届かなかった実行は、作成から 4 時間たつと失敗として記録されます。空いた実行枠を待っていた時間は、この 4 時間に含まれません。キューで順番を待っている実行は、そのまま開始を待ちます。2 つの環境が 1 つのデータベースを共有している場合、別の環境が作成して開始されなかった実行も、作成から 8 時間たつと、RUNTIME_ENV が production の環境によって失敗として記録されます。そのため、停止した環境がスケジュールを止めることもありません。どちらの場合も、スケジュールは次に一致する時刻にまた実行されます。失敗時の再試行がオンの場合、失敗した実行はほかの実行と同じように再試行されます。ただし、2 日より前に作成された実行は除きます。
  • セルフホスティングのサーバーでは、サーバーを更新する前にこのように止まった実行が、保留のまま残ることがあります。ワークフローの実行履歴から、または POST /v1/workflow-executions/:id/cancel でキャンセルしてください。スケジュールは次に一致する時刻にまた実行されます。
  • 最大実行回数:その回数だけ実行すると、スケジュールは止まります。スケジュールは登録されたままなので、続けるには上限を引き上げるか、空欄にしてください。
  • 再試行:失敗時の再試行がオンの場合、同じ毎分のチェックで、待ち時間が過ぎた再試行も開始します。失敗した実行が、同じ試行で 2 回再試行されることはありません。サーバーが 2 台あっても同じです。
  • 出力:出力のペイロードが、実行の時刻を渡します。

失敗時の再試行

スケジュールによる実行は、誰も見ていません。モデルのサービスが一時的に停止しているなど、時間がたてば解消する失敗でも、そのままだと次のスケジュールの時刻まで、その実行は失われます。失敗時の再試行がオンの場合、失敗したスケジュール実行は後でもう一度実行されます。時間がかかりすぎてサーバーが停止した実行も、失敗として数えます。あなたがキャンセルした実行は、再試行されません。

設定説明
再試行までの時間(分)失敗から再試行を開始できるまでの時間で、5〜1,440 分です。デフォルトは 30 です。
最大試行回数1 回の失敗した実行が受けられる再試行の回数で、1〜5 回です。デフォルトは 3 です。元の実行は試行に含まれません。
低コストのレーンのみデフォルトはオンです。スケジュール実行のモデル呼び出しは、最初の経路が失敗したときに、モデルの開発元の直接のサービスに切り替わりません。呼び出しは失敗し、再試行が後でもう一度実行します。
  • 同じ実行をもう一度:再試行は、スケジュールと同じブランチを、同じ前回の実行時刻で実行します。そのため、{{trigger.last_triggered_at}} は、失敗した実行が読んだのと同じ値を読みます。実行履歴では、スケジュールバッジの横に再試行 1 / 3 バッジが表示されます。
  • 成功するまで:失敗した再試行は、最大試行回数まで再び再試行されます。成功した再試行で、一連の再試行は終わります。
  • 最新の実行のみ:スケジュールがもう一度実行された後は、それより古い失敗は再試行されません。2 日より古い失敗も再試行されません。
  • 一度に 1 つの実行:再試行は、同じワークフローのあなたの別の実行が続いている間は待機します。
  • 最大実行回数:再試行は、最大実行回数に数えられません。
  • いつでもオフにできます:再試行の設定は、現在のノードから読み取られます。失敗時の再試行をオフにして保存すると、一連の再試行はすぐに止まります。
  • 再試行ごとに課金されます:失敗した実行のクレジットは、失敗したときに返還されています。再試行のたびに、ほかの実行と同じように、ブランチの料金がもう一度確保されて課金されます。3 回失敗してから成功した実行では、各試行で完了したノードの料金と、成功した実行の料金を支払います。

低コストのレーンのみは、テキスト生成 - あらゆる LLM、画像の説明、脚本生成、Lottie エンジンのモーショングラフィックスのモデル呼び出しに適用されます。課金される額は変わりません。詳細モードや、推論の強度を指定した Claude モデルなど、自身の設定のためにモデルの開発元で直接実行する必要がある呼び出しは、これまでどおり直接実行されます。ほかのノードタイプのモデル呼び出しは、通常の切り替えを維持します。

スケジュールによる実行で動く範囲

ほかのノードに接続したトリガーは、その分岐だけを実行します。つまり、トリガーより後のノードと、それらが入力として必要とするすべてのノードです。分岐の外にあるノードは実行されず、そのまま残ります。どこにも接続していないトリガーは、ワークフロー全体を実行します。そのため、1 つのワークフローに複数のトリガーを置き、それぞれに自分の分岐を開始させることができます。

ノードが接続されているとみなされるのは、線で結んだ接続があるとき、トリガーが入力を渡すグループの中にあるとき、またはフィールドのマッピングで結ばれているときです。設定パネルには、どちらに当てはまるかが「接続済み:このトリガー以降の分岐のみが実行されます。」または「未接続:ワークフロー全体が実行されます。」と表示されます。トリガーが制限するのは、そのトリガーが開始した実行だけです。エディターからの手動実行、API からの実行、公開したアプリの実行が、トリガーの分岐に限定されることはありません。

トラブルシューティング

  • ノードに「一時停止中」と表示される:スイッチがオフです。設定パネルか、上部のバーにあるスケジュールボタンでオンにしてください。
  • ノードに「実行不可」と表示される:ルールが実行できない状態です。たとえば、式のない cron ルールや、曜日のない週単位のルールです。または、サーバーが認識できないタイムゾーンが設定されています。問題を修正して、もう一度保存してください。
  • 実行される時刻がずれる:タイムゾーンを確認してください。空欄の場合、ルールは UTC を使います。
  • 実行がスキップされた:その時点で、ワークフローの前回の実行がまだ続いていました。
  • 以前のスケジュールが実行されなくなった:ルールの仕組みができる前に保存されたスケジュールは、スケジュールがルールに書き換えられた状態で開き、一時停止の状態で始まります。オンにしてください。実行は時計の区切りに合わせて行われるようになったため、「5 分ごと」は :00、:05、:10…の時点を意味します。

API から

GET /v1/workflows/<id>/triggers は、ワークフローのトリガーを一覧表示します。スケジュールの設定はノードと同じルールを使い、kind、every、hour、minute、weekdays(0 が日曜日、6 が土曜日)、dayOfMonth、cron に加えて、省略可能な timezone、maxExecutions、retry ポリシー({ afterMinutes, maxAttempts, cheapLanesOnly }。それぞれ省略可能で、デフォルトは上記のとおり)を持ちます。PATCH では、"retry": null で再試行をオフにします。GET /v1/workflows/<id>/executions は、再試行を retry: { attempt, maxAttempts, retryOf } 付きで一覧表示します。スケジュールを一時停止するには、ノードのスイッチを使ってください。PATCH /v1/workflow-triggers/<id> で送った一時停止は、次にワークフローを保存するまでしか続きません。API から直接作成したスケジュールはどのノードにも属さず、ワークフローにスケジュールトリガーが 2 つある場合、そのようなスケジュールはワークフロー全体を実行します。Webhook を参照してください。

よくある質問

Nodaro のワークフローを毎日実行するには、どうすればよいですか?

スケジュールトリガーを追加し、「毎日 9:00」プリセットをクリックするか、自分でルールを設定します。タイムゾーンを選び、設定パネルの上部にあるスイッチでスケジュールをオンにします。これで、ワークフローが毎日その時刻に実行されます。

スケジュールが実行されないのはなぜですか?

スケジュールは、スイッチがオンの間だけ実行されます。新しく追加したスケジュールトリガーや、インポートしたスケジュールトリガーは一時停止の状態で始まり、ノードには「一時停止中」と表示されます。設定パネルか、エディター上部のバーにあるスケジュールボタンでオンにしてください。ノードに「実行不可」と表示されている場合は、ルールかタイムゾーンを修正する必要があります。

スケジュールトリガーは、どのタイムゾーンを使いますか?

設定パネルで選んだタイムゾーンです。選択肢では、自分のタイムゾーンが最初に表示されます。タイムゾーンを設定していない場合、ルールは UTC として解釈されます。

スケジュールトリガーにクレジットはかかりますか?

いいえ。トリガー自体は無料です。各実行では、実行したノードの分の料金がかかります。短い間隔を選ぶ前に、1 回の実行にかかる料金を確認してください。

スケジュールの時刻を待たずに、テストできますか?

はい。設定パネルの下部にある「ここから実行」をクリックすると、トリガーの後ろの分岐をすぐに実行できます。トリガーがどこにも接続されていない場合は、代わりにワークフロー全体を実行してください。

1 つのワークフローに、複数のスケジュールを設定できますか?

はい。1 つのスケジュールトリガーに複数のルールを設定でき、いずれかのルールが一致するたびにワークフローが実行されます。また、1 つのワークフローに複数のトリガーを置き、それぞれを別の分岐に接続することもできます。

最終更新

目次