- スケジュールタスク:プロジェクトに属する指示です。指定した時刻に Agent がそのプロジェクトのクラウドサーバー上で実行し、実行ごとにセッションが作成されます(または同じセッションで続けます)。Scheduled ボードで作成するか、Agent がセッション内で下書きを作成し、確認後に有効になります。
- セッションタイマー:セッションに紐づくタイマーです。指定した時刻にそのセッションでトリガーメッセージを送信し、Agent が作業を続けます。Agent はセッション内で直接作成でき(確認は不要)、セッションのトップバーにあるタイマーパネルから作成することもできます。繰り返しのセッションタイマーは 7 日後に期限切れとなり、更新できます。
入口
- デスクトップアプリの左側アイコンバーの Scheduled、または Web アプリのサイドバー下部の Scheduled。
- コマンドメニュー(
⇧⌘P、Windows ではCtrl+Shift+P)で Go to · Scheduled tasks を検索します。 - アプリ内通知(スケジュールタスクの完了、失敗、一時停止)をクリックすると、そのスケジュールタスクが開きます。
- セッションタイマーには追加の入口があります:セッションのトップバーにあるタイマーアイコン、またはトップバーの … › Session timers。
ボード
左側の一覧は Upcoming、Paused、Ended のグループに分かれます。各行には次回実行時刻とスケジュールが表示されます。セッションタイマーには、そのセッションと期限も表示されます。行をクリックすると、右側に詳細が開きます。 詳細では次の操作ができます。
詳細には、スケジュール、次回実行、プロジェクト、モデル、通知、作成方法(セッションから作成したタスクはそのセッションへのリンクがあります)、指示、実行履歴も表示されます。
Runs には実行ごとに 1 行が表示され、時刻と結果(実行中、Done、Failed · 理由、Skipped · 理由、Stopped)が示されます。セッションがある記録をクリックすると、その実行のセッションが開きます。
スケジュールタスクを作成する
- ボードで New task をクリックし、Schedule a task を開きます。Plus がない場合は先にサブスクリプションのダイアログが開き、サブスクリプション後に自動的にここへ戻ります。
- テキストボックスに、スケジュールで実行する内容を書きます。
- Project を選択します。デフォルトは最近使用したプロジェクトです。プロジェクトがまだない場合は、先にプロジェクトを作成して公開する必要があります。
- Repeat を選択し、その繰り返しオプションに応じた時刻を入力します(下表を参照)。
- (任意)Advanced を展開して、その他の設定を調整します。
- Create をクリックします。Scheduled · next run X と表示されます。
- Time は 30 分刻みで、現地時間です。
- 指示は最大 16 KiB です。各実行は最長 1 時間で、超えた実行は Timed out として記録されます。
- 1 回限りのタスクは実行後に Ended へ移動します。
詳細設定
スケジュールタスクには権限設定がありません。クラウドのスケジュールタスクは常にフルアクセスで実行されます。
スケジュールタスクを編集する
詳細で鉛筆アイコンをクリックし、Edit scheduled task を開きます。項目は作成時と同じです。タスクを自分の別のプロジェクトに移動できます。セッションから作成したタスクはプロジェクトを変更できません。セッション内で Agent が下書きを作成する
任意のセッションで、自然言語でスケジュールを依頼します。例:「毎週平日の午前 9 時に依存関係の更新を確認する」。Agent がスケジュールタスクの下書きを作成し、セッション内に確認カードが表示されます。確認カードのスケジュールタスクは、Create をクリックするまで実行されません。- Create:すぐに有効になります。カードは Scheduled · next run X に変わり、View in Scheduled が表示されます。
- Edit:Edit scheduled task を開いて変更します。保存後、Create をクリックします。
- Not now:何も作成されません。
セッションタイマー
セッションタイマーはセッションに紐づきます。指定した時刻にそのセッションでトリガーメッセージを送信し、Agent がそのセッションで作業を続けます。「30 分後にデプロイをもう一度確認する」や「1 時間ごとにキューを確認する」など、現在のセッションのコンテキストに関連するタスクに適しています。- Agent が作成:Agent は現在のセッションのタイマーを、確認なしで直接作成、変更、削除できます。変更のたびにタイムラインに 1 行が残ります。
- タイマーパネル:セッションにタイマーがある場合、トップバーのタイトルの横にタイマーアイコンが表示されます。タイマーがない場合は、トップバーの … › Session timers からパネルを開きます。パネルでは、各タイマーで Run now、Turn off / Turn on、Renew、Delete を実行できます。
- New timer:パネルで New timer をクリックし、Prompt と Name (optional) を入力して、In N minutes(最長 7 日)または Repeating (cron)(5 フィールドの cron 式、間隔は 5 分以上)を選択し、Create をクリックします。
- セッションを停止しても終了するのは現在のターンのみです。セッションタイマーは有効なままです。
タイマーが作動したとき
- 指定した時刻に、Timer fired · name というメッセージがセッションに表示され、Agent がターンを開始します。
- セッションがビジーの場合は、タイマーの When busy 設定(Skip this run または Wait in queue)に従います。
- 1 回限りのタイマーは作動後に自動的にオフになります。
期限と更新
- 繰り返しのセッションタイマーは作成後 7 日間有効です。期限切れの 24 時間前以内になると、パネルに Expiring soon と表示され、タイムラインに Renew ボタン付きのリマインダーが表示されます。クリックするとタイマーが 7 日間延長されます。
- 期限切れのタイマーはオフになります。先に更新してからオンにします。
- 更新しても元のオン / オフの状態は維持されます。自分でオフにしたタイマーは更新後もオフのままです。期限切れでオフになったタイマーは、更新後に再びオンになります。
実行ルール
連続失敗後の自動一時停止
3 回連続で実行に失敗すると、スケジュールタスクは自動的に一時停止します。ボードに Paused after failures と表示され、通知が届きます。実行履歴で失敗の理由を確認して修正し、Resume をクリックします。削除
詳細で削除アイコンをクリックし、確認します。スケジュールは実行されなくなり、実行履歴は削除されます。すでに作成されたセッションとセッション内のメッセージは保持されます。注意事項と制限
- スケジュールタスクの最短の固定間隔は 15 分です。繰り返しのセッションタイマーの最小間隔は 5 分です。
- スケジュールタスクのフォームはカスタムの cron 式に対応していません。セッションタイマーは cron を受け付けます。
- 繰り返しのセッションタイマーは 7 日後に期限切れとなり、更新が必要です。
- 各実行はモデルの使用量を消費します(Plus モデル、または選択したサブスクリプション / BYOK)。
- Plus がなくてもボードは閲覧でき、タスクを作成しようとすると先にサブスクリプションに案内されます。Plus がない場合を参照してください。